Lumberyard
Guía del usuario (Version 1.21)

Configuración del proyecto de juego para Android

Antes de usar Lumberyard para crear juegos de Android, debe configurar el proyecto de juego que se creará para Android. También puede personalizar la configuración de Android en el proyecto de juego para permitir almacenar la implementación.

Requisitos previos

Para configurar el proyecto de juego para Android, debe disponer de lo siguiente:

  • Lumberyard y el SDK de Lumberyard instalado

  • El entorno de desarrollo configurado

  • Conocimientos básicos del sistema de compilación de Lumberyard Waf y el formato de datos JSON

  • Lumberyard configurado para crear juegos de Android

    Para obtener información, consulte Compatibilidad con Android.

  • Un proyecto de juego

Configuración del proyecto de juego para crear en Android

Puede habilitar el proyecto de juego que se creará para Android modificando determinados ajustes del archivo project.json del proyecto de juego.

Para modificar el archivo project.json del proyecto de juego

  1. En un navegador de archivos, vaya al directorio de activos del proyecto de juego. Por ejemplo, \dev\SamplesProject en el directorio en el que ha instalado Lumberyard.

  2. Use un editor de texto para abrir el archivo project.json.

  3. Compruebe que aparece la siguiente entrada o añada la entrada si no existe: "android_settings": {}

  4. Guarde el archivo project.json.

  5. En una ventana de línea de comandos, vaya a la raíz del directorio donde instaló Lumberyard (lumberyard_version\dev).

  6. Ejecute el comando lmbr_waf configure:

    • En un equipo PC, ejecute el siguiente comando: lmbr_waf.bat configure.

    • En un Mac, ejecute el siguiente comando: ./lmbr_waf.sh configure.

    Si se produce un error al configurar el proyecto de juego para Android, se muestra un mensaje de advertencia similar al siguiente:

    [WARN] Android settings not found in SamplesProject/project.json, skipping.
  7. Puede ver el contenido del proyecto de Android generado en el directorio de proyectos de Android Studio. Por ejemplo, lumberyard_version\dev\Solutions\LumberyardAndroidSDK\SamplesProjectLauncher.

  8. Cree y pruebe el proyecto de juego en Android. Para obtener información, consulte Compilación de juegos Android.

Personalización de la configuración de Android para el proyecto de juego

Después de agregar la entrada de la configuración de Android para el proyecto de juego, puede personalizar varios ajustes para generar el proyecto y preparar el juego de Android para implementarlo en la tienda.

Puede personalizar la siguiente configuración de Android:

Nombre del paquete de Android

Descripción: se utiliza para generar la clase de actividad Java específica del proyecto y en el archivo AndroidManifest.xml

Nombre de la etiqueta: "package_name"

Tipo: cadena en formato separado por puntos

Ejemplo: "com.mycompany.mygame"

Número de versión del código de manifiesto

Descripción: número de versión de la aplicación interna. Se utiliza para establecer la etiqueta android:versionCode en AndroidManifest.xml.

Nombre de la etiqueta: "version_number"

Tipo: Valor de número entero

Valor predeterminado: 1

Nombre de versión del manifiesto

Número de versión inteligible. Se utiliza para establecer la etiqueta android: versionName en AndroidManifest.xml.

Nombre de la etiqueta: "version_name"

Tipo: String

Ejemplo: "1.0.0"

Orientation

Descripción: orientación de la aplicación Android. Se utiliza para establecer la etiqueta android:screenOrientation en AndroidManifest.xml.

Nombre de la etiqueta: "orientation"

Tipo: String

Valores válidos: consulte la página Android Developers para ver los valores válidos.

Valor predeterminado: "landscape"

Anulación del icono de la aplicación

Nombre de la etiqueta: "icons"

Tipo: mapeo de cadenas para cada opción de resolución. Todas las entradas precisan una ruta relativa a \Code\project\Resources o una ruta de recursos absoluta. Incluya el nombre de una imagen .png en la cadena.

Valores válidos: "mdpi", "hdpi", "xhdpi", "xxhdpi", "xxxhdpi", "default" (se utiliza la imagen definida para "default" si no se especifica una anulación DPI específica)

Anulación de la pantalla inicial de la aplicación

Nombre de la etiqueta: "splash_screen"

Tipo: mapeo de dos mapeados

  • Nombre de etiqueta horizontal: "land"

  • Nombre de etiqueta vertical: "port"

Ambos mapeados de orientación admiten las mismas opciones. Todas las entradas precisan una ruta relativa a \Code\project\Resources o una ruta de recursos absoluta. Incluya el nombre de una imagen .png en la cadena.

Valores válidos: "mdpi", "hdpi", "xhdpi", "xxhdpi", "default" (se utiliza la imagen definida para "default" si no se especifica una anulación DPI específica)

Permitir empaquetar los activos en el APK

Descripción: obliga a empaquetar los activos en el APK en compilaciones no comerciales

Nombre de la etiqueta: "place_assets_in_apk"

Tipo: Valor de número entero

Valores válidos: 0 (No) o 1 (Sí)

Valor predeterminado: 0

Clave de licencia de la aplicación Google Play

Descripción: clave de licencia de la aplicación facilitada por Google Play. Se necesita para utilizar archivos de expansión APK u otros servicios de Google Play.

Nombre de la etiqueta: "app_public_key"

Tipo: cadena (clave pública RSA codificada en Base64)

Valor predeterminado: "NoKey"

Valor de sal específico de la aplicación para la (des)ofuscación al utilizar archivos de expansión APK

