Eine Capacitor-App für iOS bauen, wenn Sie unter Windows arbeiten

Was unter Windows funktioniert

Wir haben diese Schritte auf GitHubs Runner mit Windows Server 2025 und Node 22 ausgeführt. Die Doku von Capacitor verlangt Node 22 oder neuer. Jeder Schritt lief durch.

npm init @capacitor/app@latest capdemo -- --name CapDemo --app-id com.example.capdemo
cd capdemo
npm install
npm run build
npm i @capacitor/android @capacitor/ios
npx cap add android
npx cap add ios
npx cap sync ios

Auch der Android-Debug-Build lief dort mit JDK 21. gradlew.bat assembleDebug dauerte auf einem kalten Runner 6 Minuten 33 Sekunden. Er erzeugte eine app-debug.apk mit 8,2 MB.

Die Überraschung ist npx cap add ios. Der Befehl lief unter Windows in weniger als einer Sekunde und schrieb ein vollständiges Xcode-Projekt. Das hat er ausgegeben:

√ Adding native Xcode project in ios in 47.04ms
[info] All Capacitor plugins have a Package.swift file and will be included in Package.swift
[info] Writing Package.swift
[success] ios platform added!

Swift Package Manager, nicht CocoaPods

Projekte mit Capacitor 8 nutzen standardmäßig den Swift Package Manager. Die Doku empfiehlt ihn und sagt, dass CocoaPods vor Capacitor 8 der Standard war. Unser neues Projekt hatte keine Podfile. Es hatte ios/App/App.xcodeproj und ein Paket CapApp-SPM, das auf Ihre Plugins in node_modules verweist.

Deshalb funktionieren die iOS-Schritte jetzt unter Windows. Es gibt kein pod install auszuführen. Wenn Ihr Projekt noch CocoaPods nutzt, braucht pod install macOS. Ein CocoaPods-Projekt unter Windows haben wir nicht getestet. Für den Wechsel zu SPM bietet die Doku npx cap spm-migration-assistant an.

Was weiterhin einen Mac braucht

• xcodebuild und Xcode. Capacitor 8 braucht Xcode 26.0 oder neuer, und Xcode läuft nur unter macOS.
• npx cap open ios und npx cap run ios. Beide geben das Projekt an Xcode oder den Simulator weiter.
• Der iOS-Simulator. Er gehört zu Xcode.
• Signieren, Archivieren und Hochladen. Für diesen Teil siehe Veröffentlichen ohne Mac.

Die Übergabe von Windows zum Mac, die wir getestet haben

Wir haben das Windows-Projekt nach git committet und auf einen Mac-Runner gebracht. Die eigene .gitignore des Ordners ios lässt die kopierten Web-Dateien und die erzeugte Konfiguration weg. Der Mac baut sie also neu, bevor Xcode läuft:

npm ci
npm run build
npx cap sync ios
xcodebuild -project ios/App/App.xcodeproj -scheme App \
  -configuration Debug -sdk iphonesimulator \
  -destination 'generic/platform=iOS Simulator' \
  -derivedDataPath build build

Der Build dauerte mit Xcode 26.6 36 Sekunden. Beim ersten Lauf holte Xcode capacitor-swift-pm 8.5.3 von GitHub. Dann haben wir die App im Simulator des iPhone 17 Pro installiert und geöffnet. Der Willkommensbildschirm von Capacitor erschien.

xcrun simctl install booted build/Build/Products/Debug-iphonesimulator/App.app
xcrun simctl launch booted com.example.capdemo

Die iOS-Seite von Capacitor sagt noch, Sie sollen App.xcworkspace öffnen. Ein SPM-Projekt hat keinen, also öffnen Sie stattdessen ios/App/App.xcodeproj.

Auch ein Geräte-Build ohne Signierung lief in 17 Sekunden durch. Fügen Sie CODE_SIGNING_ALLOWED=NO hinzu und nutzen Sie -sdk iphoneos. Zum Ausliefern öffnen Sie das Projekt in Xcode, wählen Ihr Team unter Signing and Capabilities und dann Product, dann Archive.

Und Ionic Appflow?

Appflow baut iOS-Apps in der Cloud von Ionic, und seine Seite sagt das noch immer. Am 11. Februar 2025 hat Ionic den Neuverkauf von Appflow eingestellt. Bestehende Nutzer behalten den Zugang bis zum 31. Dezember 2027. Wenn Sie noch kein Kunde sind, planen Sie einen anderen Weg ein.

Den Mac für einen Schritt mieten

Ein Tagespass von MacRun ist ein dedizierter M6 Mac mini für $15, oder $59 für eine Woche. Xcode 27.1 und der Simulator für iOS 27.1 sind installiert. Node nicht. Sie haben Admin-Rechte und Homebrew, also installieren Sie die Node-Version, die Sie nutzen. Sie verbinden sich von Windows aus per SSH und Bildschirmfreigabe. Der Mac wird gelöscht, wenn der Pass endet. Unser Leitfaden Simulator unter Windows zeigt, wie sich der entfernte Bildschirm anfühlt.

Wer dafür keinen Mac mieten sollte

Wenn Sie nur ab und zu einen Build brauchen, kann ein gehosteter macOS-Runner das erledigen. Die Befehle oben liefen auf GitHub Actions ohne eigenen Mac. Codemagic nennt Unterstützung für Ionic und gibt Einzelpersonen 500 kostenlose Minuten auf macOS M2 im Monat. So steht es auf seiner Preisseite am 19. Oktober 2026. Wenn Sie jede Woche ausliefern, kann ein gebrauchter Mac auf Dauer günstiger sein. Ein gemieteter Mac passt, wenn Sie Xcode offen brauchen, bei Ärger mit der Signierung oder einem Fehler in einem nativen Plugin.