Share via

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

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

Para empezar a compilar su primera aplicación 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 que package.json 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 conectada la cuenta, 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. Project

Seleccione el de package.jsonsu proyecto. App Center extraerá automáticamente información de su archivo build.gradle (nivel de aplicación) asociado, 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 a partir de 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 definido personalizado) 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 una agrupación junto con su normal .apk.

Active la opción para que Android App Bundle 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 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 aumenta automáticamente para cada compilación. El cambio se produce durante la compilación real y no se confirmará en el repositorio.

3.7. Iniciar 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 estar firmada 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 leer más sobre la documentación de firma de código 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 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

Después de un desencadenador 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.
  • failed: la compilación se ha completado, pero se ha producido un error; Puede solucionar el problema mediante la descarga e inspección del 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 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 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 yarn.lock archivo está presente en el repositorio junto a package.json, App Center usará Yarn, haciendo yarn install al 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 que se ejecuten 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 una vez instaladas las dependencias.

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

  • Escriba un script de shell con 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 crear 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 para desarrolladores de Android correspondiente. Por lo tanto, asegúrese de que universalApk está establecido true en para la configuración de compilación de React Native.