Builds iOS
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Compilez et soumettez vos applications iOS à TestFlight et à l’App Store grâce à l’infrastructure Mac dédiée de Capgo.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Vous apprendrez à envoyer votre app via Capgo Native Build
- Vous apprendrez à configurer les certificats pour Capgo Native Build
Prerequisites
Section intitulée « Prérequis »- Un compte Capgo (un essai gratuit suffit pour commencer)
- Votre app déjà enregistrée dans Capgo (exécutez
bunx @capgo/cli@latest app addsinon) - Aucun Mac requis : Capgo Build compile et signe votre app iOS dans le cloud, vous pouvez donc le faire depuis macOS, Windows ou Linux
- Un compte Apple Developer valide (99 $/an) (vous devez disposer des droits d'administrateur ou de propriétaire sur le compte Apple Developer)
- Votre app doit compiler sans erreur (dans Xcode en local, ou avec Capgo Build)
- Une app Capacitor
- Une icône configurée pour l'app. Les apps sans icône ne peuvent pas être envoyées sur l'App Store.
Avant de commencer sur les portails Apple
Section intitulée « Avant de commencer sur les portails Apple »Avant de configurer des certificats ou de déclencher votre premier upload TestFlight, assurez-vous que le compte Apple et l’équipe sont prêts :
- Activez l'authentification à deux facteurs pour le compte Apple utilisé lors de l'inscription
- Choisissez le bon type d’adhésion :
- Individuel / Entrepreneur individuel: votre nom légal devient le nom du vendeur sur l'App Store
- Organisation: nécessite une entité juridique, un numéro D-U-N-S, un site web public de l'entreprise, une adresse e-mail professionnelle sur le domaine de l'entreprise et une personne habilitée à engager l'organisation dans les accords d'Apple
- Utilisez un compte ayant accès à la fois à Apple Developer et App Store Connect pour les certificats, les fiches d'application, les clés API et TestFlight
- Fixez votre bundle ID final dès le début. Le modifier plus tard implique généralement de refaire toute la configuration sur l'App Store
- Préparez ces éléments App Store Connect avant l'App Review : URL de support, URL de politique de confidentialité, classification d'âge, captures d'écran, conformité à l'exportation et coordonnées pour l'App Review
Le premier build manuel
Section intitulée « Le premier build manuel »Avant de commencer à compiler l’application avec Capgo, il faut d’abord la configurer et effectuer un premier build TestFlight manuellement. Il y a plusieurs avantages à faire un build manuel en premier :
- Vous installerez le certificat de distribution sur votre machine locale
- Vous créerez l’enregistrement App Store si vous ne l’avez pas encore fait
- Vous pourrez identifier les éventuels problèmes du processus de build liés à votre application code
Avant de commencer, le certificat de distribution doit être installé sur votre machine locale. C’est assez complexe, mais je vous l’explique ci-dessous.
Configuration du certificat de distribution
Section intitulée « Configuration du certificat de distribution »-
Ouvrez Xcode
-
Cliquez sur
Xcode->Settings...Vous pouvez également utiliser le raccourciCmd + ,
-
Accéder à
Accounts
-
Trouvez le compte Apple associé au compte Apple Developer

-
Trouvez l’équipe que vous utiliserez pour déployer l’application

-
Cliquez sur
Manage Certificates...bouton
-
Vérifiez que le certificat de distribution apparaît dans la liste

-
Sinon, vous devez créer un nouveau certificat
- Cliquez sur
+bouton, puis surApple Distribution
- Le certificat sera créé automatiquement. Vous pouvez le voir dans la liste. Consultez l'étape précédente pour confirmer qu'il est bien visible.
- Cliquez sur
Maintenant que le certificat de distribution est installé, vous pouvez lancer le build.
Build manuel vers TestFlight
Section intitulée « Build manuel vers TestFlight »-
Ouvrir l’application dans Xcode
Exécutez
bunx cap open iospour ouvrir l’application dans Xcode. -
Trouver et cliquer sur
archiveboutonDans la barre d’outils Xcode, trouver et cliquer sur
product->archive.
-
Attendre la fin du build
-
Cliquez sur
Distribute Appbouton
-
Sélectionnez
TestFlight Internal Onlycomme méthode de distribution, puis cliquez surDistributebouton
-
Configurer la fiche de l’application
Remplissez les champs suivants :
- Nom : le nom de votre application – visible sur l’App Store
- SKU – le SKU de votre application – sert à identifier votre application sur l’App Store
- Langue principale – la langue principale de votre application
Ensuite, cliquez sur
nextbouton
-
Si la création de l’enregistrement de l’app échoue, fermez la fenêtre puis essayez d’archiver l’app à nouveau.
-
Attendez la fin de l’upload
-
Si tout s’est bien passé, vous devriez voir l’écran suivant

-
Cliquez sur
Donebouton
Vous pourriez croire que tout est en ordre et que votre app est déjà visible dans TestFlight, mais il reste quelques étapes à finaliser :
- Ajoutez-vous à TestFlight
- Complétez la conformité à l’exportation pour que le build soit testable
- Fill in required App Store Connect metadata such as your support URL, privacy policy URL, and age rating
- Préparez des captures d’écran adaptées aux appareils que vous prenez en charge
- Ajoutez les coordonnées du contact App Review et les identifiants de test avant la soumission en production
Commençons par le premier point :
Ajouter votre compte à TestFlight
Section intitulée « Ajouter votre compte à TestFlight »-
Allez sur la App Store Connect page

-
Connectez-vous avec votre compte Apple Developer
-
Sélectionnez l’équipe utilisée lors de la création de l’enregistrement de l’application. Si vous n’êtes membre que d’un seul compte développeur, vous pouvez ignorer cette étape.

-
Cliquez sur
Appsbouton
-
Trouvez l’application créée à l’étape précédente et cliquez dessus

-
Cliquez sur
TestFlightbouton
-
Cliquez sur
Internal Testers plusbouton
-
Créer un nouveau groupe
J’aime nommer le groupe « internal ». Vous pouvez lui donner le nom que vous voulez.

-
Cliquez sur
Invite testersbouton
-
Vous ajouter au groupe
Trouvez-vous dans la liste et cochez la case à côté de votre nom. (Vous devrez peut-être actualiser la page pour vous voir) Ensuite, cliquez sur
Add.
-
Vérifier que vous avez été ajouté au groupe
Vous devriez maintenant vous voir dans le groupe.

Félicitations 🎉 Vous vous êtes ajouté à TestFlight. Il ne reste qu’une dernière étape à effectuer avant de pouvoir configurer Capgo Native Build.
Configurer les informations de conformité
Section intitulée « Configurer les informations de conformité »Vous devez désormais attester auprès d’Apple que votre application n’utilise aucun chiffrement non standard (comme un algorithme personnalisé). Si votre application utilise un tel chiffrement, je vous conseille de lire la documentation Apple sur la manière de gérer ce cas. Il existe deux approches :
- Vous pouvez le faire manuellement à chaque build de votre application.
- Vous pouvez configurer votre fichier plist pour définir automatiquement cette valeur sur
false.
Commençons par la première :
-
Suivez toutes les étapes de la section précédente pour trouver la section TestFlight dans App Store Connect
-
Cliquez sur
Builds -> iOS
-
Trouvez le build dont les informations de conformité manquent et cliquez sur
Manage
-
Sélectionnez l’option qui décrit le mieux votre application
Pour moi, c’est
none, mais cela peut être différent pour vous. Ensuite, cliquez sur Enregistrer
-
Votre application devrait maintenant afficher
ready to test
Quant au second, voici les étapes :
-
Ouvrez le
Info.plistfichier -
Ajoutez la clé suivante :
<key>ITSAppUsesNonExemptEncryption</key><false/> -
Enregistrer le fichier
Installer l’application TestFlight et accepter l’invitation
Section intitulée « Installer l’application TestFlight et accepter l’invitation »Vous êtes PRESQUE prêt à tester votre application dans TestFlight. Avant cela, vous devez effectuer les étapes suivantes :
- Téléchargez le App TestFlight depuis l’App Store sur votre appareil iOS/iPadOS
- Accepter l’invitation pour tester votre application
Je ne vais pas détailler l’installation de l’application TestFlight sur votre appareil. Si vous ne savez pas comment installer une application, Google propose d’excellents guides pour le faire.
Pour accepter l’invitation, vous recevrez un e-mail d’Apple contenant un lien pour l’accepter.
-
Ouvrir l’e-mail d’Apple contenant le lien pour accepter l’invitation
-
Cliquez sur
View in TestFlightbouton
-
Cliquez sur
Installbouton
-
Installer l’application sur votre appareil
Si vous avez déjà installé l'app via Xcode, l'écran suivant peut s'afficher. Veuillez cliquer sur le
install.
-
Attendez que l'app s'installe
-
Cliquez sur
Openbouton et cliquez dessus
Félicitations 🎉 Vous avez accepté l'invitation pour tester votre app sur TestFlight. Vous pouvez maintenant configurer Capgo Native Build pour compiler et soumettre votre app à TestFlight.
Configuration de Capgo Native Build
Section intitulée « Configuration de Capgo Native Build »Quelques éléments sont à configurer dans Capgo Native Build pour pouvoir compiler et soumettre votre app à TestFlight. Voici la liste des éléments à transmettre à Capgo CLI :
| Paramètre | Description |
|---|---|
--platform | La plateforme cible (ios) |
--apple-team-id | Votre Apple Developer Team ID (à trouver dans Portail Apple Developer) |
--apple-key | Chemin vers votre fichier de clé API App Store Connect (.p8 fichier) |
--apple-key-id | L'ID de votre clé API App Store Connect |
--apple-issuer-id | Votre Issuer ID App Store Connect |
--certificate | Chemin vers votre certificat de distribution (.p12 fichier) |
--ios-provisioning-profile | Mapping du profil de provisionnement (bundleId=path ou simplement le chemin pour un profil unique) |
Exemple de commande :
bunx @capgo/cli@latest build credentials save \ --platform ios \ --apple-team-id YOUR_TEAM_ID \ --apple-key '/path/to/AuthKey_XXXXX.p8' \ --apple-key-id YOUR_KEY_ID \ --apple-issuer-id YOUR_ISSUER_ID \ --certificate '/path/to/certificate.p12' \ --ios-provisioning-profile '/path/to/profile.mobileprovision'ID d'équipe
Section intitulée « Team ID »Commençons par le team ID. Il est assez facile à trouver.
-
Accéder à Compte Apple Developer et faire défiler vers le bas
-
Trouvez le
Team ID
clé Apple, Apple key ID et Apple issuer ID
Section intitulée « Clé Apple, ID de clé Apple et ID d’émetteur Apple »Passons maintenant à la clé Apple.
-
Sélectionnez la bonne équipe dans le menu déroulant
- Cliquez sur votre nom en haut à droite
- Cliquez sur l'équipe que vous souhaitez utiliser

-
Cliquez sur
Integrationsbouton
-
Trouvez le
issuerCliquez sur
copybouton pour copier l’éditeur
-
Cliquez sur le bouton plus

-
Définissez le nom de la clé et accordez l’accès à
App manageret cliquez surGeneratebouton
-
Enregistrez l’ID de la clé

-
Téléchargez la clé


Félicitations 🎉 Vous avez créé la clé Apple, l’ID de clé Apple et l’ID d’émetteur Apple.
Certificat
Section intitulée « Certificate »Vous êtes maintenant prêt à exporter le certificat. Comme vous vous en souvenez, l’une des premières étapes de ce guide consistait à configurer le certificat de distribution.
Cependant, Apple, dans sa sagesse infinie, a décidé que la façon d’exporter le certificat est assez différente de la façon de le créer 🙃 Passons à la configuration :
-
Ouvrir Keychain Access
- Cliquez
Command + Spacepour ouvrir la barre de recherche - Recherchez
Keychain Access - Cliquez sur
Keychain Accessmanifeste
- Cliquez
-
Sélectionnez l’
logincatégorie et cliquez surMy Certificatesbouton
-
Trouvez votre certificat dans la liste
Le certificat doit s’appeler
Apple Distribution: [Your Name/Company] (your team ID)
-
Clic droit sur le certificat, puis sélectionner
Export
-
Enregistrer le certificat au format
.p12fichier- Pensez à choisir un nom de fichier de certificat approprié
- Vérifiez que le format du fichier est défini sur
Personal Information Exchange (.p12) - Cliquez sur
Savebouton

-
Lorsqu’on vous demande le mot de passe, vous pouvez :
- Passer le mot de passe (recommandé pour la simplicité) : Cliquez
OKsans saisir de mot de passe - Définir un mot de passe : si vous préférez protéger votre certificat avec un mot de passe, vous pouvez en définir un ici. Les fichiers
.p12les fichiers sont entièrement pris en charge par le Capgo CLI - il suffit de fournir le mot de passe à l'aide de--p12-passwordlors de l’exécution de la commande de configuration.

- Passer le mot de passe (recommandé pour la simplicité) : Cliquez
-
When asked for the “login keychain password”, give the password you use to login to your Mac
Saisissez le mot de passe que vous utilisez pour vous connecter à votre Mac. Puis, cliquez sur
Allow.
Félicitations 🎉 Vous avez exporté le certificat.
Profil de provisionnement
Section intitulée « Profil de provisionnement »Vous êtes maintenant prêt à exporter le profil de provisionnement. Je vous le promets, c’est la dernière chose qu’il vous faudra récupérer auprès d’Apple.
-
Accéder à Profils de développeur Apple
-
Sélectionnez la bonne équipe dans le menu déroulant
- Cliquez sur votre nom en haut à droite
- Cliquez sur l'équipe que vous souhaitez utiliser

-
Vérifiez que vous êtes sur la bonne page Elle doit ressembler à ceci, sinon cliquez sur
profilesdans la barre latérale
-
Cliquez sur
+bouton
-
Sélectionnez le type de profil Sélectionner
App Store Connectet cliquez surContinuebouton
-
Sélectionnez l'app que vous souhaitez compiler
Trouvez votre app dans le menu déroulant et cliquez sur
Continuebouton
-
Sélectionnez le certificat de distribution correct
Sélectionnez le certificat exporté à l’étape précédente et cliquez sur
Continuebouton
Si vous ne savez pas quel certificat sélectionner, revenez à Keychain Access et trouvez le certificat que vous avez exporté. Puis vérifiez la date d’expiration.

-
Nommez le profil
Donnez un nom au profil et cliquez sur
Generatebouton
-
Télécharger le profil
Cliquez sur
Downloadbouton pour télécharger le profil
Félicitations 🎉 Vous avez maintenant tout ce qu'il faut pour configurer Capgo Native Build.
Exécuter la commande de configuration
Section intitulée « Exécuter la commande de configuration »C’est fait ! Vous disposez désormais de tout ce qu’il faut pour configurer Capgo Native Build.
La commande à exécuter est la suivante :
bunx @capgo/cli@latest build credentials save \ --platform ios \ --apple-team-id UVTJ336J2D \ --apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \ --apple-key-id 66FGQZB566 \ --apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \ --certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \ --ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovisionSi tout s'est bien passé, vous verrez la sortie suivante :

Configuration CI/CD (GitHub Actions)
Section intitulée « Configuration CI/CD (GitHub Actions) »Si vous avez déjà terminé ID d'équipe, clé Apple, Apple key ID et Apple issuer ID, Certificat, et Profil de provisionnement, vous avez déjà tout ce qu'il faut pour la CI/CD.\nCette section explique uniquement comment passer ces valeurs en tant que secrets GitHub Actions et variables d'environnement.
1) Convertir les fichiers d'identifiants en base64 sur une seule ligne
Section intitulée « 1) Convertir les fichiers d’identifiants en base64 sur une seule ligne »# Distribution certificate (.p12)base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt
# Provisioning profile (.mobileprovision)base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt
# App Store Connect API key (.p8)base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt2) Créer des secrets de dépôt
Section intitulée « 2) Créer des secrets de dépôt »Dans GitHub > Repository > Settings > Secrets and variables > Actions, ajoutez :
| Nom du secret | Valeur |
|---|---|
CAPGO_TOKEN | Votre token Capgo API |
APP_STORE_CONNECT_TEAM_ID | Team ID de ID d'équipe |
APPLE_KEY_ID | Key ID de clé Apple, Apple key ID et Apple issuer ID |
APPLE_ISSUER_ID | Issuer ID de clé Apple, Apple key ID et Apple issuer ID |
BUILD_CERTIFICATE_BASE64 | Contenu de certificate_base64.txt |
CAPGO_IOS_PROVISIONING_MAP | Généré par CLI — copiez depuis .capgo-credentials fichier |
APPLE_KEY_CONTENT | Contenu de apple_key_base64.txt |
P12_PASSWORD (facultatif) | Votre .p12 mot de passe défini lors de l’export |
3) Utilisez des variables d'env dans votre workflow GitHub Actions
Section intitulée « 3) Utilisez des variables d'env dans votre workflow GitHub Actions »name: iOS Cloud Build
on: workflow_dispatch: push: branches: [main]
jobs: ios-build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v6 - uses: oven-sh/setup-bun@v2 with: bun-version: latest - name: Request iOS build with Capgo run: bunx @capgo/cli@latest build request --platform ios env: CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }} APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }} APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }} APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }} BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }} CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }} APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }} P12_PASSWORD: ${{ secrets.P12_PASSWORD }}Lancement du build
Section intitulée « Exécuter le build »Vous êtes maintenant prêt à lancer votre premier build.
Exécutez la commande suivante pour compiler votre application :
bunx @capgo/cli@latest build request --platform iosFélicitations 🎉 À ce stade, vous avez compilé votre application avec succès et elle est prête à être soumise à l’App Store.
Soumettre à la validation de l’App Store
Section intitulée « Soumettre à la revue de l’App Store »Le parcours de build App Store standard envoie le build à App Store Connect/TestFlight. Si votre release CI doit également joindre le build TestFlight traité à la version App Store et la soumettre à la revue App, passez --submit-to-store-review avec un build de release :
npx @capgo/cli@latest build request com.example.app \ --platform ios \ --build-mode release \ --ios-distribution app_store \ --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" \ --no-ios-automatic-releaseCela nécessite les identifiants de la clé API d’App Store Connect (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, et APP_STORE_CONNECT_TEAM_ID). App-specific password uploads and ad_hoc distribution ne peuvent pas soumettre un build pour examen. --store-release-name est la version App Store ; si elle est omise, Capgo lit MARKETING_VERSION depuis le projet Xcode. --store-release-notes est le texte « Nouveautés » de l’App Store par défaut, et chaque --store-release-notes-locale "locale=notes" entrée peut le remplacer pour une localisation de store. Utilisez --ios-automatic-release pour publier automatiquement après approbation d’Apple, ou --no-ios-automatic-release d’attendre une release manuelle. --ios-testflight-groups reste disponible pour la distribution bêta externe, mais n’est pas requis pour la soumission de revue sur l’App Store.
Mode de distribution Ad-Hoc
Section intitulée « Mode de distribution Ad-Hoc »Par défaut, Capgo compile les apps iOS pour la distribution sur l’App Store (TestFlight + App Store). Si vous avez besoin de builds ad-hoc (pour des tests internes ou la collecte d’artefacts CI), vous pouvez utiliser le --ios-distribution flag.
Quand utiliser le mode ad-hoc
Section intitulée « Quand utiliser le mode ad-hoc »- Vous souhaitez distribuer des IPA directement aux appareils enregistrés (sans TestFlight)
- Vous n'avez pas de clé API App Store Connect ou vous ne souhaitez pas en utiliser
- Vous voulez récupérer les artefacts de build via
--output-uploadsans soumettre à l'App Store
Prérequis
Section intitulée « Prérequis »Les builds ad-hoc ont moins de prérequis que les builds App Store :
| Identifiant | Obligatoire ? |
|---|---|
Certificat de distribution (.p12) | Oui |
Profil de provisionnement Ad-hoc (.mobileprovision) | Oui |
ID d’équipe (--apple-team-id) | Oui |
Clé API App Store Connect (.p8) | Non |
| ID de clé Apple / ID d’émetteur | Non |
Créer un profil de provisionnement ad-hoc
Section intitulée « Créer un profil de provisionnement ad-hoc »Suivez les mêmes étapes que Profil de provisionnement, mais à l’étape 5, sélectionnez Ad Hoc au lieu de App Store:
- Accéder à Profils Apple Developer
- Cliquez sur les
+bouton - Sélectionnez Ad Hoc et cliquez sur Continuer
- Sélectionnez votre application et votre certificat de distribution
- Sélectionnez les appareils à enregistrer
- Nommer et télécharger le profil
Enregistrement des identifiants ad-hoc
Section intitulée « Enregistrement des identifiants ad-hoc »bunx @capgo/cli@latest build credentials save \ --platform ios \ --ios-distribution ad_hoc \ --apple-team-id YOUR_TEAM_ID \ --certificate './certificate.p12' \ --ios-provisioning-profile './adhoc_profile.mobileprovision'Non --apple-key, --apple-key-id, ou --apple-issuer-id nécessaire.
Exécuter un build ad-hoc
Section intitulée « Exécuter un build ad-hoc »bunx @capgo/cli@latest build request \ --platform ios \ --ios-distribution ad_hocPour collecter l’IPA en tant qu’artefact de build, ajoutez --output-upload:
bunx @capgo/cli@latest build request \ --platform ios \ --ios-distribution ad_hoc \ --output-uploadCI/CD avec des builds ad-hoc
Section intitulée « CI/CD avec des builds ad hoc »Pour les Actions GitHub, il faut moins de secrets que pour les builds App Store :
name: iOS Ad-Hoc Build
on: workflow_dispatch:
jobs: ios-adhoc: runs-on: ubuntu-latest steps: - uses: actions/checkout@v6 - uses: oven-sh/setup-bun@v2 with: bun-version: latest - name: Request iOS ad-hoc build run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload env: CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }} APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }} BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }} CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }} CAPGO_IOS_DISTRIBUTION: ad_hocApplications avec extensions (signature multi-target)
Section intitulée « Applications avec extensions (signature multi-cible) »Si votre application inclut des extensions (extensions de partage, widgets, extensions de service de notification, etc.), chaque cible d’extension a besoin de son propre profil de provisionnement. Capgo prend en charge cette fonctionnalité via le --ios-provisioning-profile répétable.
Exemple : App + Share Extension
Section intitulée « Exemple : application + extension de partage »bunx @capgo/cli@latest build credentials save \ --platform ios \ --apple-team-id YOUR_TEAM_ID \ --apple-key '/path/to/AuthKey_XXXXX.p8' \ --apple-key-id YOUR_KEY_ID \ --apple-issuer-id YOUR_ISSUER_ID \ --certificate '/path/to/certificate.p12' \ --ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \ --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"Chaque --ios-provisioning-profile flag associe un ID de bundle à son fichier de profil de provisionnement. Le CLI :
- Lit chaque fichier mobileprovision
- Extrait automatiquement le nom du profil depuis le plist intégré
- Encode le fichier en Base64
- Stocke le tout sous forme d'un seul
CAPGO_IOS_PROVISIONING_MAPcredential
Migration depuis un profil unique
Section intitulée « Migration depuis un profil unique »Si vous utilisiez auparavant BUILD_PROVISION_PROFILE_BASE64 (un profil unique), lancez :
bunx @capgo/cli@latest build credentials migrate --platform iosCela convertit vos identifiants existants à profil unique vers le nouveau CAPGO_IOS_PROVISIONING_MAP format et supprime les clés obsolètes (BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).
Après la migration, ajoutez des profils d'extension avec la update commande (fusion additive) :
bunx @capgo/cli@latest build credentials update \ --platform ios \ --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"Troubleshooting
Section intitulée « Dépannage »Le profil de provisionnement n’inclut pas la capacité XYZ.
Section intitulée « Le profil de provisionnement n’inclut pas la capacité XYZ. »Il arrive que vous rencontriez l'erreur suivante :
Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"Cela se produit parce que vous avez activé une nouvelle capacité après la création du profil de provisionnement. L'ancien profil de provisionnement ne prend pas encore en compte cette nouvelle capacité.
Pour corriger cela, vous devez régénérer le profil de provisionnement.
- Ouvrez Portail Apple Developer
- Sélectionnez la bonne équipe dans le menu déroulant

- Cliquez sur
Profilesbouton
- Trouvez le profil de provisionnement à régénérer

- Cliquez sur
Editbouton
- Cliquez sur
Savebouton
- Cliquez sur
Downloadbouton
- Relancez la commande de configuration Capgo Native Build avec le profil nouvellement téléchargé.
Cela devrait résoudre le problème.
Autres problèmes
Section intitulée « Autres problèmes »Si vous rencontrez des problèmes avec Capgo Native Build, la configuration des identifiants ou la compilation de l’application, n’hésitez pas à nous contacter via notre support.
Continuer avec les builds iOS
Section intitulée « Continuer à partir des builds iOS »Si vous utilisez Builds iOS pour planifier l'automatisation CI/CD, et le connecter avec CI/CD Capgo pour le workflow produit dans le CI/CD de Capgo, Capgo Native Build pour le workflow produit dans les Native Builds de Capgo, Intégrations Capgo pour le workflow produit dans les intégrations de Capgo, Intégration CI/CD pour le détail d'implémentation dans l'intégration CI/CD, et Intégration GitHub Actions pour les détails d'implémentation de l'intégration GitHub Actions.