Constructions Android

Créez et soumettez des applications Android sur 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

Prerequisites

• 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

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

Recommandé : l'inscription automatique

Vous n'avez pas besoin de faire tout cela manuellement. L'inscription de Capgo crée et configure vos clés de signature Android (keystore + compte de service Google Play) pour vous — c'est la voie recommandée :

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

The manual walkthrough below is only for those who prefer to set up credentials themselves, or want to understand exactly what Capgo does under the hood.

La première construction manuelle

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first Android build by hand. There are some advantages to doing a manual build first:

• Vous préparerez les informations d'identification pour la prochaine mise à jour Capgo.
• Vous créerez un enregistrement sur le Console de Magasin Google Play.

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 Ouvrir le projet Android Studio.

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

3. Select Android App Bundle Sélectionner Next

Créer un coffre-fort de clés

Vous manquez actuellement du 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 fichier de clé de stockage

   Attention

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

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

   Remarque

   Il est recommandé d'utiliser le même mot de passe pour le Key Store et le Key Alias.

   Prudence

   Ceci C'EST À SAVOIR POUR PLUS TARD - il sera utilisé ultérieurement

4. Remplissez le reste du formulaire

   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 les remplir avec vos propres détails.

   

5. Cliquez sur OK

Terminer la construction manuelle

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

2. Sélectionnez la release variante de construction et cliquez sur Create

3. Après que la construction réussisse, vous devriez voir l'écran suivant

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

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

Créer l'application sur le Console de Google Play

1. Allez à Console de Google Play

2. Sélectionnez le compte développeur correct

3. Cliquez sur Create app

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

5. Select the app category and if the app is paid or free

6. Accepter les conditions et les termes

   Prudence

   Assurez-vous de lire les conditions et les termes 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 l'application pour tout le monde sur Google Play, je devrai créer un groupe de test interne.

Note

Le test interne est toujours la méthode la plus rapide pour tester votre build distribué sur Play avant une véritable mise en production.

Si votre compte développeur est un compte personnel créé après le 13 novembre 2023, les tests internes ne sont pas disponibles. Allez à replace the closed-testing requirement for production access. You will still need a closed test with at least 12 opted-in testers for 14 consecutive days before production.

1. Allez à internal testing Test interne 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 e-mail des testeurs

6. Appuyez sur Enter et cliquez sur Save

7. Cliquez sur Create group

8. S'assurez que la nouvelle liste est sélectionnée et cliquez sur Save

Télécharger 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 créé manuellement avec Android Studio. Si ce fichier ne utilise pas le même coffre-fort que celui que vous utiliserez pour la Capgo build, la Capgo Build Native échouera.

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

7. Cliquez sur Next

8. Réparez les erreurs

   Personnellement, à cette étape, je vois cette erreur

   

   C'est 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. Confirmer la publication

11. S'assurer que l'application est publiée

12. Obtenir votre nom temporaire d'application

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 le navigateur et cliquez sur Accept

5. Confirmez que l'invitation a été acceptée et cliquez sur « téléchargez-le sur Google Play »

6. Installez 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 s'est 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.

Configurer la construction native Capgo (Android)

Maintenant, vous êtes prêts à commencer la configuration de Capgo Build natif. Félicitations !

Requis	Drapeau	Description	Obligatoire
Fichier de clé de signature	--keystore <path>	Chemin vers votre .jks/.keystore fichier utilisé pour signer le fichier APK/AAB.	Oui
Alias du clé	--keystore-alias <alias>	Alias du nom de la clé à l'intérieur du coffre-fort.	Oui
Mot de passe de la clé	--keystore-key-password <password>	Mot de passe de la clé. Si les mots de passe de la clé et du magasin correspondent, vous pouvez fournir un seul.	Consultez la note ci-dessous
Mot de passe du coffre-fort	--keystore-store-password <password>	Mot de passe du coffre. Si les mots de passe de la clé et du coffre sont identiques, vous pouvez fournir un seul.	Consultez la note ci-dessous
Compte de service Google Play	--play-config <path>	JSON service account file for Play Store uploads.	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 clé et de magasin sont identiques, fournissez seulement l'un d'eux. --keystore-key-password ou --keystore-store-password.

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

