iOS-Builds

Erstellen und bei TestFlight und dem App Store hochladen Sie iOS-Apps mit Capgo’s dediziertem Mac-Infrastruktur.

Was Sie lernen werden

• Sie werden erfahren, wie Sie Ihre App über Capgo Native build hochladen
• Sie werden lernen, wie Sie die Zertifikate für Capgo Native Build konfigurieren können

Voraussetzungen

• Ein Capgo-Konto (ein kostenloses Probeabo reicht aus, um loszulegen)
• Ihr App bereits in Capgo registriert (laufen Sie bunx @capgo/cli@latest app add wenn nicht)
• Ein Mac-Computer mit Xcode installiert (es ist möglich, die Build-Einstellung auf einem Linux/Windows-Maschine vorzunehmen, aber es ist noch nicht dokumentiert)
• Ein gültiges Apple-Entwicklerkonto (99 $/Jahr) (Sie müssen auf dem Apple-Entwicklerkonto Admin- oder Eigentümerrechte haben)
• Ihre App muss erfolgreich über Xcode gebaut werden können
• Eine Capacitor-App
• Eine für die App konfigurierte Icon. Apps ohne ein Icon können nicht auf dem App Store hochgeladen werden.

Hinweis

Für diese Anleitung werde ich das folgende App verwenden: https://github.com/Cap-go/capgo-native-build-tutorial-app

Bevor Sie mit der Einrichtung in Apples Portalen beginnen:

Stellen Sie sicher, dass das Apple-Konto und die Team-Übersicht vor der Einrichtung von Zertifikaten oder dem ersten Testflug-Upload bereit sind:

• Aktivieren Sie die Zwei-Faktor-Authentifizierung für das Apple-Konto, das für die Registrierung verwendet wird:
• Wählen Sie die richtige Mitgliedschaftsart:
  • Einzelunternehmen / Einzelunternehmer: Ihr rechtlicher Name wird zum Verkäufernamen im App Store
  • Organisation: erfordert eine juristische Person, eine D-U-N-S-Nummer, eine öffentliche Unternehmenswebsite, eine E-Mail-Adresse auf dem Unternehmensdomän und eine Person mit der Befugnis, die Organisation zu Apples Vereinbarungen zu binden
• Verwenden Sie ein Konto, das Zugriff auf beide Apple Developer und App Store Connect für Zertifikate, App-Records, API-Schlüssel und TestFlight hat
• Buchen Sie Ihren finalen Bundle-Id frühzeitig. Ändern Sie ihn später, bedeutet es normalerweise, die App Store-Einrichtung neu zu konfigurieren
• Planen Sie diese App Store Connect-Elemente vor der App-Überprüfung: Unterstützungs-URL, Datenschutzrichtlinien-URL, Altersfreigabe, Screenshot, Export-Kompliance und App-Überprüfung-Kontaktinformationen

Hinweis

Nützliche offizielle Referenzen:

• Werden Sie Mitglied des Apple Developer-Programms
• Hinweis
• Plattformversioneninformationen in App Store Connect

Vorsicht

Apple aktualisiert regelmäßig seine Mindestanforderung an SDK. Ab dem 28. April 2026, müssen iPhone- und iPad-Apps, die bei App Store Connect hochgeladen werden, mit dem iOS & iPadOS 26 SDK oder später.

Empfohlen: automatisierte Einbindung

Sie müssen nichts davon manuell durchführen. Capgo's Einbindung erstellt und konfiguriert Ihre iOS-Zertifikate (Distributionszertifikat + Provisioning-Profil) für Sie — dies ist der empfohlene Weg:

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

The folgende manuelle Anleitung ist nur für diejenigen, die sich selbst die Anmeldedaten einrichten möchten oder genau wissen möchten, was Capgo unter der Haube tut.

Der erste manuelle Build

Bevor wir mit dem Aufbau der App mit Capgo beginnen können, sollten wir sie zuerst einrichten und einen ersten TestFlight-Build manuell durchführen. Es gibt einige Vorteile daran, einen manuellen Build zuerst durchzuführen:

