Lumberyard
Guía del usuario (Version 1.21)

Compatibilidad con Android

Puede utilizar Lumberyard para crear sus juegos para dispositivos Android, como Samsung Galaxy Note 4, LG Nexus 5 y Kindle Fire HDX. Para obtener más información, consulte Creación de juegos Android e iOS. Lumberyard incluye dos proyectos de ejemplo compatibles con Android que puede utilizar para aprender a crear recursos para Android, crear sombreadores con el compilador de sombreadores remoto y compilar el tiempo de ejecución de Lumberyard con las herramientas de compilación.

Requisitos previos

Para crear juegos para Android, Lumberyard se necesita lo siguiente:

  • Visual Studio 2015 con la actualización 1 o posterior para la depuración (PC solamente).

  • SDK-19 (Android 4.4.2) a SDK-23 (Android 6.0).

  • Su dispositivo configurado para el desarrollo y conectado a su equipo a través de un cable USB.

Para obtener más información acerca de la creación de proyectos de Android en Amazon Lumberyard, vea el siguiente tutorial de vídeo.

Configuración del PC

Después de descargar y extraer Lumberyard en su equipo, debe extraer y ejecutar Lumberyard Setup Assistant para instalar el software de terceros necesario para ejecutar el juego y compilar su código, el motor y la canalización de recursos y para dispositivos Android.

Para instalar software de terceros mediante Lumberyard Setup Assistant

  1. Ejecute Lumberyard Setup Assistant haciendo doble clic en SetupAssistant.bat, que se encuentra en el directorio raíz de Lumberyard (lumberyard_version\dev).

  2. En Lumberyard Setup Assistant, en la página Get started (Empezar), seleccione Compile for Android devices (Compilar para dispositivos Android) y haga clic en Next (Siguiente).

  3. Siga las instrucciones que aparecen en pantalla para completar la instalación de cualquier software de terceros o los SDK que necesita. Para obtener más información acerca del uso de Lumberyard Setup Assistant, consulte Uso de Lumberyard Setup Assistant para configurar su entorno de desarrollo.

  4. Modifique las variables de entorno haciendo lo siguiente:

    1. En el Panel de control de Windows, haga clic en Sistema y, a continuación, en Configuración avanzada del sistema.

    2. En el cuadro de diálogo Propiedades del sistema, haga clic en Variables de entorno.

    3. En Variables de usuario, edite la variable PATH para añadir el directorio donde instaló el SDK de Android, las herramientas del SO y los subdirectorios de las herramientas. Por ejemplo: C:\Android\android-sdk, C:\Android\android-sdk\platform-tools, C:\Android\android-sdk\tools

    4. Añada el SDK para Java y JRE a la variable PATH. Por ejemplo: C:\Program Files\Java\jdk1.7.0_79\bin and C:\Program Files\Java\jre7\bin

  5. Localice el directorio en el que instaló el SDK para Android. Ejecute SDK Manager y seleccione la versión del SDK que desea instalar. Asimismo, debe instalar una versión de las herramientas de compilación. Tome nota de la versión instalada.

  6. Modifique los archivos de configuración para indicar a Lumberyard qué versión del SDK utilizar a la hora de crear su juego:

    1. En el explorador de archivos, localice \_WAF_\android en el directorio en el que instaló Lumberyard.

    2. Edite el archivo android_settings.json para establecer BUILD_TOOLS_VER con la versión de las herramientas de compilación que acaba de instalar y para configurar SDK_VERSION con la versión del SDK que desea usar.

    3. Guarde el archivo.

  7. En una ventana de línea de comando, cambie al directorio lumberyard_version\dev.

  8. Para inicializar el sistema de compilación, ejecute el siguiente comando:

    lmbr_waf.bat configure

Configuración de su Mac

Después de descargar y extraer Lumberyard en el Mac, debe extraer y ejecutar Lumberyard Setup Assistant para instalar el software de terceros necesario para ejecutar el juego y compilar su código, el motor y la canalización de recursos y que es necesario para dispositivos Android.

Para instalar software de terceros desde Lumberyard Setup Assistant

  1. Descomprima el archivo SetupAssistant.zip (ubicado en el directorio lumberyard_version/Tools/LmbrSetup/Mac) y mueva .APP a Bin64. Ejecute Lumberyard Setup Assistant.

  2. En Lumberyard Setup Assistant, en la página Get started (Empezar), seleccione Run your game project (Ejecutar el proyecto de juego), Compile the game code (Compilar el código del juego) y Compile for Android devices (Compilar para dispositivos Android). Haga clic en Siguiente.

  3. Siga las instrucciones que aparecen en pantalla para completar la instalación de cualquier software de terceros o los SDK que necesita. Asegúrese de instalar la biblioteca de audio Wwise y JDK v7u79. Para obtener más información acerca del uso de Lumberyard Setup Assistant, consulte Uso de Lumberyard Setup Assistant para configurar su entorno de desarrollo.

  4. En una ventana de línea de comando, cambie al directorio lumberyard_version/dev.

  5. Para inicializar el sistema de compilación, ejecute el siguiente comando:

    sh lmbr_waf.sh configure
  6. En el buscador, abra el archivo user_settings.options (ubicado en el directorio /lumberyard/dev/_WAF_/).

  7. Edite bootstrap_tool_param del siguiente modo:

    bootstrap_tool_param = --none --enablecapability compilegame --enablecapability compileandroid --no-modify-environment
  8. Modifique las variables de entorno haciendo lo siguiente:

    1. Si utiliza Bash, edite el archivo .bash_profile para añadir las rutas para android-sdk/platform-tools y android-sdk/tools.

    2. En una ventana de línea de comando, cambie al directorio SDK y ejecute el siguiente comando: tools/android update sdk --no-ui

  9. Localice el directorio en el que instaló el SDK para Android. Ejecute el archivo ejecutable Android (ubicado en el directorio tools) y seleccione la versión del SDK que desea instalar. Asimismo, debe instalar una versión de las herramientas de compilación. Tome nota de la versión instalada.

  10. Modifique los archivos de configuración para indicar a Lumberyard qué versión del SDK utilizar a la hora de crear su juego:

    1. En el explorador de archivos, localice /_WAF_/android en el directorio en el que instaló Lumberyard.

    2. Edite el archivo android_settings.json para establecer BUILD_TOOLS_VER con la versión de las herramientas de compilación que acaba de instalar y para configurar SDK_VERSION con la versión del SDK que desea usar.

    3. Guarde el archivo.

      importante

      Debe guardar estos archivos con las terminaciones de la línea correctas. Si no va a utilizar el editor de texto Vim, averigüe cuál es el método correcto para guardar los archivos. Si utiliza Vim, guarde el archivo ejecutando el siguiente comando: w ++ff=mac.

  11. En una ventana de línea de comando, cambie al directorio lumberyard_version/dev.

  12. Para inicializar el sistema de compilación, ejecute el siguiente comando:

    sh lmbr_waf.sh configure