Android Builds

Créez et soumettez des applications Android sur Google Play Store en utilisant 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

Je vais utiliser 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 à la main. L'inscription de Capgo crée et configure vos clés de signature Android (keystore + compte de service Google) pour vous — c'est le chemin recommandé :

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

La procédure guidée manuelle suivante est réservée aux utilisateurs qui préfèrent configurer les informations d'identification 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 effectuer la première construction Android par la main. Il existe quelques avantages à effectuer une construction manuelle en premier lieu :

• Vous préparerez les informations d'identification pour la construction ultérieure de Capgo
• Vous créerez un enregistrement sur le Console de Magasin Play

Construire l'application manuellement avec Android Studio

Avant de pouvoir commencer à construire l'application avec Capgo, nous avons besoin de 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électionnez Android App Bundle et cliquez sur Next

Création d'un clé de stockage

Actuellement, vous manquez du fichier 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 faire cela en utilisant la ligne de commande, mais nous ne le couvrirons pas dans ce tutoriel.

1. Cliquez sur Create new

2. Remplissez le chemin du magasin de clés

   Attention

   Ceci DOIT ÊTRE SAUVEGARDÉ - il 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 la clé de magasin et la clé d'alias.

   Attention

   Ceci __CAPGO_KEEP_0__ - il sera utilisé plus tard

4. Remplir le reste du formulaire

   1. Conserver l'alias de la clé 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 coffre-fort ont été correctement remplis et cliquez sur Next

2. Sélectionnez le release Dans Android Studio, sélectionnez la variante de build de version de production Create

3. Dans Android Studio, après le build réussi

   1. Cliquez sur le
   2. bouton - cela ouvrira l'explorateur de fichiers et vous devriez voir le build là. locate Assurez-vous de pouvoir voir le build dans l'explorateur de fichiers

4. Dans Android Studio, assurez-vous de pouvoir voir le build 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. Sélectionnez la catégorie de l'application et si l'application est payante ou gratuite

6. Acceptez les conditions et les termes

   Attention

   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 réellement l'application pour tout le monde sur le Play Store, j'aurai besoin de créer un groupe de test interne.

Remarque

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

Si votre compte développeur est un compte personnel créé après le 13 novembre 2023, la mise en production 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. Console de Google Play Console de mise en production interne internal testing Cliquez sur Test and release -> Testing -> Internal testing

   

2. Cliquez sur Testers

3. Nommez la liste email Create email list

4. __CAPGO_KEEP_1__

5. Ajouter les adresses email des testeurs

6. Appuyez sur Enter et cliquez sur Save

7. Cliquez sur Create group

8. Vérifiez 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 de la console de Google Play des sorties

3. Console de Google Play créer une nouvelle sortie Create new release

4. Console de Google Play télécharger Upload

5. Console de Google Play 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

   Personnellement, à cette étape, je vois cette erreur

   

   Cela se produit parce que je n'ai pas 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. Vérifiez que l'application est publiée

12. Obtenez 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. Aller à 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 Play Store »

6. Installer l'application

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

   Attention

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

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

Maintenant, vous êtes prêt à démarrer la configuration de la mise en œuvre native de Capgo. Félicitations !

Exigence	Drapeau	Description	Requis
Fichier de clé de stockage	--keystore <path>	Chemin vers votre .jks/.keystore fichier utilisé pour signer l'APK/AAB.	Oui
Alias de clé du coffre-fort	--keystore-alias <alias>	Nom d'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 pour la clé. Si les mots de passe de la clé et du magasin correspondent, vous pouvez fournir uniquement un.	Regardez la note ci-dessous
Mot de passe du magasin de clés	--keystore-store-password <password>	Mot de passe pour le magasin de clés. Si les mots de passe de la clé et du magasin correspondent, vous pouvez fournir uniquement un.	Regardez la note ci-dessous
Compte de service Google Play	--play-config <path>	Fichier JSON de compte de service pour les téléchargements sur le 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 clés et les mots de passe de stockage sont identiques, fournissez uniquement l'un des deux --keystore-key-password ou --keystore-store-password.

Clé de stockage, mot de passe de stockage, mot de passe clé de stockage, alias 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 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 DEVEZ pour être le propriétaire du Compte Développeur. Sinon, vous 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 par là.

1. Allez à Console de Google Cloud

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. Clicsons sur la barre de recherche et recherchons pour service accounts et cliquez dessus

5. Clicsons sur Create service account

6. Remplissez le formulaire pour le 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 nouveau compte de service créé Vous devriez maintenant voir le nouveau compte de service créé dans la liste. Cliquez dessus.

   Note

   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

    En cliquant 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 Serait utilisé plus tard. Téléchargez le fichier JSON Le fichier JSON devrait avoir été téléchargé automatiquement. Vous pouvez cliquer sur

11. pour fermer la fenêtre. close Clé de téléchargement de Google Console

Section intitulée « Accorder à l'application Play Store API l'accès au compte de service »

The newly created service account does not yet have access to the Play Store API. To grant it, head to the Play Store Console.

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. 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 ensuite.
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 à sauvegarder les informations d'identification et à exécuter votre première build.

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

CI/CD setup (GitHub Actions)

Section intitulée « Configuration CI/CD (Actions __CAPGO_KEEP_0__) » Si vous avez déjà terminé 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, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

, vous avez déjà tout ce qu'il vous faut pour la CI/CD. Cette section ne couvre que la façon de passer ces valeurs en tant que secrets et variables d'environnement __CAPGO_KEEP_0__ Actions.

# 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 à une ligne. tr -d '\n' supprime les sauts de ligne de la sortie base64.

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

Dans GitHub > Repository > Settings > Secrets and variables > ActionsAjoutez :

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

Remarque

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

3) Utilisez les variables d'environnement dans votre 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

Avec cette configuration, la 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 lancera le processus de construction 🍾🥂

Soumettre la version de Play pour examen

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

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --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"

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

Continuez de la section « Continuez de la construction d'Android »

Si vous utilisez Construction d'Android pour planifier l'automatisation de CI/CD, connectez-le avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Construction native pour le flux de travail du produit dans Capgo Construction native, Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations, Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Actions Intégration pour le détail d'implémentation dans GitHub Actions Intégration.