Aller au contenu

Builds iOS

Compilez et soumettez vos applications iOS à TestFlight et à l’App Store grâce à l’infrastructure Mac dédiée de Capgo.

  • Vous apprendrez à envoyer votre app via Capgo Native Build
  • Vous apprendrez à configurer les certificats pour Capgo Native Build
  • Un compte Capgo (un essai gratuit suffit pour commencer)
  • Votre app déjà enregistrée dans Capgo (exécutez bunx @capgo/cli@latest app add sinon)
  • 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 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
Commencer l'inscription à Apple Developer Continuer l'inscription Apple sur le web Sélectionnez le bon type d’entité Apple Developer App Store Connect après l’inscription

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.

  1. Ouvrez Xcode

  2. Cliquez sur Xcode -> Settings... Vous pouvez également utiliser le raccourci Cmd + ,

    Paramètres Xcode

  3. Accéder à Accounts Onglet Comptes de Xcode

  4. Trouvez le compte Apple associé au compte Apple Developer Compte Apple sélectionné dans Xcode

  5. Trouvez l’équipe que vous utiliserez pour déployer l’application Xcode : trouver l’équipe

  6. Cliquez sur Manage Certificates... bouton Gérer les certificats dans Xcode

  7. Vérifiez que le certificat de distribution apparaît dans la liste Certificat de distribution Xcode

  8. Sinon, vous devez créer un nouveau certificat

    1. Cliquez sur + bouton, puis sur Apple Distribution Ajouter un certificat dans Xcode
    2. 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.

Maintenant que le certificat de distribution est installé, vous pouvez lancer le build.

  1. Ouvrir l’application dans Xcode

    Exécutez bunx cap open ios pour ouvrir l’application dans Xcode.

  2. Trouver et cliquer sur archive bouton

    Dans la barre d’outils Xcode, trouver et cliquer sur product -> archive .

    barre d’outils Xcode

  3. Attendre la fin du build

  4. Cliquez sur Distribute App bouton

    bouton Distribuer de Xcode

  5. Sélectionnez TestFlight Internal Only comme méthode de distribution, puis cliquez sur Distribute bouton

    méthode de distribution TestFlight interne uniquement via Xcode

  6. Configurer la fiche de l’application

    Remplissez les champs suivants :

    1. Nom : le nom de votre application – visible sur l’App Store
    2. SKU – le SKU de votre application – sert à identifier votre application sur l’App Store
    3. Langue principale – la langue principale de votre application

    Ensuite, cliquez sur next bouton

    Xcode TestFlight configure enregistrement d’application

  7. Si la création de l’enregistrement de l’app échoue, fermez la fenêtre puis essayez d’archiver l’app à nouveau.

  8. Attendez la fin de l’upload

  9. Si tout s’est bien passé, vous devriez voir l’écran suivant Xcode TestFlight : upload terminé

  10. Cliquez sur Done bouton

Vous pourriez croire que tout est en ordre et que votre app est déjà visible dans TestFlight, mais il reste quelques étapes à finaliser :

  1. Ajoutez-vous à TestFlight
  2. Complétez la conformité à l’exportation pour que le build soit testable
  3. Fill in required App Store Connect metadata such as your support URL, privacy policy URL, and age rating
  4. Préparez des captures d’écran adaptées aux appareils que vous prenez en charge
  5. Ajoutez les coordonnées du contact App Review et les identifiants de test avant la soumission en production

Commençons par le premier point :

  1. Allez sur la App Store Connect page Page de connexion App Store Connect

  2. Connectez-vous avec votre compte Apple Developer

  3. 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. Sélection de l’équipe App Store Connect

  4. Cliquez sur Apps bouton Bouton « Apps » d’App Store Connect

  5. Trouvez l’application créée à l’étape précédente et cliquez dessus Sélection de l’application dans App Store Connect

  6. Cliquez sur TestFlight bouton Bouton TestFlight d’App Store Connect

  7. Cliquez sur Internal Testers plus bouton Bouton « + » pour les testeurs internes dans App Store Connect

  8. Créer un nouveau groupe

    J’aime nommer le groupe « internal ». Vous pouvez lui donner le nom que vous voulez.

    Créer un nouveau groupe dans App Store Connect

  9. Cliquez sur Invite testers bouton Bouton Inviter des testeurs dans App Store Connect

  10. 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 .

    Case à cocher pour inviter un testeur dans App Store Connect

  11. Vérifier que vous avez été ajouté au groupe

    Vous devriez maintenant vous voir dans le groupe.

    Vérifier le tester dans App Store Connect

Félicitations 🎉 Vous vous êtes ajouté à TestFlight. Il ne reste qu’une dernière étape à effectuer avant de pouvoir configurer Capgo Native Build.

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 :

  1. Vous pouvez le faire manuellement à chaque build de votre application.
  2. Vous pouvez configurer votre fichier plist pour définir automatiquement cette valeur sur false.