• Sie werden die Verteilungs-Zertifizierung auf Ihrem lokalen Computer einrichten
• Sie werden die App Store-Eintrag erstellen, wenn Sie es noch nicht getan haben
• Sie werden in der Lage sein, Probleme mit dem Build-Prozess zu erkennen, die mit Ihrer App code verbunden sind

Bevor wir beginnen können, müssen Sie die Verteilungs-Zertifizierung auf Ihrem lokalen Computer installiert haben. Das ist ziemlich komplex, aber ich werde es unten erklären.

Einrichten der Verteilungs-Zertifizierung

1. Öffnen Sie Xcode

2. Klicken Sie auf Xcode -> Settings... Alternativ können Sie den Kurzbefehl verwenden Cmd + ,

   

3. Zum Accounts

4. Finden Sie das Apple-Konto, das der Apple-Entwicklerkonto hinzugefügt wurde

5. Finden Sie das Team, das Sie zum Bereitstellen der App verwenden werden

6. Klicken Sie auf den Manage Certificates... Button

7. Stellen Sie sicher, dass Sie das Verteilungszertifikat in der Liste sehen können

8. Wenn Sie nicht tun, müssen Sie ein neues Zertifikat erstellen

   Hinweis

   Apple beschränkt die Anzahl der Verteilungs-Zertifikate, die Sie haben dürfen, auf 3. Wenn Sie mehr als 3 Zertifikate haben, müssen Sie eines löschen, um ein neues zu erstellen. Ich werde mich nicht auf das in diesem Tutorial einlassen.

   1. Klicken Sie auf den + Schaltfläche und dann auf Apple Distribution
   2. Das Zertifikat wird automatisch erstellt. Sie können es in der Liste sehen. Schauen Sie sich den vorherigen Schritt an, um zu bestätigen, dass Sie es sehen.

Da Sie nun das Verteilungs-Zertifikat installiert haben, können Sie den Build-Prozess beginnen.

Manueller Build zum TestFlight

1. Öffnen Sie die App in Xcode

   Ausführen bunx cap open ios Um die App in Xcode zu öffnen.

2. Finden und auf den archive __CAPGO_KEEP_0__

   In der Xcode-Leitfaden, finden und auf den product -> archive __CAPGO_KEEP_0__

   

3. Warten, bis die Veröffentlichung abgeschlossen ist

4. Klicken Sie auf den Distribute App __CAPGO_KEEP_0__

   

5. Wählen Sie TestFlight Internal Only als Verteilungsmethode aus und klicken Sie auf Distribute Schaltfläche

   

6. Konfigurieren Sie das App-Verzeichnis

   Füllen Sie die folgenden Felder aus:

   1. Name: Der Name Ihrer App - sichtbar im App Store
   2. SKU - der SKU Ihrer App - dieser wird verwendet, um Ihre App im App Store zu identifizieren
   3. Hauptsprache - die Hauptsprache Ihrer App

   Klicken Sie dann auf die next Schaltfläche

   

7. If die Erstellung des App-Records fehlschlägt, versuchen Sie, das Fenster zu schließen und das Archivieren der App erneut zu versuchen.

8. Warten Sie, bis der Upload abgeschlossen ist

9. Wenn alles gut ging, sollten Sie die folgende Seite sehen

10. Klicken Sie auf den Done Button

Sie denken vielleicht instinktiv, dass alles in Ordnung ist und dass Sie Ihre App in TestFlight jetzt sehen können, aber es gibt noch ein paar Dinge, die noch abgeschlossen werden müssen:

1. Setzen Sie sich in TestFlight ein
2. Abschließen Sie die Exportkonzession, damit die Veröffentlichung testbar wird
3. Füllen Sie die erforderlichen App Store Connect-Metadaten wie Ihre Support-URL, Ihre Datenschutzrichtlinien-URL und Ihre Altersangabe aus
4. Vorbereiten Sie Screenshots, die den von Ihnen unterstützten Geräten entsprechen
5. Fügen Sie die App-Bewertungs-Kontaktinformationen und alle Testanmeldeinformationen vor der Produktionsabgabe hinzu

Lassen Sie es mit dem ersten beginnen:

Sich selbst in TestFlight hinzufügen

