Constructions Android

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

Ce que vous allez apprendre

• Vous allez apprendre à télécharger votre application via Capgo Native build
• Vous allez apprendre à 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

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

La première construction manuelle

Vous préparerez les informations d'identification pour la construction ultérieure avec Capgo

• You will prepare the credentials for the later Capgo build
• La construction de l'application manuellement avec Android Studio

Vous préparerez les informations d'identification pour la construction ultérieure avec __CAPGO_KEEP_0__

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 une clé de stockage

Actuellement, vous manquez le fichier de clés. Ce fichier est utilisé pour signer votre application, ce qui permet à Google de savoir que c'est vous qui avez développé 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. Remplissez le chemin de la clé de magasin

   Attention

   Ceci Il doit être sauvegardé - cela sera utilisé plus tard

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 le Key Store et le Key Alias.

   Attention

   Ceci SAUVEGARDER CECI - il sera utilisé plus tard

4. Remplir le reste du formulaire

   1. Conserver le Key Alias tel quel (key0)
   2. Remplir 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 que la construction réussit, vous devriez voir l'écran suivant

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

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

Section intitulée “Créer l'application sur le console de Play Store”

1. Console de Google Play Sélectionnez le compte de développeur correct

2. Console de Google Play sélectionnez le compte de développeur correct

3. Console de Google Play créez l'application Create app

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

5. Sélectionnez la catégorie de l'application et si elle 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éez le 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 le Play Store, 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 Play 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 devrez toujours avoir un test fermé avec au moins 12 testeurs optés pour 14 jours consécutifs avant la production. Allez à Cliquez sur

1. Console de test interne de Google Play internal testing Cliquez sur Test and release -> Testing -> Internal testing

   

2. Now that you have created the app, you can create an internal testing group. Since I won’t actually publish the app for everyone on Play Store, I will need to create an internal testing group. Testers

3. Cliquez sur Create email list

4. Nommez la liste d'emails

5. Ajoutez les adresses email des testeurs

6. Appuyez sur Entrée 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é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 construit manuellement avec Android Studio. Si ce fichier ne utilise pas le même coffre-fort que celui que vous utiliserez pour la construction Capgo, la construction Native Capgo ne réussira pas.

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

   

   Cela se produit car 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. Assurez-vous que l'application soit publiée

12. Accepter l'invitation du groupe de test interne

Vérifiez que l'application est publiée sur Google Play Console

Une fois que vous avez téléchargé l'application dans le groupe de test interne, vous pouvez accepter l'invitation du 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. Confirmez que l'invitation a été acceptée et cliquez sur « télécharger sur Google Play »

6. Installez l'application

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

   Attention

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

Configuration de Capgo Build natif (Android)

Vous êtes maintenant prêt à démarrer 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 coffre-fort	--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>	Mot de passe de la clé. Si les mots de passe de la clé et du coffre-fort correspondent, vous pouvez fournir uniquement un.	Consultez la note ci-dessous
Mot de passe du coffre-fort	--keystore-store-password <password>	Mot de passe du coffre-fort. Si les mots de passe de la clé et du coffre-fort correspondent, vous pouvez fournir uniquement un.	Consultez la note ci-dessous
Compte de service Google Play	--play-config <path>	Fichier JSON de service pour les téléchargements sur Play Store.	Oui

bunx @capgo/cli 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

Remarque

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

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

Si vous avez suivi les instructions de construction manuelle, vous devriez déjà avoir généré la 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 PlaySi les mots de passe de la clé et du magasin sont identiques, fournissez uniquement l'un d'eux __CAPGO_KEEP_0__

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

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 DEVEZ être le propriétaire du Compte de développeur. Sinon, vous ne serez pas en mesure de configurer le compte de service.
• Vous devrez créer un nouveau projet Cloud Google (séparé de votre compte Google Play)

Commencez.

1. Allez à Console de Cloud 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 Create
   3. Assurez-vous d'être sur le bon projet

4. Clicsons sur la barre de recherche et recherchons service accounts et cliquez dessus

5. Cliquez sur Create service account

6. Remplissez le formulaire du compte de service et cliquez 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. Cliquez sur le compte de service créé récemment Vous devriez maintenant voir le compte de service créé récemment dans la liste. Cliquez dessus.

   Remarque

   Copiez cette adresse e-mail également, 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 sera utilisé plus tard.

11. Téléchargez 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 lui accorder cela, 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 :
   • 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 par la suite.
7. Cliquez sur Invite user
8. Confirmez l'invitation
9. Confirmez que l'utilisateur a été invité

Enregistrement des 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 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à terminé Clé de stockage, mot de passe de la clé de stockage, mot de passe du clé de stockage, alias de la clé de stockage et compte de service Google Play, vous 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 en tant que secrets d'actions GitHub et variables d'environnement.

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

Conseil

Les secrets GitHub doivent être des valeurs sur une ligne. tr -d '\n' supprime les sauts de ligne de la sortie base64.

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	Alias de clé de coffre-fort depuis Coffre-fort, mot de passe de coffre-fort, mot de passe de clé de coffre-fort, alias de clé de coffre-fort
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 d'eux KEYSTORE_KEY_PASSWORD ou KEYSTORE_STORE_PASSWORD.

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

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 ${{ 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, la CI envoie les informations d'identification par l'intermédiaire 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 build com.example.app --platform android

Et cela lancera le processus de construction 🍾🥂