Creación de una gema con el configurador de proyectos de - Guía del usuario de Lumberyard

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de una gema con el configurador de proyectos de

Utilice Project Configurator para crear una gema nueva vacía.

  1. Abra Lumberyard Project Configurator, ubicado enlumberyard-version\dev\Bin64BuildPlatform\ProjectConfigurator.exe. Por ejemplo, cuando se usa Visual Studio 2017 como plataforma de compilación, el configurador de proyectos se encuentra enlumberyard-version\dev\Bin64vc141\ProjectConfigurator.exe.

  2. Seleccione el proyecto y haga clic en Enable Gems (Habilitar gemas).

  3. Haga clic en Create a new Gem (Crear una gema nueva) en la página de gemas del proyecto de juego que ha seleccionado.

  4. En el cuadro de diálogo Create a new Gem (Crear una gema nueva):

    1. En Name (Nombre), escriba un nombre para la gema (por ejemplo, MyNewGem). El nombre debe empezar por una letra y solo se permiten caracteres alfanuméricos y guiones bajos en el resto del nombre. No está permitido utilizar otros caracteres especiales o espacios en el nombre.

    2. (Opcional) En Summary (Resumen), escriba una descripción para la gema.

      Este campo también admite hipervínculos mediante una sencilla etiqueta delimitadora html. Al ingresar esto directamente en elResumenEn el configurador de proyectos de, utilice la sintaxis siguiente:

      <a href="http://www.amazon.com">Amazon</a>

      Si va a editar el parámetro Summary en el archivo gem.json, utilice la siguiente sintaxis:

      "Summary": "<a href=\"http:\/\/www.amazon.com\">Amazon<\/a>",
    3. Para Type (Tipo), seleccione Code & Assets (Código y recursos) o Assets Only (Solo recursos).

      • Código y recursos: contiene activos y código que realizan determinadas funciones en los recursos.

      • Sólo activos: contiene solo activos y no contiene código.

    4. Elija Create Gem (Crear gema).

    
                            Cree sus propias gemas para utilizarlas en su proyecto de juego en Lumberyard.
  5. Cierre Project Configurator.

    Los directorios y archivos siguientes se crean en \dev\Gems\gem_name\ para las gemas "Assets Only" y "Code & Assets":

    • Assets: directorio de activos de la gema (por ejemplo, materiales, modelos, texturas y archivos de audio). El sistema AZ::IO incluye automáticamente este directorio para que pueda hacer referencia a los recursos que proporciona la gema. Por ejemplo, si tiene un archivo de material, \Assets\materials\MyMaterial.mtl, puede hacer referencia a él en el código con la ruta materials\MyMaterial.mtl.

      nota

      Si este directorio no existe, puede agregarlo manualmente. Si no tiene recursos en la gema, puede eliminar esta carpeta.

    • Gem.json: metadatos de esta gema. No modifique los campos Uuid ni Name. Puede especificar los siguientes campos de metadatos de gemas:

      • Versionn.n.n(solo valores numéricos).

        No se admite la revisión de gemas, por lo que no debería planificar el incremento de la revisión tras el envío de la gema.

      • DisplayName: nombre de visualización sencillo. Puede contener espacios.

      • Tags: etiquetas que se pueden buscar que aparecen en Project Configurator bajo el resumen de la gema. Introdúzcalas como una lista de cadenas separadas por comas.

      • IconPath: ruta al icono de visualización de la gema.

      • Summary: descripción detallada de la gema. Este parámetro es compatible con hipervínculos. Para especificar un hipervínculo, utilice la siguiente sintaxis:

        "Summary": "<a href=\"http:\/\/www.amazon.com\">Amazon<\/a>",
      • Dependencies: permite especificar la dependencia de otra gema o de una versión del motor. Edite los metadatos de _comment.

        "Dependencies": [ { "Uuid": "540faf970c994668b5d02c66a39c6625", "VersionConstraints": [ ">1" ], "_comment": "zzzTestVer001" } ],
    • preview.png— Vista previa de la imagen mostrada en elProject Configuratorlista de gemas.

    Para las gemas "Code & Assets" también se pueden crear los siguientes archivos y directorios (además de los archivos anteriores):

    • Code\gem_name.waf_files: archivos waf (json) de la gema que especifican qué archivos se incluyen, cómo se deben combinar los archivos en archivos Uber y cómo se filtran los archivos en el proyecto de Visual Studio.

    • Code\gem_name_test.waf_files: archivos adicionales que se deben incluir cuando se realice la compilación con la especificación de prueba.

    • Code\wscript: archivo waf (wscript) de Python que define bibliotecas y otra configuración de la compilación que utiliza la gema.

    • Code\Include\gem_name\gem_name_Bus.h: encabezado visible globalmente que puede incluir cualquier proyecto que utilice la gema u otras gemas que dependan de él. El código externo puede llamar al módulo de la gema y recibir eventos desde su módulo a través de buses de eventos públicos. Los buses de eventos permiten realizar llamadas de función sencillas y seguras entre diferentes módulos de código.

    • Code\Source\gem_nameModule.cpp— Implementación de lagem_nameModule. A partir de Lumberyard 1.5, se incluyen gemas nuevas en los módulos AZ. El módulo predeterminado registra un componente del sistema: el gem_nameSystemComponent.

    • Code\Source\gem_nameSystemComponent.h— Encabezado para elgem_nameSystemComponentLa implementación de. Este componente lo registra gem_nameModule y es un controlador de gem_nameBus.

    • Code\Source\gem_nameSystemComponent.cppgem_nameSystemComponentLa implementación de. Dentro de este componente, se encuentran los métodos Activate, Deactivate, Init y Reflect típicos.

    • Code\Source\StdAfx.cppCode\Source\StdAfx.h

    • Code\Tests\gem_nameTest.cpp

  6. Compile el proyecto de juego:

    • Si la gema es de tipo Código y activos, tendrá que compilar el proyecto.

    • Si la gema es de tipo Assets Only (Solo recursos), no es necesario compilar el proyecto.