1. Gehe zur App Store Connect-Seite App Store Connect-Anmeldeseite

2. Wähle das Team aus, das du verwendet hast, als du das App-Record erstellt hast. Wenn du nur in einem Entwicklerkonto bist, kannst du diesen Schritt überspringen.

3. App Store Connect-Teamauswahl

4. Button Apps Schritt

5. Finden Sie die im vorherigen Schritt erstellte App und klicken Sie darauf

6. Klicken Sie auf die TestFlight Schaltfläche

7. Klicken Sie auf die Internal Testers plus Schaltfläche

8. Erstellen Sie eine neue Gruppe

   Ich bevorzuge es, der Gruppe den Namen „interne“ zu geben. Sie können ihr einen Namen geben, den Sie möchten.

   

9. Klicken Sie auf Invite testers Schaltfläche

10. Fügen Sie sich der Gruppe hinzu

    Finden Sie sich in der Liste und wählen Sie das Häkchen neben Ihrem Namen aus. (Sie müssen sich möglicherweise neu einloggen, um sich selbst zu sehen) Dann klicken Sie auf die Add Schaltfläche.

    

11. Überprüfen Sie, ob Sie der Gruppe beigetreten sind

    Jetzt sollten Sie sich selbst in der Gruppe sehen.

    

Glückwunsch 🎉 Sie haben sich selbst in TestFlight hinzugefügt. Jetzt gibt es noch ein letztes Ding, das Sie tun müssen, bevor Sie Capgo Native Build konfigurieren können.

Konfiguration der Compliance-Informationen

Sie müssen nun Apple versprechen, dass Ihre App keine nicht standardmäßige (wie ein benutzerdefinierter Algorithmus) Verschlüsselung verwendet. Wenn Ihre App jedoch nicht standardmäßige Verschlüsselung verwendet, empfehle ich Ihnen, die Dokumentation von Apple zu lesen, um dies zu handhaben.

1. Es gibt zwei Möglichkeiten, dies zu tun:
2. Sie können dies jede Zeit, wenn Sie Ihre App bauen, manuell durchführen. false.

Sie können Ihre plist-Datei konfigurieren, um diese Werte automatisch auf

1. Lassen Sie uns mit der ersten Option beginnen:

2. Folgen Sie allen Schritten aus der vorherigen Abschnitt, um die TestFlight-Sektion in App Store Connect zu finden Builds -> iOS

3. App Store Connect iOS-Builds Manage

4. Wählen Sie die Option, die Ihre App am besten beschreibt

   Für mich ist das none, aber es könnte für Sie anders sein. Anschließend klicken Sie auf "Speichern"

   

5. Ihre App sollte jetzt sagen ready to test

   

Was die zweite Option betrifft, hier sind die Schritte:

1. Öffnen Sie das Info.plist Datei

2. Fügen Sie die folgende Schlüssel hinzu:

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

3. Speichern Sie die Datei

Hinweis

Hier Finden Sie hier die offizielle Apple-Dokumentation zur Einhaltung von Verschlüsselungsexportvorschriften.

Installieren Sie die TestFlight-App und akzeptieren Sie die Einladung

Jetzt bist du Fast bereit, deine App in TestFlight zu testen. Bevor du das tust, musst du noch folgende Dinge tun:

1. Laden Sie die TestFlight-App aus dem App Store auf Ihrem iOS/iPadOS-Gerät herunter
2. Die Einladung zum Testen Ihrer App akzeptieren

Ich werde die Einzelheiten darüber, wie Sie die TestFlight-App auf Ihrem Gerät installieren, nicht beschreiben. Wenn Sie sich nicht sicher sind, wie Sie eine App installieren, hat Google einige großartige Anleitungen dazu.

Was die Annahme der Einladung betrifft, erhalten Sie eine E-Mail von Apple mit einem Link, um die Einladung anzunehmen.

1. Öffnen Sie die E-Mail von Apple mit dem Link, um die Einladung anzunehmen

2. Klicken Sie auf View in TestFlight TestFlight-Einladungs-Button

3. TestFlight-Installations-Button Install Die App auf Ihrem Gerät installieren

