Constructions Android

Construirez et soumettons des applications Android à Google Play Store à l'aide de l'infrastructure dédiée de Capgo.

Ce que vous allez apprendre

• Vous apprendrez à télécharger votre application via Capgo Native build
• Vous apprendrez à configurer les informations d'identification pour Capgo Native Build

Prérequis

• Vous devez avoir un compte développeur Google actif
• Vous devez avoir Android Studio installé
• Votre application doit être capable de se construire avec succès avec Android Studio

Remarque

I utiliserai l'application suivante pour le tutoriel : https://github.com/Cap-go/capgo-native-build-tutorial-app

Recommandé : l'onboarding automatique

Vous n'avez pas besoin de faire quoi que ce soit de main. L'onboarding de Capgo crée et configure vos clés de signature Android (keystore + compte de service Google Play) pour vous — c'est le chemin recommandé :

bunx @capgo/cli@latest build init --platform android

La marche à suivre manuelle ci-dessous est uniquement pour ceux qui préfèrent configurer les clés de signature eux-mêmes, ou qui souhaitent comprendre exactement ce que Capgo fait sous la surface.

La première construction manuelle

Avant de pouvoir commencer à réfléchir à la construction de l'application avec Capgo, nous devrions d'abord la configurer, et faire une première construction Android de main. Il y a quelques avantages à faire une construction manuelle en premier :

• Vous préparerez les clés de signature pour la construction ultérieure de Capgo
• Vous créerez un enregistrement sur le Console de Magasin Play

Vous allez construire l'application manuellement avec Android Studio

Avant de pouvoir commencer à construire l'application avec Capgo, nous devons construire l'application manuellement avec Android Studio.

1. Ouvrir Android Studio

   Exécuter bunx cap open android pour ouvrir le projet Android Studio.

2. Cliquez sur Build -> Generate Signed App Bundles / APKs

3. Sélectionner Android App Bundle et cliquez sur Next

Créer un fichier de clé de stockage

Vous manquez actuellement le fichier de clé de stockage. Ce fichier est utilisé pour signer votre application, ce qui permet à Google de savoir que c'est vous qui avez créé l'application. Pour le générer, nous utiliserons la méthode graphique fournie par Android Studio. Il existe également une façon de procéder avec la ligne de commande, mais nous ne couvrirons pas cela dans ce tutoriel.

1. Cliquez sur Create new

2. Saisir le chemin du magasin de clés

   Attention

   Ceci DOIT ÊTRE SAUVEGARDÉ - il sera utilisé ultérieurement

3. Définir le mot de passe de la clé de magasin

   Remarque

   Je vous recommande d'utiliser le même mot de passe pour la clé de magasin et la clé d'alias.

   Attention

   Ceci SAUVEZ-LE, il sera utilisé plus tard Remplissez le reste du formulaire

4. Conservez la clé d'alias telle quelle (key0)

   1. Conservez la clé d'alias telle quelle (key0)
   2. Remplissez les détails du certificat. J'ai rempli les détails avec des informations fictives, mais vous devez remplir les détails avec vos propres informations.

   

5. Cliquez sur OK

Terminer la construction manuelle

1. Assurez-vous que tous les détails du clé de stockage ont été remplis correctement et cliquez sur Next

2. Sélectionnez le release variant de construction et cliquez sur Create

3. Après le succès de la construction, vous devriez voir l'écran suivant

   1. Cette fenêtre de dialogue indique que la build a réussi.
   2. Cliquez sur le locate bouton - cela ouvrira l'explorateur de fichiers et vous devriez voir la build là.

4. Assurez-vous de pouvoir voir la build dans l'explorateur de fichiers

Création de l'application sur le Console de Magasin Play

1. Allez à Console de Magasin Google

2. Sélectionnez le compte développeur correct

3. Cliquez sur Create app

4. Choisissez le nom de l'application et la langue

5. Sélectionnez la catégorie de l'application et si l'application est payante ou gratuite

6. Acceptez les conditions générales

   Attention

   Assurez-vous de lire les conditions générales avant de les accepter.

