Builds iOS

Construisez et soumettez des applications iOS à TestFlight et à l'App Store à l'aide de l'infrastructure Mac 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 certificats pour Capgo Native Build

Prérequis

• Un compte Capgo (un essai gratuit suffit pour commencer)
• Votre application déjà enregistrée dans Capgo (exécutez bunx @capgo/cli@latest app add si ce n'est pas le cas)
• Avec un ordinateur Mac équipé d'Xcode (il est possible de configurer la construction sur une machine Linux/Windows, mais cela n'est pas encore documenté)
• Un compte développeur Apple valide (99 €/an) (Vous devez avoir des droits d'administrateur ou propriétaire sur le compte développeur Apple)
• Votre application doit pouvoir se construire avec succès via Xcode
• Une application Capacitor
• Un icône configuré pour l'application. Les applications sans icône ne peuvent pas être téléchargées sur l'App Store.

Note

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

Avant de commencer dans les portails d'Apple

Avant de commencer dans les portails d'Apple

• Activer l'authentification à deux facteurs pour le compte Apple utilisé pour l'inscription
• Choisissez le bon type de membership :
  • Individuel / Propriétaire unique: votre nom personnel 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 la société, un courrier électronique de travail sur le domaine de la société, et une personne ayant l'autorité de lier l'organisation aux accords d'Apple
• Utilisez un compte qui peut accéder à Apple Developer et à App Store Connect pour les certificats, les enregistrements d'applications, les clés API et TestFlight
• Fixez votre ID de bundle final tôt. La modification ultérieure le signifie généralement que vous devez rétablir la configuration de l'App Store
• Planifiez ces éléments App Store Connect avant la revue d'application : URL de support, URL de politique de confidentialité, note d'âge, captures d'écran, conformité à l'exportation et détails de contact pour la revue d'application

Note

Références officielles utiles :

• Devenez membre du programme Apple Developer
• Soumettez vos applications et jeux
• Informations sur la version du plateforme dans App Store Connect

Attention

Apple met régulièrement à jour ses exigences minimales de SDK. À partir du 28 avril 2026, les applications iPhone et iPad téléchargées sur App Store Connect doivent être construites avec le iOS et iPadOS 26 SDK ou ultérieur.

Recommandé : l'inscription automatique

Vous n'avez pas besoin de faire tout cela manuellement. L'inscription de Capgo crée et configure vos certificats de signature iOS (certificat de distribution + profil de provisioning) pour vous — c'est la voie recommandée :

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

La procédure manuelle suivante est réservée aux utilisateurs qui préfèrent configurer les certificats 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 une première mise en ligne TestFlight manuellement. Il existe quelques avantages à effectuer une construction manuelle en premier lieu:

• Vous créerez le certificat de distribution sur votre machine locale
• Vous créerez l'enregistrement de l'App Store si vous n'avez pas encore effectué cela
• Vous pourrez résoudre tout problème lié au processus de construction lié à votre application code

Avant de commencer, vous devez avoir le certificat de distribution installé sur votre machine locale. Cela est assez complexe, mais je vais l'expliquer ci-dessous.

Configuration du certificat de distribution

1. Ouvrez Xcode

2. Cliquez sur Xcode -> Settings... Alternativement, vous pouvez utiliser la raccourci Cmd + ,

   

3. Allez à Accounts

4. Trouvez le compte Apple ajouté au compte développeur Apple

5. Trouvez l'équipe que vous utiliserez pour déployer l'application

6. Cliquez sur le Manage Certificates... bouton

7. Assurez-vous de pouvoir voir le certificat de distribution dans la liste

8. Si vous ne le voyez pas, vous devez créer un nouveau certificat

   Note

   Apple limite le nombre de certificats de distribution que vous pouvez avoir à 3. Si vous avez plus de 3 certificats, vous devez supprimer un pour créer un nouveau. Je ne le couvrirai pas dans ce tutoriel.

   1. Cliquez sur le + Cliquez ensuite sur Apple Distribution
   2. Le certificat sera créé automatiquement. Vous pouvez le voir dans la liste. Consultez l'étape précédente pour vous assurer que vous le voyez.

Maintenant que vous avez installé le certificat de distribution, vous pouvez commencer le processus de build.

Build manuel vers TestFlight

1. Exécutez

   pour ouvrir l'application dans Xcode. bunx cap open ios Trouvez et cliquez sur le

2. bouton archive Dans la barre d'outils Xcode, trouvez et cliquez sur le

   bouton product -> archive bouton.

   

3. Attendez que la construction soit terminée

4. Cliquez sur le Distribute App bouton

   

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

   

6. Configurez l'enregistrement 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 - cet identifiant est utilisé pour identifier votre application sur l'App Store
   3. La langue principale - la langue principale de votre application

   Ensuite, cliquez sur le next bouton

   

7. Si la création de l'enregistrement de l'application échoue, essayez de fermer la fenêtre et de réessayer l'archivage de l'application.

8. Attendez la fin de l'upload

9. Si tout s'est bien passé, vous devriez voir l'écran suivant

10. Cliquez sur le Done bouton

Vous pensez peut-être que tout est bon maintenant et que vous pourrez voir votre application dans TestFlight maintenant, mais il reste encore quelques choses à terminer :

1. Ajoutez-vous à TestFlight
2. Complétez la conformité à l'exportation afin que la construction devienne testable
3. Remplissez les métadonnées requises d'App Store Connect, telles que votre URL de support, votre URL de politique de confidentialité et votre note d'âge
4. context: Page/zone : Page de solution exemple d'application. Rôle : Étiquette de navigation ou élément de l'interface utilisateur court. Vu dans : composant solutions/SolutionAppExample.astro. Clé de message `solution_app_examples_rating` (Note de notation des exemples d'applications).
5. Préparez des captures d'écran qui correspondent aux appareils que vous soutenez réellement

Ajoutez les coordonnées de contact de l'App Review et les informations de test avant la soumission de production

Commencez par le premier :

1. Section intitulée « Ajouter votre propre compte à TestFlight » Allez à la Page d'App Store Connect

2. Se connecter avec votre compte développeur Apple

3. Sélectionnez l'équipe que vous avez utilisée lors de la création du dossier d'application. Si vous n'avez qu'un seul compte développeur, vous pouvez passer cette étape.

4. Cliquez sur le bouton Apps Bouton d'applications d'App Store Connect

5. Sélection d'application d'App Store Connect

6. Bouton de testflight d'App Store Connect TestFlight button

7. Cliquez sur le bouton Internal Testers plus bouton

8. Créez un nouveau groupe

   J'aime nommer le groupe « internes ». Vous pouvez le nommer comme vous le souhaitez.

   

9. Cliquez sur Invite testers bouton

10. Ajoutez-vous au groupe

    Trouvez-vous dans la liste et sélectionnez la case à cocher à côté de votre nom. (Vous pouvez avoir besoin de rafraîchir la page pour vous voir) Ensuite, cliquez sur Add bouton.

    

11. Vérifiez que vous êtes ajouté au groupe

    Vous devriez maintenant vous voir dans le groupe.

    

Félicitations 🎉 Vous avez ajouté vous-même à TestFlight. Il ne vous reste plus qu'une chose à faire avant de pouvoir configurer Capgo Native Build.

Configuration des informations de conformité

Vous avez besoin maintenant de promettre à Apple que votre application ne utilise aucune cryptage non standard (comme un algorithme personnalisé). Si votre application utilise effectivement un cryptage non standard, je vous conseille de lire la documentation d'Apple sur la façon de gérer cela. Il existe deux façons de faire cela :

1. Vous pouvez faire cela manuellement chaque fois que vous construisez votre application.
2. Vous pouvez configurer votre fichier plist pour définir automatiquement cette valeur à false.

Commencez 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

3. Trouvez la build avec des informations de conformité manquantes et cliquez sur Manage

4. Sélectionnez l'option qui décrit le mieux votre application

   Pour moi, c'est nonemais cela pourrait être différent pour vous. Ensuite, cliquez sur Enregistrer

   

5. Votre application devrait maintenant dire ready to test

   

As pour la deuxième, voici les étapes :

1. Ouvrez le Info.plist Dossier

2. Ajoutez la clé suivante :

   <key>ITSAppUsesNonExemptEncryption</key>
   <false/>

3. Enregistrez le fichier

Remarque

Ici Voici la documentation officielle d'Apple sur la façon de vous informer d'Apple de votre conformité avec les réglementations d'exportation de cryptage.

Installer l'application TestFlight et accepter l'invitation

Maintenant, vous êtes ALMOST prêt à tester votre application sur TestFlight. Avant, vous devez faire les choses suivantes :

1. Téléchargez l'application TestFlight à partir de l'App Store sur votre appareil iOS/iPadOS
2. Acceptez l'invitation pour tester votre application

Je vais passer sous silence les détails sur la façon d'installer l'application TestFlight sur votre appareil. Si vous n'êtes pas sûr de savoir comment installer une application, Google propose de grandes guides pour vous aider.

Pour accepter l'invitation, vous recevrez un courrier électronique de l'Apple avec un lien pour accepter l'invitation.

1. Ouvrez le courrier électronique de l'Apple avec le lien pour accepter l'invitation

2. Cliquez sur View in TestFlight le bouton

3. Cliquez sur le Install bouton

4. Installez l'application sur votre appareil

   Si vous avez déjà installé l'application à l'aide de Xcode, vous pouvez voir l'écran suivant. Cliquez sur le install bouton.

5. Attendez que l'application soit installée

6. Cliquez sur le Open bouton et cliquez dessus

Félicitations ! Vous avez accepté l'invitation pour tester votre application dans TestFlight. Vous pouvez maintenant configurer Capgo Native Build pour construire et soumettre votre application à TestFlight.

Configuration de Capgo Build natif

Il existe quelques choses que vous devez configurer dans Capgo Build natif pour pouvoir construire et soumettre votre application à TestFlight. Voici une liste des choses que vous transmettrez au Capgo CLI:

Paramètre	Description
--platform	La plateforme à construire pour (ios)
--apple-team-id	Votre identifiant de développeur Apple (trouvé dans Portail du développeur Apple)
--apple-key	Chemin vers votre fichier de clé API App Store Connect (.p8 fichier)
--apple-key-id	L'ID de clé de votre clé API App Store Connect
--apple-issuer-id	Votre ID émetteur App Store Connect
--certificate	Chemin vers votre certificat de distribution (.p12 fichier)
--ios-provisioning-profile	Mappage du profil de provisionnement (bundleId=path ou juste 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

Commencez par l'ID d'équipe. La trouver est relativement facile.

1. Allez à Compte développeur Apple et descendez vers le bas

2. Trouvez l'emplacement de l'ID d'équipe dans le compte développeur Team ID

   

Section intitulée « ID de clé Apple, ID de clé Apple et ID émetteur Apple »

macOS : laissez __CAPGO_KEEP_0__ créer cette clé pour vous

macOS: let Capgo create this key for you

peut créer cette clé App Store Connect __CAPGO_KEEP_0__ pour vous. Choisissez capgo build init can create this App Store Connect API key for you. Choose et une fenêtre guidée s'ouvre sur App Store Connect, vous guidez à travers chaque étape et capturez automatiquement la clé, l'ID de clé et l'ID émetteur — sans copier-coller. Les étapes manuelles ci-dessous sont l'alternative (et le chemin sur Windows ou Linux). et descendez vers le bas

1. Allez à Page d'accès utilisateur et d'accès à App Store Connect

   Remarque

   Pour moi, le lien ne fonctionne parfois pas. Réchargez la page si cela ne fonctionne pas pour vous.

2. Sélectionnez l'équipe correcte dans le menu déroulant

   1. Cliquez sur votre nom dans le coin supérieur droit
   2. Cliquez sur l'équipe que vous souhaitez utiliser

3. Cliquez sur le Integrations bouton

4. Trouvez le issuer

   Attention

   Ceci SAUVEZ-LE, vous en aurez besoin plus tard Cliquez sur le bouton pour copier l'émetteur

   Copier l'émetteur App Store Connect copy Cliquez sur le bouton plus pour ajouter une clé

5. Définissez le nom de la clé et définissez l'accès à

6. App Store Connect App manager et cliquez sur le Generate bouton

7. Sauvegardez l'ID de la clé

   Attention

   Ceci DOIT ÊTRE SAUVEGARDÉ - vous en aurez besoin plus tard App Store Connect copiez l'ID de la clé

   

8. Attention

   Attention

   Ceci C'EST À SAVOIR - vous le devrez plus tard

   Danger

   NE JAMAIS PARTAGEZ LA CLÉ AVEC PERSONNE - L'UTILISEZ SEULEMENT DANS LE CAPGO CLI

   

   

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

Certificat

Maintenant, vous êtes prêt à exporter le certificat. Comme vous vous en souvenez, l'une des premières étapes de ce guide était la configuration du certificat de distribution.

Cependant, Apple, dans sa sagesse infinie, a décidé que la façon dont vous exportez le certificat est tout à fait différente de la façon dont vous les créez.

1. Ouvrez Keychain Access

   1. Cliquez Command + Space pour ouvrir la barre de recherche
   2. Recherchez Keychain Access
   3. Cliquez sur le Keychain Access démonstration d'ouverture de Keychain Access sur macOS

2. catégorie et cliquez sur le login bouton My Certificates l'application

3. Trouvez votre certificat dans la liste

   Le certificat doit s'appeler Apple Distribution: [Your Name/Company] (your team ID)

4. Cliquez avec le bouton droit sur le certificat et sélectionnez Export

5. Enregistrez le certificat sous forme de .p12 fichier

   Attention

   Ceci DOIT ÊTRE SAUVEGARDÉ - vous aurez besoin de cela plus tard

   1. Assurez-vous de sélectionner un bon nom pour le fichier de certificat
   2. Assurez-vous que le format de fichier est défini sur Personal Information Exchange (.p12)
   3. Cliquez sur le Save bouton

   

6. Lorsque vous êtes interrogé pour le mot de passe, vous pouvez soit :

   • Ignorer le mot de passe (recommandé pour la simplicité) : Cliquez OK sans entrer 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 le définir ici. Les fichiers protégés par mot de passe sont pleinement pris en charge par le __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - il suffit de fournir le mot de passe en utilisant l'option lors de la saisie de la commande de configuration. .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password option when running configuration command

   

7. Lorsque vous êtes interrogé pour le « mot de passe du keychain de connexion », entrez le mot de passe que vous utilisez pour vous connecter à votre Mac

   Entrez le mot de passe que vous utilisez pour vous connecter à votre Mac. Cliquez ensuite sur le bouton Allow bouton

   

Félicitations ! Vous avez exporté le certificat.

Profil de provisionnement

Vous êtes maintenant prêt à exporter le profil de provisionnement. Je vous le promets, c'est la dernière chose que vous aurez besoin de récupérer auprès d'Apple.

1. Allez à Profils développeurs Apple

2. Sélectionnez l'équipe correcte dans le menu déroulant

   1. Cliquez sur votre nom dans le coin supérieur droit
   2. Cliquez sur l'équipe que vous souhaitez utiliser

3. Assurez-vous d'être sur la bonne page Elle devrait ressembler à ceci, si ce n'est pas le cas, cliquez sur profiles dans le menu de navigation latéral

   

4. Cliquez sur le + bouton

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

   

6. Sélectionnez l'application que vous souhaitez construire

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

   

7. Sélectionnez le certificat de distribution correct

   Sélectionnez le certificat que vous avez exporté dans l'étape précédente et cliquez sur le Continue bouton

   

   Si vous êtes incertain du certificat à sélectionner, revenez à Keychain Access et trouvez le certificat que vous avez exporté. Regardez ensuite la date d'expiration.

   

8. Nommez le profil

   Donnez un nom au profil et cliquez sur le Generate bouton

   Conseil

   Le nom du profil est automatiquement extrait par le Capgo CLI — vous n'avez pas besoin de le rappeler.

   

9. Téléchargez le profil

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

   Attention

   Ce fichier DOIT ÊTRE SAUVEGARDÉ vous aurez besoin de cela plus tard

   

Félicitations ! Vous avez maintenant tout ce dont vous avez besoin pour configurer Capgo Native Build.

Attention

N'oubliez jamais de ne pas commiter les informations d'identification que vous venez de créer dans votre dépôt. Gardez-les en sécurité ! 🔒

Exécution de la commande de configuration

You have done it! You have now got everything you need to configure Capgo Native Build.

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

Remplacer les valeurs des placeholders

Remplacez les valeurs des placeholders ci-dessus par vos informations réelles d'identification Apple collectées dans les étapes précédentes :

• --apple-team-id : Votre ID d'équipe Apple
• --apple-key : Chemin vers votre fichier téléchargé .p8 fichier clé
• --apple-key-id : Votre ID de clé Apple
• --apple-issuer-id : Votre ID émetteur Apple
• --certificate : Chemin vers votre certificat exporté .p12 certificat
• --ios-provisioning-profile : Chemin vers votre fichier téléchargé .mobileprovision fichier (ID de bundle automatiquement inféré pour les profils uniques)

Si tout s'est bien passé, vous devriez voir le résultat suivant :

L'authentification Apple a échoué ? Synchronisez votre horloge

Si la clé Apple auth API ressemble correctement mais que l'authentification échoue toujours, synchronisez votre horloge informatique et réessayez. Capgo signe le JWT d'Apple avec votre temps système local, et Apple rejette les jetons qui expirent dans les 20 minutes à venir. Un horloge qui est seulement quelques secondes hors synchronisation peut suffire à échouer cette étape.

Consultez le guide de dépannage du constructeur pour les étapes de synchronisation de l'horloge.

Configuration CI/CD (GitHub Actions)

Si vous avez déjà complété ID d'équipe, Clé Apple, ID de clé Apple et ID émetteur Apple, Certificat, et Profil de provisionnement, 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 dont vous avez besoin pour CI/CD. Cette section ne couvre que la façon de passer ces valeurs sous forme de secrets d'actions __CAPGO_KEEP_0__ et de variables d'environnement.

# 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

Conseil

GitHub secrets devraient ê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 > Actions, ajoutez :

Nom du secret	Valeur
CAPGO_TOKEN	Votre jeton Capgo API
APP_STORE_CONNECT_TEAM_ID	ID d'équipe depuis ID d'équipe
APPLE_KEY_ID	ID de clé depuis Clé Apple, ID de clé Apple et ID émetteur Apple
APPLE_ISSUER_ID	ID émetteur depuis Clé Apple, ID de clé Apple et ID émetteur Apple
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 si défini lors de l'exportation

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

/github/flux de travail/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 }}

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 flux de travail.

Exécution de la construction

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

Exécutez la commande suivante pour construire votre application :

bunx @capgo/cli@latest build request --platform ios

Félicitations ! À ce stade, vous avez réussi à construire votre application et elle est prête à être soumise sur l'App Store.

Soumettre à la revue de l'App Store

La voie de construction normale de l'App Store envoie la construction vers App Store Connect/TestFlight. Si votre CI doit également attacher la construction traitée de TestFlight à la version de l'App Store et la soumettre pour la Revue d'App, passez --submit-to-store-review avec une construction de version :

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 clés de connexion d'App Store Connect API (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, et APP_STORE_CONNECT_TEAM_ID). Les mots de passe d'upload spécifiques à l'application et la distribution ne peuvent pas soumettre une construction pour la revue. ad_hoc est la version de l'App Store ; si omis, __CAPGO_KEEP_0__ lit --store-release-name is the App Store version; if omitted, Capgo reads MARKETING_VERSION with a release build: --store-release-notes est le texte de fallback App Store What’s New, et chaque --store-release-notes-locale "locale=notes" l'entrée peut le remplacer pour une localisation de magasin. Utilisez --ios-automatic-release pour libérer automatiquement après l'approbation d'Apple, ou --no-ios-automatic-release pour attendre une mise à jour manuelle. --ios-testflight-groups est toujours disponible pour la distribution bêta externe, mais il n'est pas requis pour la soumission de la revue de l'App Store.

Mode de distribution Ad-Hoc

Par défaut, Capgo construit des applications iOS pour la distribution sur l'App Store (TestFlight + App Store). Si vous avez besoin de builds ad-hoc au lieu de ceux-ci (pour des tests internes ou la collecte d'artefacts CI), vous pouvez utiliser la --ios-distribution Note