4. Wenn Sie die App zuvor mit Xcode installiert haben, sehen Sie möglicherweise die folgende Seite. Bitte klicken Sie auf den

   Installieren Sie die App auf Ihrem Gerät install button.

5. Warten Sie, bis die App installiert ist

6. Klicken Sie auf den Open Button und klicken Sie darauf

Herzlichen Glückwunsch 🎉 Sie haben die Einladung zur Testung Ihrer App in TestFlight angenommen. Jetzt können Sie Capgo Native Build konfigurieren, um Ihre App zu bauen und bei TestFlight zu submiten.

Konfigurieren Sie Capgo Native Build

Es gibt ein paar Dinge, die Sie in Capgo Native Build konfigurieren müssen, um Ihre App bauen und bei TestFlight submiten zu können. Hier ist eine Liste der Dinge, die Sie an den Capgo CLI übergeben werden:

Parameter	Beschreibung
--platform	Die Plattform, für die Sie bauen (ios)
--apple-team-id	Ihre Apple-Entwickler-Team-ID (im Apple-Entwickler-Portal)
--apple-key	Pfad zu Ihrem App Store Connect API-Schlüsseldatei (.p8 Datei)
--apple-key-id	Die Schlüssel-ID Ihrer App Store Connect API-Schlüsseldatei
--apple-issuer-id	Ihre App Store Connect Aussteller-ID
--certificate	Pfad zu Ihrer Verteilungszertifikat (.p12 Datei)
--ios-provisioning-profile	Zuordnung von Provisioning-Profilen (bundleId=path oder einfach Pfad für ein einzelnes Profil)

Beispiel-Befehl:

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'

Team-ID

Lassen Sie uns mit der Team-ID beginnen. Sie ist leicht zu finden.

1. Zu Apple-Entwicklerkonto und scrollen Sie nach unten

2. Finden Sie die Team ID

   

Apple-Schlüssel, Apple-Schlüssel-ID und Apple-Aussteller-ID

Jetzt gehen wir zum Apple-Schlüssel über

macOS: Lassen Sie Capgo diese Schlüssel für Sie erstellen

Bei macOS capgo build init kann API für Sie diesen App Store Connect-Schlüssel erstellen. Wählen Sie “Nein — erstelle einen für mich” und ein geführtes Fenster öffnet sich App Store Connect, führt Sie durch jeden Schritt und fängt den Schlüssel, Key ID und Issuer ID automatisch ein — kein Kopieren und Einfügen. Die folgenden manuellen Schritte sind die Alternative (und der Weg auf Windows oder Linux).

1. Gehe zu App Store Connect-Benutzer- und Zugriffsbereich

   Hinweis

   Für mich funktioniert der Link manchmal nicht. Lade die Seite neu, wenn es für Sie nicht funktioniert.

2. Wählen Sie das richtige Team aus dem Dropdown-Menü

   1. Klicken Sie auf Ihren Namen in der oberen rechten Ecke
   2. Klicken Sie auf die Mannschaft, die Sie verwenden möchten

3. Klicken Sie auf den Integrations Schaltfläche

4. Finden Sie den issuer

   Vorsicht

   Dies __CAPGO_KEEP_0__ - Sie benötigen es später

   Klicken Sie auf den copy Button, um den Aussteller zu kopieren

5. Klicken Sie auf den Plus-Button

6. Legen Sie den Namen des Schlüssels fest und legen Sie den Zugriff auf App manager und klicken Sie auf den Generate Button

7. Schlüssel-ID speichern

   Vorsicht

   Dies __CAPGO_KEEP_0__ - Sie benötigen es später

   

8. Laden Sie die Schlüssel herunter

   Vorsicht

   Dies __CAPGO_KEEP_0__ - Sie benötigen es später

   Gefahr

   TEILE DEN SCHLÜSSEL NICHT MIT JEDEREN - BENUTZE IHNEN AUSNICHTS IN DEN CAPGO CLI

   

   

Glückwunsch 🎉 Sie haben den Apple-Schlüssel, den Apple-Key-ID und die Apple-Issuer-ID erstellt.

Zertifikat

Jetzt sind Sie bereit, das Zertifikat auszuführen. Wie Sie sich erinnern, war einer der ersten Schritte dieser Anleitung die Einrichtung des Verteilungszertifikats.

