Compilazioni iOS

Crea e invia app iOS su TestFlight e App Store utilizzando l'infrastruttura Mac dedicata di Capgo.

Cosa imparerai

• Imparerai a caricare il tuo app tramite Capgo Native build
• Imparerai a configurare i certificati per Capgo Native Build

Requisiti preliminari

• Un account Capgo con una sottoscrizione attiva
• Il tuo app già registrata in Capgo (esegui bunx @capgo/cli@latest app add se non)
• Un computer Mac con Xcode installato (è possibile impostare la compilazione su una macchina Linux/Windows, ma non è ancora documentato)
• Un account di sviluppatore Apple valido (99€/anno) (Devi avere diritti di amministratore o proprietario sull'account di sviluppatore Apple)
• Il tuo app deve essere in grado di compilarsi con successo tramite Xcode
• Un app Capacitor
• Un'icona configurata per l'app. Gli app senza un'icona non possono essere caricate su App Store

Nota

Utilizzerò l'app seguente per il tutorial: https://github.com/Cap-go/capgo-native-build-tutorial-app

Prima di iniziare negli ambienti di Apple

Prima di configurare i certificati o di caricare il tuo primo upload di TestFlight, assicurati che l'account e il team Apple siano pronti:

• Attiva l'autenticazione a due fattori per l'account Apple utilizzato per l'iscrizione
• Scegli il tipo di abbonamento giusto:
  • Individuale / Proprietario unico: il tuo nome personale diventa il nome del venditore sull'App Store
  • Organizzazione: richiede un'entità legale, un numero D-U-N-S, un sito web aziendale pubblico, un indirizzo email di lavoro sul dominio della società e una persona con l'autorità di vincolare l'organizzazione agli accordi di Apple
• Usa un account che possa accedere sia a Apple Developer che a App Store Connect per i certificati, i record dell'app, le API chiavi e TestFlight
• Assicurati di fissare il tuo ID bundle finale presto. Cambiarlo in seguito significa di solito ricominciare la configurazione dell'App Store
• Pianifica questi elementi di App Store Connect prima della revisione dell'app: URL del supporto, URL della politica sulla privacy, età di valutazione, screenshot, conformità all'esportazione e dettagli di contatto per la revisione dell'app

Nota

Riferimenti ufficiali utili:

• Diventa membro del programma sviluppatori Apple
• Invia le tue app e i giochi
• Informazioni sulla versione del platform in App Store Connect

Attenzione

Aggiorna regolarmente il requisito minimo SDK. A partire dal 28 aprile 2026i dispositivi iPhone e iPad caricati su App Store Connect devono essere costruiti con il iOS e iPadOS 26 SDK o successivi.

La prima costruzione manuale

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first TestFlight build by hand. There are some advantages to doing a manual build first:

• Crea il record di App Store se non l'hai già fatto
• Potrai risolvere eventuali problemi con il processo di costruzione legati all'app __CAPGO_KEEP_0__
• You will be able to figure out any issues with the build process linked to your app code

The first manual build

Configurazione del certificato di distribuzione

1. Apri Xcode

2. Clicca su Xcode -> Settings... Alternativamente, puoi utilizzare la scorciatoia Cmd + ,

   

3. Vai a Accounts

4. Trova l'account Apple aggiunto all'account sviluppatore Apple

5. Trova il team che utilizzerai per distribuire l'app

6. Clicca sul Manage Certificates... tasto

7. Assicurati di poter vedere il certificato di distribuzione nella lista

8. Se non riesci a vederlo, devi creare un nuovo certificato

   Nota

   Apple limita il numero di certificati di distribuzione che puoi avere a 3. Se hai più di 3 certificati, devi eliminare uno per poter creare uno nuovo. Non coprirò questo argomento nel tutorial.

   1. Clicca sul + tasto e poi su Apple Distribution
   2. Il certificato verrà creato automaticamente. Puoi vederlo nella lista. Guarda il passaggio precedente per confermare che lo vedi.

Ora che hai installato il certificato di distribuzione, puoi iniziare il processo di build.

Costruzione manuale per TestFlight

1. Apri l'applicazione in Xcode

   Esegui bunx cap open ios per aprire l'applicazione in Xcode.

2. Trova e clicca sul archive bottoni

   Nella barra degli strumenti di Xcode, trova e clicca sul product -> archive bottoni.

   

3. Attendere la compilazione per completare

4. Clicca su Distribute App tasto

   

5. Seleziona TestFlight Internal Only come metodo di distribuzione e clicca su Distribute tasto

   

6. Configura il record dell'app

   Compila i seguenti campi:

   1. Nome: il nome della tua app - visibile nella App Store
   2. SKU - lo SKU della tua app - questo viene utilizzato per identificare la tua app nella App Store
   3. La lingua principale - la lingua principale dell'app

   Poi, clicca sul next button

   

7. Se la creazione del record dell'app fallisce, prova a chiudere la finestra e prova a creare l'archivio dell'app di nuovo.

8. Aspetta che l'upload sia completo

9. Se tutto è andato bene, dovresti vedere lo schermo seguente

10. Clicca sul Done button

Potresti pensare istintivamente che tutto sia andato bene e che potrai vedere l'app in TestFlight adesso, ma ci sono ancora alcune cose da finire:

1. Aggiungiti a TestFlight
2. Completa la conformità all'esportazione in modo che la costruzione diventi testabile
3. Inserisci i metadati obbligatori di App Store Connect, come il tuo URL di supporto, il tuo URL di politica sulla privacy e la tua classificazione di età
4. Prepara le schermate che corrispondono ai dispositivi che effettivamente supporti
5. Aggiungi i dettagli di contatto per la revisione App e qualsiasi credenziale di test prima della sottoscrizione di produzione

Iniziamo con il primo:

Aggiungiti a TestFlight

1. Vai al pagina di App Store Connect pagina di accesso a App Store Connect

2. Accedi con il tuo account di sviluppatore Apple

3. Seleziona l'equipe che hai utilizzato quando hai creato il record dell'applicazione. Se hai solo un account di sviluppatore, puoi saltare questo passaggio.

4. Clicca sul Apps tasto

5. Clicca sul

6. Selezione di App Store Connect per TestFlight TestFlight Clicca sul

7. Selezione dell'app di App Store Connect Internal Testers plus Selezione di App Store Connect per TestFlight

8. Crea un nuovo gruppo

   Mi piace chiamare il gruppo “interni”. Puoi chiamarlo come vuoi.

   

9. Clicca su Invite testers button

10. Aggiungiti al gruppo

    Trova te stesso nella lista e seleziona la casella accanto al tuo nome. (Potresti dover ricaricare la pagina per vederlo) Poi, clicca su il Add button per confermare.

    

11. Verifica di essere stato aggiunto al gruppo

    Ora dovresti vederti nel gruppo.

    

Congratulazioni 🎉 Hai aggiunto te stesso a TestFlight. Ora c'è solo una cosa in più che devi fare prima di poter configurare Capgo Native Build.

Impostazione delle informazioni sulla conformità

Ora hai bisogno di promettere a Apple che la tua app non utilizza alcuna crittografia non standard (come un algoritmo personalizzato). Se la tua app utilizza effettivamente alcuna crittografia non standard, ti consiglio di leggere il documentazione di Apple su come gestire questo.

1. Ci sono due modi per farlo:
2. Puoi farlo a mano ogni volta che costruisci l'app. false.

Puoi configurare il tuo file plist per impostare automaticamente questo valore su

1. Iniziamo con il primo: segui tutte le fasi della sezione precedente per trovare la sezione TestFlight in App Store Connect

2. Clicca su Builds -> iOS

3. Trova il build con informazioni di conformità mancanti e clicca su Manage

4. Seleziona l'opzione che meglio descrive il tuo app

   Per me, questo è nonema potrebbe essere diverso per te. Dopo, clicca su salva

   

5. Il tuo app dovrebbe ora dire ready to test

   

Per quanto riguarda il secondo, ecco i passaggi:

1. Apri il Info.plist file

2. Aggiungi la seguente chiave:

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

3. Salva il file

Nota

Qui Ecco la documentazione ufficiale di Apple su come informare Apple della propria conformità con le norme di esportazione di cifratura.

Installa l'app TestFlight e accetta l'invito

Ora sei CI SI STA AVVICINANDO pronto per testare il tuo app in TestFlight. Prima, devi fare le seguenti cose:

1. Scarica l'app TestFlight dall'App Store sul tuo dispositivo iOS/iPadOS
2. Accetta l'invito per testare il tuo app

Tralascerò i dettagli su come installare l'app TestFlight sul tuo dispositivo. Se non sei sicuro su come installare un'app, Google ha alcune guide fantastiche su come farlo.

Per quanto riguarda l'accettazione dell'invito, riceverai un'email da Apple con un link per accettare l'invito.

1. Apri l'email da Apple con il link per accettare l'invito

2. Clicca sul View in TestFlight button

3. Clicca sul Install button

4. Installa l'app sul tuo dispositivo

   Se hai già installato l'app utilizzando Xcode, potresti vedere lo schermo seguente. Per favore clicca sul install button.

5. Aspetta che l'app si installi

6. Clicca sul Open button e cliccalo

Congratulazioni 🎉 Hai accettato l'invito a testare l'app in TestFlight. Ora puoi configurare Capgo Native Build per costruire e inviare l'app a TestFlight.

Configurazione di Capgo Native Build

There are a few things you need to configure in Capgo Native Build to be able to build and submit your app to TestFlight. Here is a list of the things you will pass to the Capgo CLI:

Ecco una lista delle cose che passerai al __CAPGO_KEEP_1__ __CAPGO_KEEP_2__:	Parametro
--platform	Descrizioneios)
--apple-team-id	La piattaforma per costruire ( Il tuo ID di sviluppatore Apple (trovato in)
--apple-key	Path to your App Store Connect API Key file (.p8 Percorso del tuo file chiave App Store Connect __CAPGO_KEEP_0__ (
--apple-key-id	The Key ID of your App Store Connect API Key
--apple-issuer-id	L'ID chiave del tuo file chiave App Store Connect __CAPGO_KEEP_0__
--certificate	Il tuo ID emittente App Store Connect.p12 Percorso del tuo certificato di distribuzione (
--ios-provisioning-profile	Mappatura del profilo di provisioning (bundleId=path o semplicemente percorso per un profilo singolo)

Esempio di comando:

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 del team

Vai a

1. Account Apple Developer e scorri verso il basso Trova il

2. ID del team Team ID

   

Chiave Apple, ID chiave Apple e ID emittente Apple

Ora, passiamo alla chiave Apple.

1. Vai a Pagina di accesso dell'utente di App Store Connect

   Nota

   Per me il link non funziona a volte. Ricarica la pagina se non funziona per te.

2. Seleziona il team corretto dal menu a discesa

   1. Clicca sul tuo nome nell'angolo in alto a destra
   2. Clicca sul team che vuoi utilizzare

3. Clicca sul Integrations tasto

4. Trova il issuer

   Attenzione

   Questo DEVE ESSERE SALVATO - ne avrai bisogno in seguito

   Clicca sul copy tasto per copiare l'emittente

5. Clicca sul pulsante più

6. Imposta il nome della chiave e impostare l'accesso a App manager e clicca sul Generate pulsante

7. Salva l'ID della chiave

   Attenzione

   Questo DEVE ESSERE SALVATO - avrai bisogno di esso in seguito

   

8. Scarica la chiave

   Attenzione

   Questo DEVE ESSERE SALVATO - avrai bisogno di esso in seguito

   Pericolo

   NON CONDIVIDERE LA CHIAVE CON NESSUNO - USALA SOLO NEL CAPGO CLI

   

   

Congratulazioni 🎉 Hai creato la chiave Apple, l'ID chiave Apple e l'ID emittente Apple.

Certificato

Ora sei pronto per esportare il certificato. Come ricorderai, uno dei primi passaggi di questa guida era la configurazione del certificato di distribuzione.

Tuttavia, Apple, nella loro infinita saggezza, ha deciso che il modo in cui esportare il certificato è molto diverso da quello in cui crearli 🙃 Vediamo di impostarlo:

1. Apri Accesso alle chiavi

   1. Clicca Command + Space per aprire la barra di ricerca
   2. Cerca Keychain Access
   3. Clicca sul Keychain Access l'app

2. Seleziona la login categoria e clicca sul My Certificates bottoni

3. Trova il tuo certificato nella lista

   Il certificato dovrebbe essere denominato Apple Distribution: [Your Name/Company] (your team ID)

4. Fai clic destro sul certificato e seleziona Export

5. Salva il certificato come un .p12 file

   Attenzione

   Assicurati di __CAPGO_KEEP_0__ DA SALVARE - avrai bisogno di esso in seguito

   1. Assicurati di selezionare un nome adatto per il file del certificato
   2. Assicurati che il formato del file sia impostato su Personal Information Exchange (.p12)
   3. Clicca sul Save button

   

6. Quando ti viene chiesto la password, puoi scegliere:

   • Saltare la password (consigliato per semplicità): Clicca OK senza dover inserire una password
   • Imposta una password: se preferisci proteggere il tuo certificato con una password, puoi impostarla qui. Certificati protetti da password .p12 i file sono pienamente supportati dal Capgo CLI - basta fornire la password utilizzando --p12-password l'opzione quando si esegue il comando di configurazione.

   

7. Quando ti viene chiesto la “password della chiave di accesso di login”, inserisci la password che utilizzi per accedere al tuo Mac

   Inserisci la password che utilizzi per accedere al tuo Mac. Poi, clicca sul Allow tasto.

   

Congratulazioni 🎉 Hai esportato il certificato.

Profilo di provisioning

Ora, sei pronto per esportare il profilo di provisioning. Ti prometto, questo è l'ultima cosa che dovrai ottenere da Apple.

1. Vai a Profili sviluppatori Apple

2. Seleziona il team corretto nella casella a discesa

   1. Clicca sul tuo nome nell'angolo in alto a destra
   2. Clicca sul team che desideri utilizzare

3. Assicurati di essere sulla pagina corretta Dovrebbe avere questo aspetto, se non clicca su profiles in il menu a discesa

   

4. Clicca sul + bottoni

5. Seleziona il tipo di profilo Seleziona App Store Connect e clicca sul Continue bottoni

   

6. Seleziona l'app che desideri costruire

   Trova l'app nel menu a discesa e clicca sul Continue bottoni

   

7. Seleziona il certificato di distribuzione corretto

   Seleziona il certificato che hai esportato nel passaggio precedente e clicca sul Continue bottoni

   

   Se sei incerto sul certificato da selezionare, torna a Keychain Access e trova il certificato che hai esportato. Poi guarda la data di scadenza.

   

8. Nomi il profilo

   Dai un nome al profilo e clicca sul Generate button

   Suggerimento

   Il nome del profilo viene estratto automaticamente da Capgo CLI — non hai bisogno di ricordarlo.

   

9. Scarica il profilo

   Clicca sul Download tasto per scaricare il profilo

   Attenzione

   Questo file DEVE ESSERE SALVATO - lo avrete bisogno in seguito

   

Congratulazioni 🎉 Ora avete tutto ciò di cui avete bisogno per configurare Capgo Native Build.

Attenzione

Non commettere mai le credenziali che avete appena creato nel tuo repository. Conservatele al sicuro! 🔒

Eseguire il comando di configurazione

Hai fatto! Hai ora tutto il necessario per configurare Capgo Native Build.

Il comando che dovrai eseguire è:

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

Sostituisci i valori dei placeholder

Sostituisci i valori dei placeholder sopra con le tue credenziali reali raccolte nei passaggi precedenti:

• --apple-team-idIl tuo ID di team Apple
• --apple-keyPercorso del tuo file .p8 chiave scaricato
• --apple-key-idIl tuo ID chiave Apple
• --apple-issuer-id: Il tuo ID emittente Apple
• --certificate: Percorso del tuo file esportato .p12 : Certificato
• --ios-provisioning-profile: Percorso del tuo file scaricato (ID bundle auto-inferito per profili singoli) .mobileprovision Se tutto è andato bene, vedrai l'output seguente:

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ output di salvataggio delle credenziali

Sezione intitolata “Configurazione CI/CD (GitHub Actions)”

ID del tuo team Chiave Apple, ID chiave Apple e ID emittente Apple, If all went well, you will see the following output:, Certificato, e Profilo di provisioning, hai già tutto ciò che ti serve per CI/CD. Questa sezione copre solo come passare questi valori come segreti e variabili di ambiente GitHub delle azioni.

1) Converti i file di credenziali in base64 a riga singola

# 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

Suggerimento

I segreti GitHub dovrebbero essere valori a riga singola. tr -d '\n' rimuove i caratteri di fine riga dall'output in base64.

2) Crea segreti del repository

Inserisci GitHub > Repository > Settings > Secrets and variables > Actions, aggiungi:

Nome segreto	Valore
CAPGO_TOKEN	Il tuo Capgo API token
APP_STORE_CONNECT_TEAM_ID	ID del team da ID del team
APPLE_KEY_ID	ID della chiave da Chiave Apple, ID della chiave Apple e ID dell'emittente Apple
APPLE_ISSUER_ID	ID dell'emittente da Chiave Apple, ID chiave Apple e ID rilasciatore Apple
BUILD_CERTIFICATE_BASE64	Contenuto di certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	Generato da CLI — copia da .capgo-credentials file
APPLE_KEY_CONTENT	Contenuto di apple_key_base64.txt
P12_PASSWORD (facoltativo)	Il tuo .p12 password se impostato durante l'esportazione

3) Utilizza le variabili di ambiente nel tuo GitHub workflow di 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 }}