La distribution ad-hoc est

La distribution ad-hoc est utilisée pour la distribution d'applications iOS hors de l'App Store, mais toujours avec un certificat Apple valide. ne pas pas la même chose que la distribution Entreprise (Intégrée) . La distribution Entreprise nécessite un compte Apple Developer Entreprise séparé et utilise des profils de provisionnement différents. Capgo prend actuellement en charge app_store et ad_hoc modes uniquement.

Quand utiliser le mode ad-hoc

• Vous n'avez pas ou vous ne voulez pas utiliser une clé __CAPGO_KEEP_0__ App Store Connect
• You don’t have or don’t want to use an App Store Connect API key
• sans soumettre à l'App Store --output-upload Exigences

Quand utiliser le mode ad-hoc

Les builds ad-hoc ont moins de exigences que les builds de l'App Store :

Certificat	Est-ce que cela est requis ?
Certificat de distribution (.p12)	Oui
Profile de provisioning ad-hoc (.mobileprovision)	Oui
ID d'équipe (--apple-team-id)	Oui
Clé App Store Connect API (.p8)	Non
Clé ID Apple / ID émetteur	Non

Remarque

En ad_hoc mode, --apple-key, --apple-key-idet --apple-issuer-id ne sont pas pris en charge et sont ignorés. C'est pourquoi les deux lignes App Store Connect ci-dessus ne montrent pas les drapeaux CLI ad-hoc ; ces options s'appliquent uniquement app_store mode.