Allerdings haben sich die Apple in ihrer unendlichen Weisheit entschieden, dass die Art und Weise, wie Sie das Zertifikat exportieren, sich erheblich von der Art und Weise unterscheidet, wie Sie sie erstellen.

1. Öffnen Sie Keychain Access

   1. Klicken Sie Command + Space um den Suchbalken zu öffnen
   2. Suchen Sie nach Keychain Access
   3. Klicken Sie auf den Keychain Access __CAPGO_KEEP_0__

2. Wählen Sie die login __CAPGO_KEEP_0__ My Certificates Kategorie und klicken Sie auf den

3. Finden Sie Ihr Zertifikat in der Liste

   Das Zertifikat sollte den Namen Apple Distribution: [Your Name/Company] (your team ID)

4. Rechtsklicken Sie auf das Zertifikat und wählen Sie Export

5. Speichern Sie das Zertifikat als .p12 __CAPGO_KEEP_0__

   Vorsicht

   Dies __CAPGO_KEEP_1__ - Sie benötigen es später

   1. Stellen Sie sicher, dass Sie für das Zertifikat-Datei einen guten Namen auswählen
   2. Stellen Sie sicher, dass das Dateiformat auf Personal Information Exchange (.p12)
   3. Klicken Sie auf den Save Schaltfläche

   

6. Wenn Sie nach dem Passwort gefragt werden, können Sie entweder:

   • Das Passwort überspringen (empfohlen für Einfachheit): Klicken Sie OK ohne Passwort einzugeben
   • Ein Passwort setzen: Wenn Sie vorziehen, Ihr Zertifikat mit einem Passwort zu schützen, können Sie eines hier einstellen. Passwortgeschützte .p12 Dateien werden vollständig von der Capgo CLI unterstützt – geben Sie einfach das Passwort mit der --p12-password Option an, wenn Sie die Konfigurationskommando ausführen.

   

7. Wenn Sie nach dem „Anmelde-Schlüsselkasten-Passwort“ gefragt werden, geben Sie das Passwort ein, das Sie zum Anmelden an Ihrem Mac verwenden.

   Geben Sie das Passwort ein, das Sie zum Anmelden an Ihrem Mac verwenden. Dann klicken Sie auf den Allow Button.

   

Glückwunsch 🎉 Sie haben das Zertifikat exportiert.

Zertifikatsprofil

Jetzt bist du bereit, das Zertifikatsprofil auszugeben. Ich verspreche dir, das ist das letzte, was du von Apple benötigst.

1. Gehe zu Apple-Entwickler-Profil

2. Wähle das richtige Team aus dem Dropdown-Menü

   1. Klicke auf deinen Namen in der oberen rechten Ecke
   2. Klicke auf das Team, das du verwenden möchtest

3. Stelle sicher, dass du auf der richtigen Seite bist Es sollte so aussehen, wenn es nicht so aussieht, klicke auf profiles in der Seitenleiste

   

4. Klicken Sie auf den + __CAPGO_KEEP_0__

5. Wählen Sie den Profiltyp Wählen Sie App Store Connect und klicken Sie auf den Continue __CAPGO_KEEP_0__

   

6. Wählen Sie das App-Entwicklungsprojekt

   Finden Sie Ihre App im Dropdown-Menü und klicken Sie auf den Continue __CAPGO_KEEP_0__

   

7. Wählen Sie das richtige Verteilungs-Zertifikat

   Wählen Sie das Zertifikat, das Sie im vorherigen Schritt exportiert haben, und klicken Sie auf den Continue Button

   

   Wenn Sie unsicher sind, welches Zertifikat auswählen sollen, kommen Sie zurück zu Keychain Access und finden Sie das Zertifikat, das Sie exportiert haben. Dann sehen Sie sich die Ablaufzeit an.

   

8. Benennen Sie das Profil

   Geben Sie dem Profil einen Namen und klicken Sie auf den Generate Tip

   Der Profilname wird automatisch durch die __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ — Sie müssen ihn nicht merken.

   The profile name is automatically extracted by the Capgo CLI — you don’t need to remember it.

   