Si vous avez suivi les étapes instructions de construction manuelleVous 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 points suivants :

• Vous NEED NEED propriétaire du Compte DéveloppeurVous ne pourrez pas configurer le compte de service.
• Vous devrez créer un nouveau projet Google Cloud (séparé de votre compte Google Play).

Commencez.

1. Commencez. Google Cloud Console

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 du 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 du 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 Clé

9. Cliquez sur Add Key et Create new key

10. Cliquez sur JSON et Create

    Attention

    En cliquant sur Create créera un nouveau clé et il 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 compte de service nouvellement créé n'a pas encore accès à Google Play API. Pour le lui accorder, rendez-vous sur le console de Google Play.

1. Allez à Console de Google 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 requises minimum :
   • En App permissions, accordez l'accès à votre application.
   • En 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éduire les permissions ensuite.
7. Cliquez sur Invite user
8. Confirmez l'invitation
9. Confirmez que l'utilisateur a été invité

Enregistrement des informations de connexion

You are now ready to save the credentials and run your first build. You can save the credentials using the following command:

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 stockage, mot de passe de clé de stockage, alias de stockage et Compte de service Google PlayVous avez déjà tout ce qu'il vous faut pour CI/CD. Cette section couvre uniquement la manière de passer ces valeurs en tant que secrets d'actions et variables d'environnement GitHub.

1) Convertir les fichiers de credenciaux en base64 sur 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

Tip

Les secrets GitHub doivent être des valeurs sur une ligne. tr -d '\n' 2) Créer des secrets de dépôt

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

En 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	Clé de la clé de cryptage Clé de coffre, mot de passe de coffre, mot de passe de clé de coffre, alias de coffre
KEYSTORE_KEY_PASSWORD	Mot de passe de clé de coffre-fort
KEYSTORE_STORE_PASSWORD	Mot de passe de coffre-fort
PLAY_CONFIG_JSON	Contenu de play_config_base64.txt

Note

Si les clés et les mots de passe de stockage sont les mêmes, vous pouvez fournir juste l'un des KEYSTORE_KEY_PASSWORD ou KEYSTORE_STORE_PASSWORD.

3) Use env vars in your GitHub Actions workflow

github/workflows/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

With this setup, CI sends credentials through environment variables only. You do not need to commit signing files or upload them as workflow artifacts.

Exécution de la construction

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

Exécuter :

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

Et cela lancera le processus de construction.

Soumettre la mise à jour de Play en revue

By default, Android release builds upload to Google Play and can remain inactive until you finish the release in Play Console. If your CI release should submit the Play release automatically, pass --submit-to-store-review Avec une mise en production :

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 sur la production suivi avec release_status: completed Lorsque vous ne définissez pas de suivi. Cela peut être mis en ligne pour 100% des utilisateurs. --android-track internal (ou alpha / beta— ou définir PLAY_STORE_TRACK en CI — pour conserver la version complétée sur un suivi non de production. Utiliser --android-release-status / PLAY_STORE_RELEASE_STATUS lorsque vous avez besoin d'un statut différent que completed.

Cela nécessite la même configuration de compte Google Play que la voie d'upload normale (PLAY_CONFIG_JSON en CI ou enregistrés localement les identifiants Android). --store-release-name est utilisé comme le Google Play version_name. --store-release-notes est le journal de changement Play par défaut, et chaque --store-release-notes-locale "locale=notes" L'entrée écrit un changelog Play localisé pour cette locale. Capgo envoie la mise à jour Play comme completed sauf si vous le surprenez --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 d'ici les builds Android

Si vous utilisez les builds Android pour planifier l'automatisation CI/CD, connectez-l’avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Bâtiments natifs pour le flux de travail du produit dans Capgo Bâtiments 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 l'intégration CI/CD, et GitHub Actions Integration pour les détails d'implémentation dans GitHub Intégration des Actions.