Creación de aplicaciones Java para Android

  • Artículo

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

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

  1. Conéctese 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 estar firmada con un certificado válido.

Nota

App Center realiza un seguimiento del proyecto buscando los archivos de directorio gradle (y gradlew) del proyecto de Android. No incluya estos archivos en el proyecto .gitignore, ya que App Center Build no podrá encontrarlos.

Advertencia

Debido al cierre reciente de JCenter, algunas aplicaciones pueden experimentar errores de tareas de Gradle al compilar con App Center. Consulte la guía de migración proporcionada por Gradle. Como solución alternativa, todas las instancias de jcenter() se pueden quitar 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 manualmente una nueva compilación, 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 qué variante de compilación 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 (debug, release o personalizado definido) y uno de los tipos de producto declarados por Gradle. La detección de dimensiones de sabor (combinaciones de varios tipos de productos) no se admite en este momento.

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 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.

Cambie la opción para que El paquete de aplicaciones de Android genere un .aab elemento además de .apk. Si el build.gradle archivo (nivel de aplicación) contiene el android.bundle bloque , esta opción ya estará activada.

3.4. Incrementar el número de versión

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

3.5. Firma de código

Una compilación correcta generará un .apk archivo y un archivo adicional .aab si está 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 generadas desde una rama, habilite el inicio de sesión 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 obtener más información sobre la firma de código en la documentación de firma de código android de App Center. .aab Se firmará con las mismas credenciales que ..apk

3.6. Iniciar la compilación correcta en un dispositivo real

Usa tu 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)

La información específica sobre la compilación se recopilará 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. Distribuir la compilación

Puede configurar cada compilación correcta desde una rama para distribuirla a un grupo de distribución creado anteriormente 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 Distribute. 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 Google Play Store, se prefiere un paquete de aplicaciones de Android (.aab) y se distribuirá si está habilitado. En el caso de los grupos de distribución de App Center y Intune destinos de la tienda, se usará un valor normal .apk incluso si también se genera ..aab

4. Resultados de la compilación

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

  • en cola: la compilación está en una cola en espera de que los recursos se libere.
  • building: la aplicación está compilando y ejecutando tareas relacionadas.
  • correcto: la compilación se ha completado correctamente.
  • failed: se completó la compilación, pero se produjo un error. Puede descargar e inspeccionar el registro de compilación para solucionar problemas.
  • cancelado: la acción del usuario canceló la compilación o agotó el tiempo de espera.

4.1. Registros de compilación

Para una compilación completada (correcta o errónea), descargue los registros para obtener más información sobre cómo se ha realizado 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 produjo un error en la compilación.

4.2. El paquete de la 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 implementarlo en Play Store. Si la compilación no se ha firmado, el APK se puede ejecutar en un emulador o usarse con otros fines.

4.3. Creación de varias API

Si la configuración de la aplicación compila varias API, también debe compilar 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 obtener 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. Archivo de asignación de desobfuscación (mapping.txt)

El mapping.txt archivo contiene información sobre cómo asignar seguimientos de pila ofuscados para la aplicación a los nombres 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 bloqueos habilitado y usa Proguard o R8 para minimizar y ofuscar el binario de la aplicación, el servicio de informes de bloqueos requiere este mapping.txt archivo para que una compilación muestre informes de bloqueo legibles (desobuscados) humanos.
  • Si anteriormente ha integrado otro SDK con fines de informes de bloqueos en la aplicación (por ejemplo, sdk de HockeyApp), el servicio correspondiente requiere que el mapping.txt archivo muestre informes de bloqueo legibles.

5. Versiones y requisitos admitidos

La versión mínima admitida para compilar aplicaciones Android es la 7.0 (nivel de API 24). Las aplicaciones de Android pueden tener un nivel de API mínimo 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 Android Gradle para configurarse correctamente. El repositorio debe incluir un contenedor de Gradle.

Consulte también: Información de La máquina de compilación en la nube