7. Cliquez sur Create

Création du groupe de test interne

Maintenant que vous avez créé l'application, vous pouvez créer un groupe de test interne. Puisque je ne publierai pas réellement l'application pour tout le monde sur le Play Store, je devrai créer un groupe de test interne.

Note

Le test interne est toujours la façon la plus rapide de tester votre build Play-distribué avant une véritable mise en production.

Si votre compte développeur est un compte personnel créé après le 13 novembre 2023, le test interne ne remplace pas l'exigence de test fermé pour l'accès à la production. Vous aurez toujours besoin d'un test fermé avec au moins 12 testeurs optés pour 14 jours consécutifs avant la production. Allez à Cliquez sur

1. Créer le groupe de test interne internal testing Le test interne n'est pas une alternative au test fermé Test and release -> Testing -> Internal testing

   

2. Cliquez sur Testers

3. Cliquez sur Create email list

4. Nommez la liste d'emails

5. Ajoutez les adresses email des testeurs

6. Appuyez sur Enter et cliquez sur Save

7. Cliquez sur Create group

8. Assurez-vous que la nouvelle liste est sélectionnée et cliquez sur Save

Téléchargement de l'application dans le groupe de test interne

Maintenant que vous avez créé le groupe de test interne, vous pouvez télécharger l'application dans le groupe de test interne.

1. Allez à Test and release -> Testing -> Internal testing

2. Cliquez sur le Releases bouton

3. Cliquez sur Create new release

4. Cliquez sur Upload

5. Sélectionnez le fichier AAB

   Attention

   Assurez-vous de sélectionner le fichier AAB que vous avez construit manuellement avec Android Studio. Si ce fichier ne utilise pas le même coffre-fort que celui que vous utiliserez pour la Capgo construction, la Capgo construction Native échouera.

6. Attendez que le fichier AAB soit téléchargé

7. Cliquez sur Next

8. Corrigez les erreurs

   Perso, à cette étape, je vois cette erreur

   

   Cela se produit parce que je n'ai pas encore vérifié mon numéro de téléphone. Je vais le faire et continuer le tutoriel.

9. Cliquez sur Save and publish Cela publiera l'application dans le groupe de test interne.

10. Confirmez la publication

11. Assurez-vous que l'application est publiée

12. Obtenez votre nom d'application temporaire

Acceptez l'invitation au groupe de test interne

Maintenant que vous avez téléchargé l'application dans le groupe de test interne, vous pouvez accepter l'invitation au groupe de test interne.

1. Allez à Test and release -> Testing -> Internal testing

2. Cliquez sur Testers

3. Cliquez sur Copy link

4. Envoyez le lien à votre téléphone, ouvrez-le dans votre navigateur et cliquez sur Accept

5. Confirmer que l'invitation a été acceptée et cliquez sur « télécharger sur Google Play »

6. Installer l'application

   1. Si vous aviez déjà installé l'application avant d'utiliser Android Studio, cliquez sur le uninstall bouton
   2. Cliquez sur le install bouton
   3. Ouvrez l'application et confirmez qu'elle a téléchargée avec succès

   Attention

   Si vous ne voyez pas l'application sur Google Play, assurez-vous d'avoir sélectionné le compte correct dans Google Play.

Configuration de la mise en œuvre native de Capgo (Android)

Vous êtes maintenant prêts à démarrer la configuration de la mise en œuvre native de Capgo. Félicitations !

Requis	Drapeau	Description	Fichier de clé de signature
Emplacement de votre	--keystore <path>	fichier de clé de signature .jks/.keystore fichier utilisé pour signer l’APK/AAB.	Oui
Alias de clé	--keystore-alias <alias>	Nom de l'alias de la clé à l'intérieur du coffre-fort.	Oui
Mot de passe de la clé du coffre-fort	--keystore-key-password <password>	Voir la note ci-dessous	Mot de passe du coffre-fort
Voir la note ci-dessous	--keystore-store-password <password>	Compte de service Google Play	Note : si les mots de passe de la clé et du coffre-fort sont identiques, vous pouvez fournir uniquement le premier.
Note : si les mots de passe de la clé et du coffre-fort sont identiques, vous pouvez fournir uniquement le premier.	--play-config <path>	Fichier de compte de service JSON pour les téléchargements sur Play Store.	Oui

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Note