Prudence

Sans une clé API App Store Connect, le numéro de build utilise un fallback basé sur l'heure. Pour supprimer l'avertissement, passez --skip-build-number-bump.

Création d'un profil de provisioning ad-hoc

Suivez les mêmes étapes que Profil de provisionnementmais en 5e étape, sélectionnez Ad Hoc plutôt que App Store:

1. Allez à Profils Apple Developer
2. Cliquez sur + bouton
3. Sélectionner Ad Hoc Cliquez sur Continuer
4. Sélectionnez votre application et votre certificat de distribution
5. Sélectionnez les appareils que vous souhaitez enregistrer
6. Nommez et téléchargez le profil

Enregistrement des informations 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 une mise en ligne hors ligne

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:

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc \
  --output-upload

CI/CD avec des mises en ligne hors ligne

Pour les GitHub Actions, vous avez besoin de moins de secrets que les mises en ligne de l'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

Conseil

Notez que APPLE_KEY_ID, APPLE_ISSUER_ID, et APPLE_KEY_CONTENT ne sont pas nécessaires pour les builds ad-hoc.

Applications avec Extensions (Signature Multi-Cible)

Si votre application inclut des extensions (extensions de partage, widgets, extensions de services de notification, etc.), chaque cible d'extension nécessite son propre profil de provisioning. Capgo prend en charge cela via la flag répétitive. --ios-provisioning-profile Exemple : Application + Extension de partage

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"

