Linux ist eine komfortable Umgebung für Capacitor-Apps, und Android lässt sich dort ohne Kompromisse bauen. iOS ist die Ausnahme: Xcode und Apples Signing-Tools laufen nur unter macOS. Die Lösung ist kein Mac mini unter dem Schreibtisch, sondern das iOS-Projekt lokal zu generieren und in der Cloud auf macOS zu kompilieren.
Dieser Guide ist die Linux-Version von iOS-App unter Windows mit Capacitor und Capgo Build bauen. Er behandelt die Teile, die sich unter Linux unterscheiden: OpenSSL-Zertifikate, eine Linux-Shell und CI von Linux-Runnern.
Die Arbeitsteilung
Eine Capacitor-App hat zwei Builds:
- Web-Build: dein Framework-Output in
dist/. Auf Linux erledigt. - Native Build: Xcode-Archiv, Signierung, Upload. Erledigt von Capgo Build auf Apple-Silicon-Maschinen mit dem aktuellen macOS und Xcode.
CLI lädt das vorbereitete ios/ Projekt von deinem Rechner. Nichts muss auf einem Git-Host liegen, und keine privaten Registry-Zugangsdaten verlassen dein Gerät, da die Installation der Abhängigkeiten und cap sync lokal vor dem Upload erfolgen.
Voraussetzungen
- Eine Capacitor App, die lokal gebaut wird (jedes Framework).
- Node 20+ oder Bun unter Linux.
- Eine Mitgliedschaft im Apple Developer Program.
- OpenSSL (unter fast jeder Distribution vorinstalliert).
- Ein Capgo Account und die registrierte App bei
bunx @capgo/cli@latest app add.
1) Das iOS-Projekt unter Linux generieren
bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli
bunx cap init
bun run build
bunx cap add ios
Du siehst dann etwas wie Skipping pod install because CocoaPods is not installed. So gewollt. Der ios/ Ordner existiert und sollte committet werden; er enthält deine Bundle ID, die Info.plist, Icons und native Einstellungen.
2) Web-Assets vor jedem Build synchronisieren
bun run build
bunx cap sync ios
cap sync kopiert dist/ in ios/App/App/public und aktualisiert Plugin-Referenzen. Capgo kompiliert den Inhalt von ios/, sodass ein nicht synchronisiertes Projekt die alte UI ausliefert.
3) Signing-Material ohne Mac erstellen
Du brauchst drei Dinge: ein Apple-Distribution-Zertifikat als .p12ein App Store Provisioning Profile und einen App Store Connect API Key. Nichts davon erfordert Keychain Access.
Distribution-Zertifikat mit OpenSSL
openssl genrsa -out ios_distribution.key 2048
openssl req -new -key ios_distribution.key -out ios_distribution.csr \
-subj "/emailAddress=you@example.com/CN=Your Name/C=US"
Upload ios_distribution.csr unter Certificates, Identifiers & Profiles wähle Apple Distribution und lade distribution.cerherunter. Konvertieren und bündeln:
openssl x509 -in distribution.cer -inform DER -out distribution.pem -outform PEM
openssl pkcs12 -export -inkey ios_distribution.key -in distribution.pem \
-out ios_distribution.p12 -legacy
Der -legacy Flag ist bei OpenSSL 3 wichtig. Ohne dieses lehnen Apples Tools den .p12 mit einem Fehler wegen ungültigem Passwort, obwohl das Passwort richtig ist. Wenn du OpenSSL lieber nicht anfassen möchtest, dann iOS-Zertifikatsgenerator macht dasselbe im Browser.
Provisioning-Profil und API Key
Erstelle im Apple Developer Portal ein App Store Profil für deine Bundle ID, das das neue Zertifikat nutzt, und lade die .mobileprovision. Erstelle in App Store Connect einen API Key mit der Rolle „App Manager“ und lade den .p8; notiere dir die Key ID und die Issuer ID. Die iOS-Build-Anleitung zeigt jeden Screen.
Willst du ein Profil unter Linux inspizieren? openssl smime -inform der -verify -noverify -in profile.mobileprovision gibt die eingebettete plist aus.
4) Speichere die Credentials in Capgo
bunx @capgo/cli@latest login
bunx @capgo/cli@latest build credentials save \
--platform ios \
--apple-team-id "TEAMID" \
--apple-key ./AuthKey_KEYID.p8 \
--apple-key-id "KEYID" \
--apple-issuer-id "issuer-uuid" \
--certificate ./ios_distribution.p12 \
--ios-provisioning-profile ./App_Store.mobileprovision
Oder führe bunx @capgo/cli@latest build init --platform ios für die geführte Version aus. Unter Linux ist der App Store Connect-Key-Schritt manuell; alles andere wird per Prompt abgefragt.
Falls Apple den Key mit einem Authentifizierungsfehler ablehnt, synchronisiere deine Uhr. Das JWT wird mit der lokalen Zeit signiert, und Apple lehnt Tokens ab, die zu stark abweichen:
timedatectl status
sudo timedatectl set-ntp true
5) Build anfordern
bun run build
bunx cap sync ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
Das vorbereitete ios/ Projekt wird hochgeladen, Capgo führt den pod install, Prozess aus, archiviert mit Xcode, signiert mit deinem Zertifikat und streamt die Logs in dein Terminal. Mit konfiguriertem API Key wird der Build nach Abschluss an TestFlight übermittelt. Installiere die TestFlight-App auf einem iPhone, um ihn auszuführen.
Fehlgeschlagene Builds können automatisch diagnostiziert werden, indem du --ai-analytics; der KI-Build-Diagnose liest das Xcode-Log und erklärt die Lösung.
6) Ad-hoc-Builds für Tester ohne TestFlight
Für ein per UDID registriertes QA-Gerät ein Ad-Hoc-Profil verwenden und die IPA als Artefakt speichern:
bunx @capgo/cli@latest build request com.example.app \
--platform ios \
--ios-distribution ad_hoc \
--output-upload
Die CLI gibt einen zeitlich begrenzten Download-Link aus. Füge --output-record build.json um den Link und einen QR-code für einen Tester zu speichern.
7) Von einem Linux-CI-Runner aus automatisieren
Die gleichen Befehle laufen auf jedem Linux-CI. Ein GitHub Actions-Beispiel:
name: iOS build
on:
workflow_dispatch:
jobs:
ios:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: oven-sh/setup-bun@v2
- run: bun install
- run: bun run build
- run: bunx cap sync ios
- run: bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
Die in Schritt 4 gespeicherten Zugangsdaten werden in Capgo abgelegt, sodass der Runner nur den Token benötigt. Alternativ einen CI-Export erstellen .env mit bunx @capgo/cli@latest build credentials manage und die Werte als Secrets übergeben; siehe Zugangsdaten verwalten.
8) Tägliche Iteration ohne native Builds
Sobald der TestFlight-Build existiert, sind die meisten Änderungen Web-Änderungen. Pushen Sie diese mit Capgo Live Updates:
bun run build
bunx @capgo/cli@latest bundle upload --channel production
Reservieren build request für neue Plugins, Berechtigungsänderungen, Icon-Änderungen und Capacitor-Upgrades.
Linux-Fallstricke
- Vergessen
cap sync ios: Die IPA zeigt die alte UI. Synchronisieren Sie vor jeder Anfrage. ios/in einem.gitignore: CLI lädt von der Festplatte hoch, daher baut es weiterhin, aber Ihre Teammitglieder und CI haben das native Projekt nicht. Committen Sie es..p12Passwort abgelehnt: neu generieren mit-legacy.- Apple-Authentifizierung fehlgeschlagen: Uhrzeitabweichung. NTP aktivieren.
- Plugin hinzugefügt, nativer Rebuild vergessen: Das Hinzufügen eines Capacitor Plugins ändert die native Binary. Führe einen neuen Cloud Build und eine Store-Submission durch, bevor du Web-Änderungen veröffentlichst, die dieses Plugin nutzen.
Zusammenfassung
Linux kann Xcode nicht ausführen, muss es aber auch nicht. Erstelle ios/ mit Capacitor, erstelle Build-Zertifikate mit OpenSSL und lass Capgo Build kompilieren, signieren und an TestFlight senden. Dank Live Updates für den Web-Layer liefert ein reines Linux-Team iOS genauso selbstverständlich aus wie Android. Für das komplette Environment-Setup lies Capacitor-Entwicklung unter Linux.