Commençons par la première :

  1. Suivez toutes les étapes de la section précédente pour trouver la section TestFlight dans App Store Connect

  2. Cliquez sur Builds -> iOS Bouton iOS dans les builds App Store Connect

  3. Trouvez le build dont les informations de conformité manquent et cliquez sur Manage Gérer le build dans App Store Connect

  4. 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

    Enregistrer les informations de conformité dans App Store Connect

  5. Votre application devrait maintenant afficher ready to test

    Prêt à tester dans App Store Connect

Quant au second, voici les étapes :

  1. Ouvrez le Info.plist fichier

  2. Ajoutez la clé suivante :

    <key>ITSAppUsesNonExemptEncryption</key>
    <false/>
  3. 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 :

  1. Téléchargez le App TestFlight depuis l’App Store sur votre appareil iOS/iPadOS
  2. 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.

  1. Ouvrir l’e-mail d’Apple contenant le lien pour accepter l’invitation

  2. Cliquez sur View in TestFlight bouton Bouton dans l’e-mail TestFlight

  3. Cliquez sur Install bouton Bouton d’installation TestFlight

  4. 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 . Installer l'app TestFlight

  5. Attendez que l'app s'installe

  6. Cliquez sur Open bouton 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.

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ètreDescription
--platformLa plateforme cible (ios)
--apple-team-idVotre Apple Developer Team ID (à trouver dans Portail Apple Developer)
--apple-keyChemin vers votre fichier de clé API App Store Connect (.p8 fichier)
--apple-key-idL'ID de votre clé API App Store Connect
--apple-issuer-idVotre Issuer ID App Store Connect
--certificateChemin vers votre certificat de distribution (.p12 fichier)
--ios-provisioning-profileMapping du profil de provisionnement (bundleId=path ou simplement le chemin pour un profil unique)

Exemple de commande :

Fenêtre de terminal
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'

Commençons par le team ID. Il est assez facile à trouver.

  1. Accéder à Compte Apple Developer et faire défiler vers le bas

  2. Trouvez le Team ID

    Emplacement du Team ID dans le compte développeur

Passons maintenant à la clé Apple.

  1. Accéder à Page Utilisateurs et accès d’App Store Connect

  2. Sélectionnez la bonne équipe dans le menu déroulant

    1. Cliquez sur votre nom en haut à droite
    2. Cliquez sur l'équipe que vous souhaitez utiliser Sélection de l'équipe pour les clés Apple Developer
  3. Cliquez sur Integrations bouton Bouton des intégrations App Store Connect

  4. Trouvez le issuer

    Cliquez sur copy bouton pour copier l’éditeur copier l’éditeur dans App Store Connect

  5. Cliquez sur le bouton plus bouton d’ajout de clé dans App Store Connect

  6. Définissez le nom de la clé et accordez l’accès à App manager et cliquez sur Generate bouton Nom de la clé dans App Store Connect, accès en tant que gestionnaire d’app et bouton Générer

  7. Enregistrez l’ID de la clé

    Copiez l’ID de la clé dans App Store Connect

  8. Téléchargez la clé

    Clé de téléchargement App Store Connect

    App Store Connect download key warning

Félicitations 🎉 Vous avez créé la clé Apple, l’ID de clé Apple et l’ID d’émetteur Apple.

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 :

  1. Ouvrir Keychain Access

    1. Cliquez Command + Space pour ouvrir la barre de recherche
    2. Recherchez Keychain Access
    3. Cliquez sur Keychain Access manifeste
  2. Sélectionnez l’ login catégorie et cliquez sur My Certificates bouton catégorie Connexion de Keychain Access

  3. Trouvez votre certificat dans la liste

    Le certificat doit s’appeler Apple Distribution: [Your Name/Company] (your team ID) Trouver le certificat dans Keychain Access

  4. Clic droit sur le certificat, puis sélectionner Export Exporter le certificat depuis Keychain Access

  5. Enregistrer le certificat au format .p12 fichier

    1. Pensez à choisir un nom de fichier de certificat approprié
    2. Vérifiez que le format du fichier est défini sur Personal Information Exchange (.p12)
    3. Cliquez sur Save bouton

    Keychain Access save certificate dialog

  6. Lorsqu’on vous demande le mot de passe, vous pouvez :

    • Passer le mot de passe (recommandé pour la simplicité) : Cliquez OK sans 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 .p12 les fichiers sont entièrement pris en charge par le Capgo CLI - il suffit de fournir le mot de passe à l'aide de --p12-password lors de l’exécution de la commande de configuration.

    Keychain Access save certificate password dialog

  7. 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 .

    Keychain Access enregistrer certificat clé de connexion mot de passe