Suggerimento

Con questo setup, il CI invia le credenziali attraverso le variabili di ambiente solo. Non è necessario commitare i file di firma o caricarli come artefatti di workflow.

Esecuzione della costruzione

Ora sei pronto a eseguire la tua prima costruzione.

Esegui il seguente comando per costruire la tua app:

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

Congratulazioni 🎉 In questo punto, hai avuto successo nella costruzione della tua app e è pronta per essere inviata alla App Store.

Modalità di distribuzione Ad-Hoc

Di default, Capgo costruisce app iOS per la distribuzione su App Store (TestFlight + App Store). Se hai bisogno di costruire app ad-hoc al posto (per test interni o raccolta di artefatti di CI), puoi utilizzare il --ios-distribution flag.

Nota

La distribuzione ad-hoc non è la stessa della distribuzione Enterprise (In-House). La distribuzione Enterprise richiede un account separato di sviluppatore Apple Enterprise e utilizza profili di provisioning diversi. __CAPGO_KEEP_0__ supporta attualmente e the same as Enterprise (In-House) distribution. Enterprise distribution requires a separate Apple Developer Enterprise account and uses different provisioning profiles. Capgo currently supports app_store Quando utilizzare il modo ad-hoc ad_hoc Sezione intitolata “Quando utilizzare il modo ad-hoc”

