Partager via

Création d’applications React Native pour Android

  • Article

Important

Visual Studio App Center est prévu pour la mise hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées que vous pouvez envisager de migrer vers.

En savoir plus sur les chronologies de support et les alternatives.

App Center peut créer des applications React Native à l’aide de React Native version 0.34 ou ultérieure.

Pour commencer à créer votre première application React Native Android, vous devez :

  1. Connectez-vous à votre compte de service de référentiel (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Sélectionnez un référentiel et une branche où se trouve votre application.
  3. Choisissez le projet package.json que vous souhaitez générer.
  4. Configurez votre première build.

Remarque

Pour que l’application s’exécute sur un appareil réel, la build doit être signée avec un certificat valide.

1. Liaison de votre référentiel

Si vous n’avez pas déjà connecté à votre compte de service de référentiel, vous devez d’abord effectuer cette opération. Une fois votre compte connecté, sélectionnez le référentiel où se trouve votre projet React Native. Vous devez disposer d’autorisations d’administrateur et d’extraction pour configurer une build pour un référentiel.

2. Sélection d’une branche

Après avoir sélectionné un référentiel, sélectionnez la branche que vous souhaitez générer. Par défaut, App Center répertorie toutes les branches actives.

3. Configuration de votre première build

Avant votre première build, vous devez configurer le projet React Native.

3.1. Project

Sélectionnez le projet package.json. App Center extrait automatiquement les informations de son fichier build.gradle (niveau de l’application), notamment les dépendances, la version des outils de génération, les types de build et les saveurs de produit.

Remarque

Pour des performances optimales, l’analyse est actuellement limitée à quatre niveaux de répertoire, y compris la racine de votre référentiel.

3.2. Variante de build

Les variantes de build disponibles sont renseignées à partir des types de build et des saveurs de produit spécifiés dans le fichier build.gradle (niveau de l’application) du projet. Sélectionnez la variante de build à générer.

Remarque

App Center Build prend en charge la recherche de variantes de build comme combinaison d’un type de build (débogage, mise en production ou définition personnalisée) et d’une version de produit facultative. La détection de combinaisons de plusieurs saveurs de produit n’est pas prise en charge pour l’instant.

3.3. Version de Node.js

Sélectionnez la version Node.js à utiliser pour la build En savoir plus sur la façon de sélectionner Node.js version

3.4. Créer des déclencheurs

Par défaut, une nouvelle build est déclenchée chaque fois qu’un développeur envoie (push) à une branche configurée. C’est ce qu’on appelle « Intégration continue ». Si vous préférez déclencher une nouvelle build manuellement, vous pouvez modifier ce paramètre dans le volet de configuration.

3.5. Générer un bundle d’applications Android (.aab)

Android App Bundle est un format de distribution qui peut être chargé dans le Play Store. Il est utilisé pour générer des API optimisées pour des appareils spécifiques. Vous pouvez en savoir plus sur le bundle d’applications Android dans la documentation Android officielle, ce qui vous aide également à comprendre si vous souhaitez créer un bundle avec votre standard .apk.

Activez l’option pour Android App Bundle pour produire un .aab ajout à l’option .apk. Si le build.gradle fichier (niveau de l’application) contient le android.bundle bloc, cette option est automatiquement activée.

3.6. Incrémenter le numéro de version

Lorsqu’elle est activée, le code de version dans le AndroidManifest.xml de votre application incrémente automatiquement pour chaque build. La modification se produit pendant la build réelle et ne sera pas validée dans votre référentiel.

3.7. Lancer votre build réussie sur un appareil réel

Utilisez le fichier APK nouvellement produit pour tester si votre application démarre sur un appareil réel. Les tests de lancement ajoutent environ 10 minutes supplémentaires au temps de génération total. En savoir plus sur la configuration des tests de lancement.

3.8. Signature de code

Une build réussie génère un .apk fichier et un fichier supplémentaire .aab s’il est activé. Pour libérer la build dans le Play Store, elle doit être signée avec un certificat valide stocké dans un magasin de clés. Pour signer les builds générées à partir d’une branche, activez la connexion de code dans le volet de configuration, chargez votre magasin de clés dans votre référentiel et fournissez les valeurs pertinentes dans le volet de configuration. Pour plus d’informations sur la signature de code Android, consultez la documentation de signature de code Android d’App Center. Le .aab sera signé à l’aide des mêmes informations d’identification que le .apk.

3.9. Distribuer la build

Vous pouvez configurer chaque build réussie à partir d’une branche pour être distribuée à un groupe de distribution créé précédemment ou à une destination de magasin. Vous pouvez ajouter un nouveau groupe de distribution ou configurer une connexion de magasin à partir du service Distribuer. Il existe toujours un groupe de distribution par défaut appelé « Collaborateurs » qui inclut tous les utilisateurs qui ont accès à l’application.

Remarque

Si vous distribuez dans google Play Store, un bundle d’applications Android (.aab) est préféré et sera distribué s’il est activé. Pour les groupes de distribution App Center et les destinations du Magasin Intune, un standard .apk sera utilisé même si un .aab objet est également généré.

4. Générer des résultats

Après un déclencheur de build, la build se trouvera dans l’un des états suivants :

  • mis en file d’attente : la build se trouve dans une file d’attente qui attend que les ressources soient libérées
  • génération : la build exécute les tâches prédéfinies
  • réussite : la build est terminée et elle a réussi
  • Échec : la build s’est terminée, mais elle a échoué ; vous pouvez résoudre les problèmes rencontrés en téléchargeant et en inspectant le journal de build.
  • annulé : la build a été annulée par une action de l’utilisateur ou elle a expiré

4.1. Journaux de génération

Pour une build terminée (réussie ou ayant échoué), téléchargez les journaux pour en savoir plus sur la façon dont la build a été effectuée. App Center fournit une archive avec les fichiers suivants :

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

Les journaux spécifiques à l’étape de génération (situés dans le build/ répertoire de l’archive) sont utiles pour résoudre les problèmes et comprendre à quelle étape et pourquoi la build a échoué.

4.2. L’application (.apk)

Le .apk fichier est un fichier empaqueté d’application Android qui stocke l’application Android. Si la build a été correctement signée, l’application peut être installée sur un appareil réel et déployée sur le Play Store. Si la build n’a pas été signée, l’application peut s’exécuter sur un émulateur ou être utilisée à d’autres fins.

5. Versions et exigences prises en charge

La version minimale prise en charge pour créer des applications Android est 5.0 (niveau d’API 21). Les applications Android peuvent avoir un niveau d’API minimal inférieur requis pour s’exécuter, mais doivent cibler au moins le niveau d’API 21.

6. Créer des conseils

6.1. Yarn

Le gestionnaire de package Yarn est un remplacement plus rapide et plus déterministe pour npm. Si un yarn.lock fichier est présent dans votre référentiel en package.jsonregard de , App Center utilise Yarn, en procédant yarn install au début de la build. Sinon, il le fera npm install.

6.2. Scripts de build personnalisés

Il existe plusieurs options d’exécution de scripts avant l’exécution des commandes de build par défaut d’App Center.

  • Créez un script postinstallé dans le fichier de package.json votre projet. Ce script s’exécute automatiquement une fois vos dépendances installées.

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

  • Écrivez un script shell à l’aide de la fonctionnalité de scripts de génération personnalisée d’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. Génération de plusieurs API

Pour React Native sur Android, la génération d’APK universelle est désactivée par défaut. Si la configuration de votre application est configurée pour générer plusieurs API, par exemple différentes par architecture d’UC ou configuration d’écran, vous devez vous assurer qu’un APK universel est également généré. Le système de génération d’App Center fonctionne avec un fichier APK principal et ignore toutes les API spécifiques à une certaine densité d’UC/ABI ou d’écran.

Pour en savoir plus sur les fractionnements APK et sur la création d’un APK universel, lisez le guide de développement Android correspondant. Par conséquent, assurez-vous qu’elle universalApk est définie true pour votre configuration de build React Native.