Félicitations 🎉 Vous avez exporté le certificat.

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.

  1. Accéder à Profils de développeur Apple

  2. Sélectionnez la bonne équipe dans le menu déroulant

    1. Cliquez sur votre nom en haut à droite
    2. Cliquez sur l'équipe que vous souhaitez utiliser Sélection de l'équipe pour les clés Apple Developer
  3. Vérifiez que vous êtes sur la bonne page Elle doit ressembler à ceci, sinon cliquez sur profiles dans la barre latérale

    Page des profils Apple Developer

  4. Cliquez sur + bouton Bouton d'ajout de profil Apple Developer

  5. Sélectionnez le type de profil Sélectionner App Store Connect et cliquez sur Continue bouton

    Sélection du type de profil sur Apple Developer

  6. Sélectionnez l'app que vous souhaitez compiler

    Trouvez votre app dans le menu déroulant et cliquez sur Continue bouton

    Sélection de l'app sur Apple Developer

  7. Sélectionnez le certificat de distribution correct

    Sélectionnez le certificat exporté à l’étape précédente et cliquez sur Continue bouton

    Apple Developer : sélection du certificat de distribution

    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.

    Apple Developer : date d’expiration du certificat de distribution

  8. Nommez le profil

    Donnez un nom au profil et cliquez sur Generate bouton

    Nom du profil Apple Developer

  9. Télécharger le profil

    Cliquez sur Download bouton pour télécharger le profil

    Télécharger le profil Apple Developer

Félicitations 🎉 Vous avez maintenant tout ce qu'il faut pour configurer Capgo Native Build.

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 :

Fenêtre de terminal
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.mobileprovision

Si tout s'est bien passé, vous verrez la sortie suivante :

Capgo CLI sortie de credentials save

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 »
Fenêtre de terminal
# 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.txt

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

Nom du secretValeur
CAPGO_TOKENVotre token Capgo API
APP_STORE_CONNECT_TEAM_IDTeam ID de ID d'équipe
APPLE_KEY_IDKey ID de clé Apple, Apple key ID et Apple issuer ID
APPLE_ISSUER_IDIssuer ID de clé Apple, Apple key ID et Apple issuer ID
BUILD_CERTIFICATE_BASE64Contenu de certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAPGénéré par CLI — copiez depuis .capgo-credentials fichier
APPLE_KEY_CONTENTContenu 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 »
.github/workflows/ios-build.yml
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 }}

Vous êtes maintenant prêt à lancer votre premier build.

Exécutez la commande suivante pour compiler votre application :

Fenêtre de terminal
bunx @capgo/cli@latest build request --platform ios

Fé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 :

Fenêtre de terminal
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-release

Cela 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.

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.

  • 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-upload sans soumettre à l'App Store

Les builds ad-hoc ont moins de prérequis que les builds App Store :

IdentifiantObligatoire ?
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’émetteurNon

Suivez les mêmes étapes que Profil de provisionnement, mais à l’étape 5, sélectionnez Ad Hoc au lieu de App Store:

  1. Accéder à Profils Apple Developer
  2. Cliquez sur les + bouton
  3. Sélectionnez Ad Hoc et cliquez sur Continuer
  4. Sélectionnez votre application et votre certificat de distribution
  5. Sélectionnez les appareils à enregistrer
  6. Nommer et télécharger le profil
Fenêtre de terminal
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.

Fenêtre de terminal
bunx @capgo/cli@latest build request \
--platform ios \
--ios-distribution ad_hoc

Pour collecter l’IPA en tant qu’artefact de build, ajoutez --output-upload:

Fenêtre de terminal
bunx @capgo/cli@latest build request \
--platform ios \
--ios-distribution ad_hoc \
--output-upload

Pour les Actions GitHub, il faut moins de secrets que pour les builds App Store :

.github/workflows/ios-adhoc-build.yml
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_hoc

Applications 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.

Fenêtre de terminal
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 :

  1. Lit chaque fichier mobileprovision
  2. Extrait automatiquement le nom du profil depuis le plist intégré
  3. Encode le fichier en Base64
  4. Stocke le tout sous forme d'un seul CAPGO_IOS_PROVISIONING_MAP credential

Si vous utilisiez auparavant BUILD_PROVISION_PROFILE_BASE64 (un profil unique), lancez :

Fenêtre de terminal
bunx @capgo/cli@latest build credentials migrate --platform ios

Cela 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) :

Fenêtre de terminal
bunx @capgo/cli@latest build credentials update \
--platform ios \
--ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

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.

  1. Ouvrez Portail Apple Developer
  2. Sélectionnez la bonne équipe dans le menu déroulant Sélection de l'équipe pour les clés Apple Developer
  3. Cliquez sur Profiles bouton Bouton Profils Apple Developer
  4. Trouvez le profil de provisionnement à régénérer Rechercher un profil sur Apple Developer
  5. Cliquez sur Edit bouton Modifier un profil sur Apple Developer
  6. Cliquez sur Save bouton Profil de sauvegarde Apple Developer
  7. Cliquez sur Download bouton Télécharger le profil Apple Developer
  8. Relancez la commande de configuration Capgo Native Build avec le profil nouvellement téléchargé.

Cela devrait résoudre le problème.

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.

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.