Vuoi distribuire le IPAs direttamente ai dispositivi registrati (nessun TestFlight)

• Section titled “When to use ad-hoc mode”
• Non hai o non vuoi utilizzare una chiave App Store Connect API
• Vuoi raccogliere gli artefatti di costruzione tramite --output-upload senza sottoporli alla valutazione dell'App Store

Requisiti

I build ad-hoc hanno requisiti minori rispetto ai build dell'App Store:

Credenziale	Richiesta?
Certificato di distribuzione (.p12)	Sì
Profilo di provisioning ad-hoc (.mobileprovision)	Sì
ID del team (--apple-team-id)	Sì
Chiave di App Store Connect API (.p8)	No
ID chiave di Apple / ID emittente	No

Nota

In ad_hoc modalità, --apple-key, --apple-key-idEcco perché le due righe di App Store Connect sopra non mostrano flag __CAPGO_KEEP_0__ ad-hoc; queste opzioni si applicano solo al --apple-issuer-id are not supported and are ignored. This is why the two App Store Connect rows above do not show ad-hoc CLI flags; these options apply to app_store Attenzione

Senza una chiave __CAPGO_KEEP_0__ di App Store Connect, il numero di build auto-incrementa utilizza un fallback basato su timestamp. Per sopprimere il warning, passa

