Creación de aplicaciones java para Android

Importante

Visual Studio App Center está programado para su retirada 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 de soporte técnico y las alternativas.

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 mediante la búsqueda en los archivos de directorio de 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 reemplazar por jcenter { url "http://jcenter.bintray.com/"}. Obtenga más información sobre el apagado de JCenter aquí.

1. Vinculación del repositorio

Si aún no lo ha hecho, debe conectarse a la cuenta de servicio del repositorio. Una vez conectada la cuenta, seleccione el repositorio donde se encuentra el proyecto de Android. Para configurar una compilación para un repositorio, necesita permisos 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 (depuración, versión o definido personalizado) y uno de los tipos de producto declarados por gradle. La detección de dimensiones de sabor (combinaciones de varios tipos de producto) 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 android App Bundle en la documentación oficial de Android.

Cambie la opción para que Android App Bundle genere un elemento .aab 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 se incrementa 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 el inicio de sesión 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. Inicio de 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. Configurar 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. Distribuir la compilación

Puede configurar cada compilación correcta desde una rama para que se distribuya 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 los destinos de la tienda de Intune, se usará un valor normal .apk incluso si también se genera ..aab

4. Resultados de 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 se 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 producido 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 APK 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 bloqueo 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 de Android Gradle para que se configuren correctamente. El repositorio debe incluir un contenedor de Gradle.

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