9. Das Profil herunterladen

   Klicken Sie auf den Download Button zum Herunterladen des Profils

   Vorsicht

   Dieser Datei IST ZU SPEICHERN - Sie benötigen es später

   

Glückwunsch 🎉 Sie haben jetzt alles, was Sie benötigen, um Capgo Native Build zu konfigurieren.

Vorsicht

Kommt nie in euren Repository ein. Bewahrt sie sicher! 🔒

Ausführen der Konfigurationskommandos

Gut gemacht! Ihr habt jetzt alles, was ihr zum Konfigurieren von Capgo Native Build benötigt.

Der Befehl, den ihr ausführen müsst ist:

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

Ersatzwerte für Platzhalter ersetzen

Ersetzt die Platzhalterwerte oben durch eure tatsächlichen Anmeldeinformationen, die ihr in den vorherigen Schritten gesammelt habt:

• --apple-team-idIhr Apple-Team-ID
• --apple-keyPfad zu eurer heruntergeladenen .p8 Sicherheitsdatei
• --apple-key-id: Ihre Apple-Schlüssel-ID
• --apple-issuer-id: Ihre Apple-Aussteller-ID
• --certificate: Pfad zu Ihrem exportierten .p12 Zertifikat
• --ios-provisioning-profile: Pfad zu Ihrem heruntergeladenen .mobileprovision Datei (Bundle-ID wird für einzelne Profile automatisch ermittelt)

Wenn alles gut gelaufen ist, sehen Sie folgende Ausgabe:

Apple-Authentifizierung fehlgeschlagen? Synchronisiere deinen Kalender

Wenn das App Store Connect API-Schlüssel korrekt aussieht, aber die Authentifizierung immer noch fehlschlägt, synchronisiere deinen Computer-Kalender und versuche es erneut. Capgo signiert Apples JWT mit deiner lokalen Systemzeit, und Apple lehnt Token ab, die mehr als 20 Minuten in der Zukunft ablaufen. Ein Kalender, der nur wenige Sekunden aus der Synchronisation ist, kann ausreichen, um diesen Schritt zu scheitern.

Blicken Sie sich den Fehlerbehefungshinweis für den Builder für die Schritte zum Zeitserver synchronisieren.

CI/CD-Einrichtung ( GitHub Actions )

Wenn Sie bereits die Schritte zum Zeitserver synchronisieren Team-ID, Apple-Schlüssel, Apple-Schlüssel-ID und Apple-Issuer-ID, Zertifikat, und Provisionierungsprofil, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

1) Kreditdateien in eine Zeile Base64 umwandeln

# 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

Tipp

GitHub-Geheimnisse sollten einzelne Zeilenwerte sein. tr -d '\n' Entfernt Zeilenumbrüche aus der Base64-Ausgabe.

2) Repository-Geheimnisse erstellen

In GitHub > Repository > Settings > Secrets and variables > Actions, hinzufügen:

Geheimer Name	Wert
CAPGO_TOKEN	Ihr Capgo API Token
APP_STORE_CONNECT_TEAM_ID	Team-ID von Team-ID
APPLE_KEY_ID	Schlüssel-ID von Apple-Schlüssel, Apple-Schlüssel-ID und Apple-Aussteller-ID
APPLE_ISSUER_ID	Aussteller-ID von Apple-Schlüssel, Apple-Schlüssel-ID und Apple-Aussteller-ID
BUILD_CERTIFICATE_BASE64	Inhalt von certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	Erstellt von CLI — kopieren Sie aus .capgo-credentials Datei
APPLE_KEY_CONTENT	Inhalt von apple_key_base64.txt
P12_PASSWORD (optional)	Ihr .p12 Passwort, wenn während der Export gesetzt

3) Verwenden Sie Umgebungsvariablen in Ihrem GitHub Actions Workflow

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

Hinweis

Mit dieser Konfiguration sendet CI nur die Anmeldeinformationen über Umgebungsvariablen. Sie müssen keine Signierungsdateien committen oder als Workflow-Artikel hochladen.

Die Erstellung ausführen

Jetzt bist du bereit, deine erste Erstellung auszuführen.