Without an App Store Connect API key, build number auto-increment uses a timestamp-based fallback. To suppress the warning, pass --skip-build-number-bump.

Sottosezione intitolata “Crea un profilo di provisioning ad-hoc”

Profilo di provisioning , ma nel passo 5 selezionaAd Hoc Creating an ad-hoc provisioning profile al posto di App Store:

1. Vai a Profili sviluppatori Apple
2. Clicca sul + tasto
3. Seleziona Ad Hoc e clicca Continua
4. Seleziona il tuo app e il certificato di distribuzione
5. Seleziona i dispositivi che desideri registrare
6. Nome e scarica il profilo

Salvare credenziali 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'

No --apple-key, --apple-key-id, o --apple-issuer-id necessario.

Eseguire un build ad-hoc

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

Per raccogliere l'IPA come artefatto di build, aggiungi --output-upload:

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

CI/CD con costruzioni ad-hoc

Per GitHub Actions, hai bisogno di meno segreti rispetto alle costruzioni dell'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

Suggerimento

Nota che APPLE_KEY_ID, APPLE_ISSUER_IDe APPLE_KEY_CONTENT non sono necessari per le costruzioni ad-hoc.

Applicazioni con Estensioni (Multi-Target Signing)

Se la tua app include estensioni (estensioni di condivisione, widget, estensioni del servizio di notifica, ecc.), ogni target di estensione necessita di un proprio profilo di provisioning. Capgo supporta questo tramite il flag ripetibile. --ios-provisioning-profile Esempio: App + Estensione di condivisione

