Creación de aplicaciones nativas de React 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.

App Center puede compilar aplicaciones de React Native con React Native versión 0.34 o posterior.

Para empezar a compilar la primera aplicación de React Native Android, debe hacer lo siguiente:

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

1. Vinculación del repositorio

Si no se ha conectado previamente a la cuenta de servicio del repositorio, primero debe hacerlo. Una vez que la cuenta esté conectada, seleccione el repositorio donde se encuentra el proyecto de React Native. Debe tener permisos de administrador y extracción para configurar una compilación para un repositorio.

2. Selección de una rama

Después de seleccionar un repositorio, seleccione la rama que desea compilar. De forma predeterminada, App Center enumera todas las ramas activas.

3. Configuración de la primera compilación

Antes de la primera compilación, debe configurar el proyecto de React Native.

3.1. Proyecto

Seleccione el objeto del package.jsonproyecto. App Center extraerá automáticamente información de su archivo build.gradle asociado (nivel de aplicación), incluidas las dependencias, la versión de las herramientas de compilación, los tipos de compilación y los tipos de producto asociados.

Nota:

Para obtener el mejor rendimiento, el análisis se limita actualmente a cuatro niveles de directorio, incluida la raíz del repositorio.

3.2. Variante de compilación

Las variantes de compilación disponibles se rellenarán desde los tipos de compilación y los tipos de producto especificados en el archivo build.gradle (nivel de aplicación) del proyecto. 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 personalizado definido) y un tipo de producto opcional. En este momento no se admiten combinaciones de varios tipos de productos.

3.3. Versión de Node.js

Seleccione la versión de Node.js que se va a usar para la compilación. Obtenga más información sobre cómo seleccionar Node.js versión.

3.4. 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.5. Compilación del paquete de aplicaciones de Android (.aab)

El paquete de aplicaciones de Android es un formato de distribución que se puede cargar en Play Store. 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, que también le ayuda a comprender si desea crear un paquete junto con su paquete normal. .apk.

Active 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 se activará automáticamente.

3.6. 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.7. Inicio de la compilación correcta en un dispositivo real

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

3.8. 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 los valores pertinentes en el panel de configuración. Puede obtener más información sobre la documentación de firma de código de Android de App Center. .aab Se firmará con las mismas credenciales que ..apk

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

Después de los desencadenadores de compilación, la compilación estará en uno de los siguientes estados:

• en cola: la compilación está en una cola en espera de que los recursos se libere.
• building: la compilación ejecuta las tareas predefinidas.
• correcto: la compilación se ha completado y se ha realizado correctamente.
• error : la compilación se ha completado, pero se ha producido un error; puede solucionar los problemas que se han producido al descargar e inspeccionar el registro de compilación.
• cancelado: una acción del usuario ha cancelado la compilación o se agota 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 build/ directorio 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. La aplicación (.apk)

El .apk archivo es un archivo empaquetado de aplicación Android que almacena la aplicación Android. Si la compilación se ha firmado correctamente, la aplicación se puede instalar en un dispositivo real e implementarla en Play Store. Si la compilación no se ha firmado, la aplicación se puede ejecutar en un emulador o usarse para otros fines.

5. Versiones y requisitos admitidos

La versión mínima admitida para compilar aplicaciones android es 5.0 (nivel de API 21). 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 21.

6. Sugerencias de compilación

6.1. Yarn

El administrador de paquetes de Yarn es un reemplazo más rápido y determinista para npm. Si un archivo está presente en el yarn.lock repositorio junto a package.json, App Center usará Yarn, al yarn install principio de la compilación. De lo contrario, hará npm install.

6.2. Scripts de compilación personalizados

Hay varias opciones para ejecutar scripts antes de ejecutar los comandos de compilación predeterminados de App Center.

• Cree un script postinstall en el archivo del package.json proyecto. Este script se ejecutará automáticamente después de instalar las dependencias.

    "scripts": {
      ...
      "postinstall" : "npx jetify" // other examples: "node ./postinstall.js" or "./postinstall.sh"
    },
  

• Escriba un script de shell mediante la funcionalidad de scripts de compilación personalizados de App Center.

  #!/usr/bin/env bash
  
  # Example: Authenticate with private NPM registry
  echo "//registry.npmjs.org/:_authToken=$NPM_AUTH_TOKEN" > ~/.npmrc
  
  # Example: Add your signing key file (from base64 encoded environment variable)
  base64 -d <<< "$ANDROID_JSON_KEY_FILE" > android/keystores/json_key_file.json
  

6.3. Creación de varias API

Para React Native en Android, la generación universal de APK está deshabilitada de forma predeterminada. Si la configuración de la aplicación está configurada para compilar varias API, por ejemplo, diferentes por arquitectura de CPU o configuración de pantalla, debe asegurarse de que también se compila un APK universal. El sistema de compilación de App Center funciona con un archivo APK principal y omitirá todas las API específicas de una determinada CPU/ABI o densidad de pantalla.

Para obtener más información sobre las divisiones de APK y cómo crear un APK universal, lea la guía correspondiente para desarrolladores de Android. Por lo tanto, asegúrese de que universalApk está establecido true en para la configuración de compilación de React Native.