Chacun --ios-provisioning-profile La drapeau cartographie un ID de bundle à son fichier de profil de mise en ligne. Le CLI:

1. Lit chaque fichier mobileprovision
2. Extrait automatiquement le nom du profil à partir du plist intégré
3. Encode en Base64 le fichier
4. Stocke tout cela sous forme de credenciaux CAPGO_IOS_PROVISIONING_MAP Conseil

Chaque

Vous avez besoin d'un certificat de distribution pour tous les cibles — seuls les profils de provisionnement diffèrent par cible.

Migration d'un profil unique

Si vous avez utilisé précédemment BUILD_PROVISION_PROFILE_BASE64 (profil unique), exécutez :

bunx @capgo/cli@latest build credentials migrate --platform ios

Cela convertit vos informations d'identification de profil unique existantes en format nouveau et supprime les clés legacy ( CAPGO_IOS_PROVISIONING_MAP Après la migration, ajoutez des profils d'extension avec la commande (fusion additive) :BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Fenêtre de terminal update Copier dans le presse-papier

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

Conseil

Utilisez update pas save) pour ajouter des profils aux informations d'identification existantes. La update commande fusionne les nouveaux profils avec les anciens. Utilisez save seulement lors de la configuration de toutes les informations d'identification à partir de zéro.