Si les mots de passe de la clé et du magasin sont identiques, fournissez uniquement l'un des --keystore-key-password ou --keystore-store-password.

Clé de magasin, mot de passe de magasin, mot de passe de clé de magasin, alias de clé de magasin

Si vous avez suivi les instructions de construction manuelle ouVous devriez déjà avoir généré votre clé de stockage. Si vous n'avez pas suivi les instructions, veuillez les suivre pour générer la clé de stockage.

Compte de service Google Play

La génération du compte de service Google Play est un processus manuel et complexe. Cependant, il est nécessaire pour télécharger votre application sur Google Play. Veuillez garder à l'esprit les choses suivantes :

• Vous context Vous êtes le propriétaire du compte de développeur. NEEDde devoir être le
• propriétaire du Compte de développeur

. Sinon, vous ne pourrez pas configurer le compte de service.

1. Vous devrez créer un nouveau projet Google Cloud (séparé de votre compte Google Play). Console Cloud de Google

2. Cliquez sur le sélecteur de projet

3. Si vous avez déjà un projet, sélectionnez-le. Sinon, créez un nouveau projet :

   Remarque

   Les captures d'écran ci-dessous sont illustratives - utilisez un nom approprié pour votre projet.

   1. Cliquez sur New project
   2. Nommez votre projet et cliquez sur Create
   3. Assurez-vous d'être sur le bon projet

4. Appuyez sur le champ de recherche et recherchez service accounts et appuyez dessus

5. Appuyez sur Create service account

6. Remplissez le formulaire pour le compte de service et appuyez sur Done

   1. Je vous recommande de définir le nom à Capgo Native Build Service Account
   2. Pour l'ID de compte de service, je vous recommande de le définir à capgo-native-build-service-acc
   3. Quant à la description, vous n'avez pas besoin de la remplir, mais je vous recommande de la remplir avec Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Appuyez sur le compte de service créé récemment Vous devriez maintenant voir le compte de service créé récemment dans la liste. Appuyez dessus.

   Note

   Copiez également cette adresse e-mail, vous en aurez besoin plus tard.

8. Cliquez sur le Keys onglet

9. Cliquez sur Add Key et Create new key

10. Cliquez sur JSON et Create

    Attention

    Cliquez sur Create créera une nouvelle clé et téléchargera le fichier JSON sur votre machine locale.

    Vous devez sauvegarder le fichier JSON dans un endroit sûr. Il SERA utilisé plus tard.

11. Télécharger le fichier JSON Le fichier JSON devrait avoir été téléchargé automatiquement. Vous pouvez cliquer sur close pour fermer la fenêtre.

Accorder à Play Store API l'accès au compte de service

Le nouveau compte de service n'a pas encore accès à la boutique Play API. Pour y accéder, rendez-vous sur le console de la boutique Play.

1. Allez à Console de la boutique Play
2. Sélectionnez le compte de développeur correct
3. Cliquez sur Users and permissions
4. Cliquez sur Invite new users
5. Copiez l'adresse e-mail du compte de service
6. Allez à Account permissions et accordez les permissions minimales requises :
   • Dans App permissions, accordez l'accès à votre application.
   • Dans Releases, activez Create, edit, and roll out releases.
   • Si votre flux de travail utilise Play App Signing, activez la permission de signature liée.
   • Si vous êtes incertain, utilisez Admin seulement pendant la configuration, puis réduisez les permissions ultérieurement.
7. Cliquez sur Invite user
8. Confirmer l'invitation
9. Confirmer que l'utilisateur a été invité

Enregistrer les informations de connexion

Vous êtes maintenant prêt à enregistrer les informations de connexion et à exécuter votre première build. Vous pouvez enregistrer les informations de connexion à l'aide de la commande suivante :

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Configuration CI/CD (GitHub Actions)