Führe den folgenden Befehl aus, um deine App zu erstellen:

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

Herzlichen Glückwunsch 🎉 Du hast deine App erfolgreich erstellt und sie ist bereit, zur App Store-Überprüfung eingereicht zu werden.

Zur App Store-Überprüfung einreichen

Der normale App Store-Build-Weg lädt die Erstellung in App Store Connect/TestFlight hoch. Wenn deine CI-Ausgabe auch die bearbeitete TestFlight-Erstellung zur App Store-Version anhängen und zur App-Überprüfung einreichen soll, übergebe --submit-to-store-review mit einer Release-Erstellung:

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

Dies erfordert App Store Connect API-Sicherheitszertifikate (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, und APP_STORE_CONNECT_TEAM_ID). App-spezifische Passwörter und ad_hoc Verteilung können keine Build-Review-Submission erstellen. --store-release-name ist die App-Store-Version; wenn diese weggelassen wird, Capgo liest MARKETING_VERSION aus dem Xcode-Projekt. --store-release-notes ist die Ausfallsicherung für App-Store-Neuigkeiten und jeder --store-release-notes-locale "locale=notes" Eintrag kann es für eine Store-Lokalisierung überschreiben. Verwenden --ios-automatic-release um automatisch nach Apple-Zustimmung freizugeben, oder --no-ios-automatic-release um auf eine manuelle Freigabe zu warten. --ios-testflight-groups ist weiterhin für externe Beta-Verteilung verfügbar, aber es ist nicht erforderlich für die App-Store-Review-Submission.

Ad-Hoc-Verteilungsmodus

Standardmäßig erstellt Capgo iOS-Anwendungen für die Verteilung im App Store (TestFlight + App Store). Wenn Sie stattdessen ad-hoc-gebaute Anwendungen benötigen (z.B. für interne Tests oder die Sammlung von CI-Artefakten), können Sie den --ios-distribution Flagge verwenden.

Hinweis

Ad-hoc-Verteilung ist nicht das gleiche wie Enterprise (In-House)-Verteilung. Enterprise-Verteilung erfordert ein separates Apple-Entwickler-Enterprise-Konto und verwendet unterschiedliche Bereitstellungsprofile. Capgo unterstützt app_store und ad_hoc Verteilungsmodi derzeit nur.

Wann ad-hoc-Modus verwenden

• Sie möchten IPAs direkt an registrierte Geräte verteilen (kein TestFlight)
• Sie haben keinen oder möchten keinen App Store Connect API-Schlüssel verwenden
• Sie möchten Build-Artikel über --output-upload ohne bei der App Store zu submiten

Anforderungen

Ad-hoc-Builds haben weniger Anforderungen als App Store-Builds:

Zertifikat	Erforderlich?
Verteilungszertifikat (.p12)	Ja
Ad-hoc-Provisionierungsprofil (.mobileprovision)	Ja
Team-ID (--apple-team-id)	Ja
App Store Connect API-Schlüssel (.p8)	Nein
Apple Key ID / Issuer ID	Nein

Hinweis

In ad_hoc Modus, --apple-key, --apple-key-id, und --apple-issuer-id sind nicht unterstützt und werden ignoriert. Dies ist der Grund, warum die beiden App Store Connect Zeilen oben keine ad-hoc CLI-Flags anzeigen; diese Optionen gelten nur für app_store Modus nur.

Vorsicht

Ohne einen App Store Connect API-Schlüssel, verwendet die automatische Inkrementierung der Buildnummer eine timestamp-basierte Ersatzmethode. Um die Warnung zu unterdrücken, übergeben Sie --skip-build-number-bump.

Erstellung eines ad-hoc-Beitrittsprofils

Folgen Sie den gleichen Schritten wie Beitrittsprofil, aber in Schritt 5 wählen Sie Ad hoc anstatt App Store:

1. Zu Apple-Entwicklerprofile
2. Klicken Sie auf den + Schaltfläche
3. Wählen Sie Ad hoc und klicken Sie auf Weiter
4. Wählen Sie Ihre App und Zertifikat für die Verteilung
5. Wählen Sie die Geräte, die Sie registrieren möchten
6. Name und herunterladen Sie das Profil

