Die meisten Capacitor-Dokumentationen gehen von einem Mac aus. Wenn du auf Windows entwickelst, funktionieren die Web-Ebene und Android genauso, mit einigen Windows-spezifischen Fallstricken rund um PowerShell, Pfadlängen und den Emulator. iOS ist der eine Teil, den Windows nicht kompilieren kann – die Lösung ist ein Cloud-macOS-Build.
Dieser Leitfaden ist das vollständige Windows-11-Setup, von einer leeren Maschine bis zu einem Android-Build auf einem Gerät und einem iOS-Build in TestFlight über Capgo Build.
Was unter Windows funktioniert und was nicht
| Aufgabe | Windows |
|---|---|
| Webentwicklung, Vite, Framework-Tooling | Ja |
cap add android, cap sync, Gradle-Builds |
Ja |
| Android-Emulator | Ja, mit Hyper-V oder WHPX |
| Physisches Android-Gerät via USB | Ja |
| Chrome DevTools Remote-Debugging | Ja |
cap add ios, cap sync ios (generieren und kopieren) |
Ja, mit CocoaPods-Warnung |
| iOS kompilieren, signieren, archivieren | Nein, benötigt macOS. Nutze Capgo Build |
| iOS-Simulator | Nein |
| Safari Web Inspector für iOS WebView | Nein |
1) Node oder Bun installieren
Nutzt winget In PowerShell:
winget install OpenJS.NodeJS.LTS
# Or Bun
winget install Oven-sh.Bun
Öffne ein neues Terminal und bestätige:
node --version
bun --version
PowerShell-Execution-Policy korrigieren
bunx cap, npx cap und die meisten CLI-Shims sind .ps1 Skripte. Ein frisches Windows blockiert sie mit running scripts is disabled on this system. Erlaube lokale Skripte einmalig:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
2) JDK 21 installieren
Capacitor 7 und 8 benötigen JDK 21. Android Studio bringt sein eigenes JBR mit, aber ein System-JDK vermeidet Überraschungen, wenn du Gradle im Terminal ausführst.
winget install Microsoft.OpenJDK.21
Setzen Sie JAVA_HOME für deinen User. In PowerShell:
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Microsoft\jdk-21.0.8.9-hotspot", "User")
Passe den Ordner an die installierte Version an. Starte das Terminal danach neu.
3) Android Studio und das SDK installieren
winget install Google.AndroidStudio
Starte Android Studio und lass den Setup-Assistenten das SDK installieren, C:\Users\<you>\AppData\Local\Android\Sdk. Setze dann die Umgebungsvariablen, nach denen Gradle und Capacitor suchen:
$sdk = "$env:LOCALAPPDATA\Android\Sdk"
[Environment]::SetEnvironmentVariable("ANDROID_HOME", $sdk, "User")
$path = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$path;$sdk\platform-tools;$sdk\emulator", "User")
Öffne den SDK Manager in Android Studio und installiere die Plattform passend zu deiner Capacitor-Version: API 36 für Capacitor 8, API 35 für Capacitor 7.
4) Emulator beschleunigen
Der Emulator braucht Hardware-Virtualisierung. Unter Windows 11 nutzt der Emulator die Windows Hypervisor Platform. Aktiviere sie:
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform
Starte neu. Wenn der Device Manager von Android Studio weiterhin vor fehlender Beschleunigung warnt, prüfe, ob die Virtualisierung im BIOS oder UEFI aktiviert ist und ob Core Isolation (Speicherintegrität) sie bei älteren CPUs blockiert.
Erstelle ein Gerät im Device Manager oder über das Terminal:
sdkmanager "system-images;android-36;google_apis;x86_64"
avdmanager create avd -n pixel8 -k "system-images;android-36;google_apis;x86_64" -d pixel_8
emulator -avd pixel8
5) USB-Debugging unter Windows
Aktiviere die Entwickleroptionen und USB-Debugging auf dem Smartphone. Die meisten Handys brauchen keinen Treiber mehr, aber wenn adb devices leer bleibt, installiere den USB-Treiber von Google über den SDK Manager (SDK Tools-Tab) oder den Herstellertreiber für Samsung-Geräte.
adb devices
Bestätige beim ersten Mal die Fingerabdruck-Abfrage auf dem Smartphone.
6) Windows-spezifische Projekt-Fixes
Drei Einstellungen sparen Stunden auf Windows:
Lange Pfade. Gradle und node_modules können die 260-Zeichen-Grenze überschreiten. Lange Pfade einmal aktivieren:
git config --global core.longpaths true
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
Der zweite Befehl benötigt eine erhöhte PowerShell.
Defender-Ausschlüsse. Echtzeit-Scanning von node_modules, der Gradle-Cache und das Android SDK verlangsamen Builds spürbar. Schließe diese Ordner in der Windows-Sicherheit aus oder über eine erhöhte PowerShell:
Add-MpPreference -ExclusionPath "$env:USERPROFILE\.gradle"
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Android\Sdk"
Add-MpPreference -ExclusionPath "C:\dev"
Halte deine Projekte in einem kurzen Pfad wie C:\dev\my-app, nicht unter OneDrive-synchronisierten Dokumenten.
Zeilenenden. Das gradlew Shell-Skript von Gradle muss LF-Endungen behalten, sonst bricht das Linux-CI. Füge ein .gitattributes:
*.sh text eol=lf
gradlew text eol=lf
7) Erstelle das Capacitor-Projekt
bun create vite@latest my-app
cd my-app
bun install
bun add @capacitor/core @capacitor/android @capacitor/ios
bun add -d @capacitor/cli
bunx cap init
bun run build
bunx cap add android
bunx cap add ios
cap add ios auf Windows warnt, dass CocoaPods nicht verfügbar ist. Das ist erwartet; der ios/ Ordner wird trotzdem generiert und committet, und der Cloud-Build führt pod install später aus.
Führe auf dem Emulator oder einem USB-Gerät aus:
bunx cap run android
Debugge die WebView in Chrome unter chrome://inspect.
8) Android Release-Builds
keytool -genkeypair -v -keystore release.jks -keyalg RSA -keysize 2048 -validity 10000 -alias release
cd android
.\gradlew.bat bundleRelease
Die AAB liegt in android\app\build\outputs\bundle\release\. Für ein Team ist es besser, den Keystore einmal in Capgo zu speichern und in der Cloud zu bauen; siehe Capgo Build für Android.
9) iOS von Windows aus mit Capgo Build
Xcode gibt es nur für macOS, daher läuft der iOS-Compile auf der Mac-Infrastruktur von Capgo. Aus deinem Windows-Terminal:
bun run build
bunx cap sync ios
bunx @capgo/cli@latest login
bunx @capgo/cli@latest build init --platform ios
bunx @capgo/cli@latest build request com.example.app --platform ios --build-mode release
build init sammelt dein Signing-Material. Unter Windows wird der App Store Connect API Key manuell im Apple-Portal erstellt, nach der iOS-Build-Anleitung. Das Distribution-Zertifikat braucht kein Keychain Access: Erstelle den CSR und .p12 mit OpenSSL (winget install ShiningLight.OpenSSL.Light) oder über den browserbasierten iOS-Zertifikatsgenerator. Die Schritt-für-Schritt-Anleitung steht in iOS-App unter Windows mit Capacitor und Capgo Build bauen.
Sobald der Build fertig ist, kann Capgo ihn zu TestFlight pushen, sodass du ihn wenige Minuten später auf einem echten iPhone installierst.
10) Web-Änderungen ohne Rebuild deployen
Wenn beide Stores live sind, nutze Capgo Live Updates für Änderungen an JavaScript, HTML und CSS:
bunx @capgo/cli@latest init
bun run build
bunx @capgo/cli@latest bundle upload --channel production
Native Rebuilds sind nur für Plugins, Berechtigungen und Capacitor-Upgrades erforderlich.
Häufige Windows-Probleme
running scripts is disabled on this system: Ausführungspolitik. Siehe Schritt 1.SDK location not found:ANDROID_HOMEnicht für das Terminal festgelegt, in dem Gradle läuft. Starte das Terminal nach der Einstellung neu oder erstelleandroid\local.propertiesmitsdk.dir=C\:\\Users\\you\\AppData\\Local\\Android\\Sdk.Filename too longaus Git oder Gradle: lange Pfade aktivieren, Schritt 6.- Emulator hängt beim Start: Hypervisor nicht aktiviert oder Virtualisierung im BIOS deaktiviert.
gradlew: bad interpreterin CI:gradlewwurde mit CRLF-Zeilenenden committet. Beheben mit dem.gitattributesoben und neu normalisieren.EPERModer gesperrte Dateien währendbun install: Defender oder ein laufender Gradle-Daemon hält Dateien. Daemon stoppen mit.\gradlew.bat --stopund die Ausschlüsse hinzufügen.
Zusammenfassung
Windows deckt Android und die Web-Schicht end-to-end ab. Für iOS das Projekt lokal generieren, synchronisieren und die ios/ Ordner zu Capgo Build. Nimm Live Updates dazu, und dein Windows-Team veröffentlicht in beiden Stores, ohne einen einzigen Mac im Büro. Wenn du unter Windows lieber eine Linux-Shell nutzt, lies den Begleit-Guide zu der Verwendung von WSL2 für die Capacitor-Entwicklung.