Creación de aplicaciones de Java para Android

Para compilar la primera aplicación de Android, siga estos pasos:

  1. Conectar a la cuenta de servicio del repositorio (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Seleccione un repositorio y una rama donde reside la aplicación.
  3. Elija el proyecto de Android que desea compilar.
  4. Configure la primera compilación.

Nota

Para que la aplicación se ejecute en un dispositivo real, la compilación debe ser código firmado con un certificado válido.

Advertencia

Debido al cierre reciente de JCenter, ciertas aplicaciones pueden experimentar errores de gradle Task al compilar con App Center. Consulte la guía de migración proporcionada por Gradle. Como solución alternativa, todas las instancias de se pueden quitar jcenter() del build.gradle archivo y reemplazarse por jcenter { url "http://jcenter.bintray.com/"} . Obtenga más información sobre el apagado de JCenter aquí.

1. Vinculación del repositorio

Debe conectarse a la cuenta de servicio del repositorio si aún no lo ha hecho. Una vez conectada la cuenta, seleccione el repositorio donde se encuentra el proyecto de Android. Para configurar una compilación para un repositorio, necesita permiso de administrador y extracción para él.

2. Selección de una rama

Después de seleccionar un repositorio, seleccione la rama que desea compilar. De forma predeterminada, se mostrarán todas las ramas activas.

3. Configuración de la primera compilación

Antes de la primera compilación, es necesario configurar el proyecto de Android.

3.1. Desencadenadores de compilación

De forma predeterminada, se desencadena una nueva compilación cada vez que un desarrollador inserta en una rama configurada. Esto se conoce como "Integración continua". Si prefiere desencadenar una nueva compilación manualmente, puede cambiar esta configuración en el panel de configuración.

3.2. Variante de compilación

Las variantes de compilación disponibles se rellenarán a partir de los tipos de compilación y los tipos de producto especificados en el archivo build.gradle (nivel de aplicación). Seleccione la variante de compilación que se debe compilar.

Nota

App Center Build admite la búsqueda de variantes de compilación como la combinación de un tipo de compilación (depuración, versión o definido personalizado) y uno de los tipos de producto declarados por Gradle. En este momento no se admite la detección de dimensiones de tipo (combinaciones de varios tipos de producto).

3.3. Compilación del paquete de aplicaciones de Android (.aab)

El paquete de aplicaciones de Android es un formato de distribución que se carga en el Play Store y se usa para generar API optimizadas para dispositivos específicos. Puede obtener más información sobre el paquete de aplicaciones de Android en la documentación oficial de Android.

Alterne la opción de Paquete de aplicaciones de Android para generar .aab un además de .apk . Si el build.gradle archivo (nivel de aplicación) contiene android.bundle el bloque , esta opción ya estará activa.

3.4. Incrementar el número de versión

Cuando se habilita, el código de versión del AndroidManifest.xml de la aplicación se incrementa automáticamente para cada compilación. El cambio se produce durante la compilación real y no se confirma en el repositorio.

3.5. Firma de código

Una compilación correcta producirá un .apk archivo y un archivo adicional si está .aab habilitado. Para liberar la compilación en Play Store, debe firmarse con un certificado válido almacenado en un almacén de claves. Para firmar las compilaciones producidas desde una rama, habilite la firma de código en el panel de configuración, cargue el almacén de claves en el repositorio y proporcione las credenciales pertinentes en el panel de configuración. Puede leer más sobre el inicio de sesión de código en App Center documentación defirma de código android de . se .aab firmará con las mismas credenciales que .apk .

3.6. Inicio de la compilación correcta en un dispositivo real

Use el archivo APK recién generado para probar si la aplicación se inicia en un dispositivo real. Esto agrega aproximadamente 10 minutos más al tiempo de compilación total. Obtenga más información sobre cómo configurar pruebas de inicio.

3.7. Configuración desde el archivo build.gradle (nivel de aplicación)

Se recopilará información específica sobre la compilación del archivo de Gradle, incluidas las dependencias, la versión de las herramientas de compilación, los tipos de compilación y los tipos de producto.

3.8. Distribución de la compilación

Puede configurar cada compilación correcta de una rama para distribuirla a un grupo de distribución creado previamente o a un destino de almacén. Puede agregar un nuevo grupo de distribución o configurar una conexión de almacén desde el servicio Distribuir. Siempre hay un grupo de distribución predeterminado denominado "Colaboradores" que incluye todos los usuarios que tienen acceso a la aplicación.

Nota

Si se distribuye a la Google Play Store, se prefiere un paquete de aplicaciones de Android ( ) y .aab se distribuirá si está habilitado. Para App Center de distribución y destinos de tienda de Intune, se usará un valor normal incluso .apk si también se genera .aab .

4. Resultados de compilación

Una vez desencadenada una compilación, puede estar en estos estados:

  • queued: la compilación está en una cola a la espera de que se liberarán los recursos.
  • building: la aplicación está creando y ejecutando tareas relacionadas.
  • succeeded: la compilación se ha completado correctamente.
  • error: la compilación se completó, pero no se pudo realizar. Puede descargar e inspeccionar el registro de compilación para solucionar problemas.
  • cancelado: la compilación se canceló por acción del usuario o se ha cancelado el tiempo de espera.

4.1. Registros de compilación

Para una compilación completada (correcta o con errores), descargue los registros para obtener más información sobre cómo ha ido la compilación. App Center proporciona un archivo con los siguientes archivos:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Los registros específicos del paso de compilación (ubicados en el directorio build/del archivo) son útiles para solucionar problemas y comprender en qué paso y por qué se ha generado un error en la compilación.

4.2. El paquete de aplicación (APK)

El APK es un paquete que contiene la aplicación y los recursos de Android. Si la compilación está firmada correctamente, el APK se puede instalar en un dispositivo real e implementarse en el Play Store. Si la compilación no se ha firmado, el APK se puede ejecutar en un emulador o usarse para otros fines.

4.3. Creación de varias API

Si la configuración de la aplicación compila varias API, también debe crear un APK universal. Nuestro sistema de compilación funciona con un archivo APK principal y omitirá todas las API específicas de una determinada ABI de CPU o densidad de pantalla. Para más información sobre las divisiones de APK y la creación de un APK universal, lea la guía de división de ABI.

4.4. El archivo de asignación de desobuscación (mapping.txt)

El archivo contiene información sobre cómo asignar seguimientos de pila ofuscados para la aplicación a los nombres mapping.txt de clase y método originales.

  • Si anteriormente ha integrado el SDK de App Center en la aplicación con el módulo de informes de bloqueo habilitado y usa Proguard o R8 para minificar y ofuscar el archivo binario de la aplicación, el servicio de informes de bloqueo requiere este archivo para que una compilación muestre informes de bloqueo mapping.txt legibles (desobfuscados)humanos.
  • Si anteriormente ha integrado otro SDK con fines de informes de bloqueos en la aplicación (por ejemplo, el SDK de HockeyApp), el servicio correspondiente requiere que el archivo muestre informes de bloqueo mapping.txt legibles.

5. Versiones y requisitos admitidos

La versión mínima admitida para compilar aplicaciones Android es 7.0 (nivel de API 24). Las aplicaciones Android pueden tener un nivel mínimo de API inferior necesario para ejecutarse, pero deben tener como destino al menos el nivel de API 24.

Las aplicaciones deben compilarse con Gradle y el complemento Gradle de Android para que se configuren correctamente. El repositorio debe incluir un contenedor de Gradle.

Consulte también: Información de Cloud Build Machine