Finestra del terminale

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"

Legge ogni file mobileprovision --ios-provisioning-profile flag maps a bundle ID to its provisioning profile file. The CLI:

1. Estrae automaticamente il nome del profilo dal plist incorporato
2. Estrae automaticamente il nome del profilo dal plist incorporato
3. Codifica il file in Base64
4. Memorizza tutto come un singolo CAPGO_IOS_PROVISIONING_MAP credenziale

Suggerimento

Hai bisogno di un certificato di distribuzione per tutti i target — solo i profili di provisioning differiscono per target.

Migrazione da Profilo Singolo

(profilo singolo), esegui: BUILD_PROVISION_PROFILE_BASE64 Finestra del terminale

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

Converte i tuoi credenziali esistenti a profilo singolo in formato nuovo e elimina le chiavi legacy ( CAPGO_IOS_PROVISIONING_MAP Dopo la migrazione, aggiungi profili di estensione con il comando (incorpora con sovrapposizione):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Finestra del terminale update Copia negli appunti

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

(non

) per aggiungere profili alle credenziali esistenti. Il comando unisce nuovi profili con quelli esistenti. Usa update The saveIl update command save solo quando si configurano tutti i credenziali da zero.

Risoluzione dei problemi

Il profilo di provisioning non include la capacità XYZ.

A volte, potresti vedere l'errore seguente:

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

Ciò accade perché hai abilitato una nuova capacità dopo la creazione del profilo di provisioning. Il vecchio profilo di provisioning non include ancora la nuova capacità.

Per risolvere il problema, è necessario rigenerare il profilo di provisioning.

1. Apri Portale dello sviluppatore Apple
2. Seleziona il team corretto nella casella a discesa
3. Clicca sul Profiles button
4. Trova il profilo di provisioning che desideri rigenerare
5. Clicca sul Edit button
6. Clicca sul Save button
7. Clicca sul Download tasto
8. Riesegui il comando di configurazione del setup di Capgo Native Build con il profilo appena scaricato. Ciò dovrebbe risolvere il problema.

Altri problemi

Sezione intitolata “Altri problemi”

If for whatever reason you are having issues either with Capgo Native Build, configuring the credentials or building the app, please don’t hesitate to reach via our Pagina di modifica.