Si vous avez déjà complété Clé de stockage, mot de passe de la clé de stockage, mot de passe de la clé de stockage, alias de la clé de stockage et compte de service Google PlayVous disposez déjà de tout ce dont vous avez besoin pour CI/CD. Cette section ne couvre que la manière de passer ces valeurs sous forme de secrets GitHub Actions et de variables d'environnement.

1) Convertir les fichiers de crédentials en base64 à une ligne

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

__CAPGO_KEEP_0__ secrets devraient être des valeurs à une ligne.

GitHub secrets should be single-line values. tr -d '\n' 1) Convertir les fichiers de crédentials en base64 à une ligne

2) Créez des secrets de dépôt

Dans GitHub > Repository > Settings > Secrets and variables > Actions, ajoutez :

Nom du secret	Valeur
CAPGO_TOKEN	Votre jeton Capgo API
APP_ID	Votre ID d'application Capgo (exemple :) com.example.app)
ANDROID_KEYSTORE_FILE	Contenu de keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias de clé de coffre de sécurité à partir de Clé de coffre de sécurité, mot de passe de coffre de sécurité, mot de passe de clé de coffre de sécurité, alias de clé de coffre de sécurité
KEYSTORE_KEY_PASSWORD	Mot de passe de clé de coffre de sécurité
KEYSTORE_STORE_PASSWORD	Mot de passe de la boutique de clés
PLAY_CONFIG_JSON	Contenu de play_config_base64.txt

Remarque

Si les mots de passe de la clé et du magasin sont les mêmes, vous pouvez fournir juste l'un d'eux. KEYSTORE_KEY_PASSWORD ou KEYSTORE_STORE_PASSWORD.

3) Utilisez les variables d'environnement dans votre workflow d'Actions de GitHub

/github/flux de travail/android-build.yml

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

Conseil

Avec cette configuration, CI envoie les informations d'identification à l'aide de variables d'environnement uniquement. Vous n'avez pas besoin de commiter les fichiers de signature ou de les télécharger en tant qu'artefacts de workflow.

Exécution de la construction

Félicitations ! Vous êtes maintenant prêt à exécuter votre première construction.

Exécuter :

bunx @capgo/cli@latest build request com.example.app --platform android

Et cela démarre le processus de construction

Soumettre la mise à jour de Play pour examen

Par défaut, les builds de mise à jour Android téléchargent sur Google Play et peuvent rester inactifs jusqu'à ce que vous ayez terminé la mise à jour dans le console de Play. Si votre CI doit soumettre automatiquement la mise à jour de Play, passez --submit-to-store-review avec une build de mise à jour :

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --android-track production \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

Attention

Sur Android, --submit-to-store-review par défaut, il s'agit de production suivi avec release_status: completed lorsque vous n'avez pas défini de suivi. Cela peut être mis en ligne pour 100 % des utilisateurs. Passer --android-track internal (ou alpha / beta) — ou définir PLAY_STORE_TRACK dans CI — pour conserver la version complétée sur une piste non de production. --android-release-status / PLAY_STORE_RELEASE_STATUS lorsque vous avez besoin d'un statut différent de completed.

Cela nécessite la même configuration de compte Google Play que la voie d'upload normale (PLAY_CONFIG_JSON en CI ou enregistrer les informations de connexion Android localement). --store-release-name est utilisé comme le compte Google Play version_name. --store-release-notes est le changelog Play par défaut, et chaque --store-release-notes-locale "locale=notes" entrée écrit un changelog Play localisé pour cette locale. Capgo envoie la mise en production Play comme completed sauf si vous le remplacez --android-release-status; si la publication gérée est activée dans le console Play, Google peut toujours attendre votre publication manuelle après l'approbation.

Continuez de la section Android Builds

Si vous utilisez Android Builds planer l'automatisation CI/CD, le connecter avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs, Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations, Intégration CI/CD pour les détails d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour les détails d'implémentation dans GitHub Intégration d'actions.