Résolution des problèmes

Le profil de mise en service ne comprend pas la capacité XYZ.

Parfois, vous pouvez voir l'erreur suivante :

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

Cela se produit car vous avez activé une nouvelle capacité après la création du profil de provisionnement. Le profil de provisionnement ancien ne comprend pas encore la nouvelle capacité.

Pour résoudre ce problème, vous devez régénérer le profil de provisionnement.

1. Ouvrir Portail du développeur Apple
2. Sélectionnez l'équipe correcte dans le menu déroulant
3. Cliquez sur le Profiles bouton
4. Trouvez le profil de provisionnement que vous souhaitez régénérer
5. Cliquez sur le Edit bouton
6. Cliquez sur le Save bouton
7. Cliquez sur le Download bouton
8. Exécutez à nouveau la commande de configuration de build Native Capgo avec le profil téléchargé récemment. Re-run the __CAPGO_KEEP_0__ Native Build setup command with the newly downloaded profile.

Cela devrait résoudre le problème.

Autres problèmes

Si, pour une raison quelconque, vous rencontrez des problèmes avec la construction native de Capgo, la configuration des informations d'identification ou la construction de l'application, n'hésitez pas à nous contacter via notre support.

Continuez d'ici les constructions iOS

Si vous utilisez Constructions iOS 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 produit dans Capgo Bâtiments natifs Capgo Intégrations pour le flux de produit dans Capgo Intégrations Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour le détail d'implémentation dans GitHub Intégration d'actions.