Sichere ad-hoc-Zugangsdaten

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'

Nein --apple-key, --apple-key-id, oder --apple-issuer-id benötigt.

Ausführen eines ad-hoc-Baus

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

Um die IPA als Build-Artifact zu sammeln, fügen Sie --output-upload:

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

CI/CD mit ad-hoc-Builds

Für GitHub Actions benötigen Sie weniger Geheimnisse als App Store-Builds:

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

Tipp

Beachten Sie, dass APPLE_KEY_ID, APPLE_ISSUER_IDund APPLE_KEY_CONTENT sind für ad-hoc-Builds nicht erforderlich.

Apps mit Erweiterungen (Multi-Target-Signing)

Wenn Ihre App Erweiterungen (z.B. Teilen-Erweiterungen, Widgets, Benachrichtigungs-Service-Erweiterungen usw.) enthält, benötigt jede Erweiterung ihr eigenes Provisioning-Profil. Capgo unterstützt dies über die wiederholbare --ios-provisioning-profile Flag.

Beispiel: App + Teilen-Erweiterung

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"

Jede --ios-provisioning-profile Flag stellt eine Bundle-ID auf ihr Provisioning-Profil-Datei zu. Der CLI:

1. Liest jede mobileprovision-Datei
2. Automatisch extrahiert den Profilnamen aus der eingebetteten plist
3. Base64-codiert das Datei
4. Speichert alles als ein CAPGO_IOS_PROVISIONING_MAP Kreditkarten-Daten

Tipp

Sie benötigen einen Verteilungszertifikat für alle Ziele – nur die Provisionierungsprofile unterscheiden sich pro Ziel.

Migration von Single Profile

Wenn Sie zuvor BUILD_PROVISION_PROFILE_BASE64 (Single Profile) verwendet haben, führen Sie bitte:

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

Dies wandelt Ihre bestehenden Ein-Profil-Zugangsdaten in das neue Format um und entfernt die alten Schlüssel ( CAPGO_IOS_PROVISIONING_MAP Nach der Migration fügen Sie Erweiterungsprofile mit demBUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Befehl (additiver Merge) hinzu: update Terminalfenster

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

Verwenden Sie

(nicht update ) um Profile zu bestehenden Zugangsdaten hinzuzufügen. Die save__CAPGO_KEEP_0__ update Befehl fügt neue Profile den bestehenden hinzu. Verwenden Sie save nur, wenn Sie alle Zugriffscodes von vorne beginnen.

Fehlersuche

Provisionierungsprofil enthält keine XYZ-Fähigkeit.

Manchmal sehen Sie den folgenden Fehler:

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

Dies tritt auf, weil Sie eine neue Fähigkeit aktiviert haben, nachdem das Provisionierungsprofil erstellt wurde. Das alte Provisionierungsprofil enthält die neue Fähigkeit noch nicht.

Um dies zu beheben, müssen Sie das Provisionierungsprofil neu erstellen.

1. Öffnen Apple-Entwicklerportal
2. Wählen Sie die richtige Mannschaft im Dropdown-Menü aus
3. Klicken Sie auf den Profiles Knopf
4. Finden Sie das Provisioning-Profil, das Sie wiederherstellen möchten
5. Klicken Sie auf den Edit Knopf
6. Klicken Sie auf den Save Knopf
7. Klicken Sie auf den Download Button
8. Führen Sie den Capgo Native Build Setup-Befehl erneut aus mit dem neu heruntergeladenen Profil.

Dies sollte das Problem beheben.

Weitere Probleme

Wenn Sie für irgendeinen Grund Probleme haben, sei es mit Capgo Native Build, der Konfiguration der Anmeldeinformationen oder der App-Build, zögern Sie bitte nicht, uns über unsere Support.

Weitermachen von iOS Builds

Wenn du iOS Builds verwendest iOS Builds um die CI/CD-Automatisierung zu planen, verbinde es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo Native Builds für den Produktworkflow in Capgo Native Builds, Capgo Integrations für den Produktworkflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration GitHub Aktionen Integration für die Implementierungsdetails in GitHub Aktionen Integration.