Nombre de la etiqueta: "app_obfuscator_salt"

Tipo: cadena que contiene una serie de bytes aleatorios

Valor predeterminado: ""

Especificar si se desea utilizar el archivo de expansión APK principal

Descripción: activa el modo de archivo de expansión APK en compilaciones comerciales.

Nombre de la etiqueta: "use_main_obb"

Tipo: valor de cadena que contiene "true" o "false"

Valor predeterminado: "false"

Especificar si se desea utilizar el archivo de expansión APK "Patch"

Descripción: activa el modo de archivo de expansión APK en compilaciones comerciales.

Nombre de la etiqueta: "use_patch_obb"

Tipo: valor de cadena que contiene "true" o "false"

Valor predeterminado: "false"

Forzar el modo de archivo de expansión APK en compilaciones no comerciales

Nombre de la etiqueta: "enable_obb_in_dev"

Tipo: valor de cadena que contiene "true" o "false"

Valor predeterminado: "false"

Habilitar o deshabilitar el bloqueo de suspensión de la pantalla

Descripción: alterna si el dispositivo pasará a hibernar mientras se ejecuta la aplicación.

Nombre de la etiqueta: "enable_keep_screen_on"

Tipo: valor de cadena que contiene "true" o "false"

Valor predeterminado: "false"

Anular el job RC para generar los archivos PAK normales utilizados en compilaciones comerciales

Nombre de la etiqueta: "rc_pak_job"

Tipo: cadena que contiene el nombre de archivo XML relativo a \dev\Bin64\rc

o Valor predeterminado: "RcJob_Generic_MakePaks.xml"

Anular job RC para generar archivo(s) de expansión APK

Nombre de la etiqueta: "rc_obb_job"

Tipo: cadena que contiene el nombre de archivo XML relativo a \dev\Bin64\rc

Valor predeterminado: "RCJob_Generic_Android_MakeObb.xml"

Para añadir una anulación de la configuración de Android

  1. En un navegador de archivos, vaya al directorio de activos del proyecto de juego.

  2. Use un editor de texto para abrir el archivo project.json.

  3. Añada cualquiera de los ajustes de personalización anteriores a la entrada "android_settings" en el archivo project.json.

    El siguiente ejemplo incluye todos los ajustes de Android personalizables:

    "android_settings" : { "package_name" : "com.lumberyard.samples", "version_number" : 1, "version_name" : "1.0.0.0", "orientation" : "landscape", "icons" : { "default" : "AndroidLauncher/icon-xhdpi.png", "mdpi" : "AndroidLauncher/icon-mdpi.png", "hdpi" : "AndroidLauncher/icon-hdpi.png", "xhdpi" : "AndroidLauncher/icon-xhdpi.png", "xxhdpi" : "AndroidLauncher/icon-xxhdpi.png", "xxxhdpi" : "AndroidLauncher/icon-xxxhdpi.png" }, "splash_screen" : { "land" : { "default" : "AndroidLauncher/splash-xhdpi.png", "mdpi" : "AndroidLauncher/icon-mdpi.png", "hdpi" : "AndroidLauncher/icon-hdpi.png", "xhdpi" : "AndroidLauncher/icon-xhdpi.png", "xxhdpi" : "AndroidLauncher/icon-xxhdpi.png" }, "port": { "default" : "AndroidLauncher/icon-xhdpi.png", "mdpi" : "AndroidLauncher/icon-mdpi.png", "hdpi" : "AndroidLauncher/icon-hdpi.png", "xhdpi" : "AndroidLauncher/icon-xhdpi.png", "xxhdpi" : "AndroidLauncher/icon-xxhdpi.png" } } "place_assets_in_apk" : 0, "app_public_key" : "MIIBIjANBgkqhkiG9w0BALuMbErYaRdAMIIBCgKCAQEAjvkl+K7rVA SNkLExAmPlEoWwsxCX1vx7uV3IIH5CQIZBRGT8KeYr6ThWlIPhSMKMIm j7KxjdYcil8J0rwrVL3cmAYdMM+02ntnBEemGvRVOKxkDaFc5Fw6tJVv 3SJ6UyjVtehB7tJupaYdfFe9SVhW0xJZu2YsZLuMbErYaRdrrgXU2Upr 547mxuyEHJ7jG7YFVrQgxou1W/71QnExAmPlExi6mlsUJBFN4xADikNW ZDlI70iHF6ZYyOspZCbVZ9DScN+D5oS3KeY/KKd5WOU6BB8NmTY5VZVd UOd4VPRXrYMnRY7FjZJMPujLNvlrAJs5H/G+0wUTR4SI61AiGJiQIDAQ AB", "app_obfuscator_salt" : "8d87473f5b24852836d0652abbd9e9b9869c208", "use_main_obb" : "true", "use_patch_obb" : "false", "enable_obb_in_dev" : "false", "enable_keep_screen_on" : "true", "rc_pak_job" : "RcJob_MakeCustomPaks.xml", "rc_obb_job" : "RcJob_MakeCustomAndroidObb.xml" },
  4. Guarde el archivo.

  5. En una ventana de línea de comandos, vaya a la raíz del directorio donde instaló Lumberyard (lumberyard_version\dev).

  6. Ejecute el comando lmbr_waf configure:

    • En un equipo PC, ejecute el siguiente comando: lmbr_waf.bat configure.

    • En un Mac, ejecute el siguiente comando: ./lmbr_waf.sh configure.