Zum Hauptinhalt springen

Capacitor-Entwicklung unter Windows: Der komplette Setup-Guide

Einrichtung von Capacitor unter Windows 11: Node oder Bun, JDK 21, Android Studio und Emulator, USB-Debugging, PowerShell-Fixes, Long-Path-Probleme und iOS-Builds ohne Mac mit Capgo Build.

Capacitor Entwicklung unter Windows: Einrichtung Capgo Blog-Illustration

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_HOME nicht für das Terminal festgelegt, in dem Gradle läuft. Starte das Terminal nach der Einstellung neu oder erstelle android\local.properties mit sdk.dir=C\:\\Users\\you\\AppData\\Local\\Android\\Sdk.
  • Filename too long aus Git oder Gradle: lange Pfade aktivieren, Schritt 6.
  • Emulator hängt beim Start: Hypervisor nicht aktiviert oder Virtualisierung im BIOS deaktiviert.
  • gradlew: bad interpreter in CI: gradlew wurde mit CRLF-Zeilenenden committet. Beheben mit dem .gitattributes oben und neu normalisieren.
  • EPERM oder gesperrte Dateien während bun install: Defender oder ein laufender Gradle-Daemon hält Dateien. Daemon stoppen mit .\gradlew.bat --stop und 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.

Live-Updates für Capacitor-Apps

Wenn ein Bug im Web-Layer live ist, liefere den Fix über Capgo aus, statt Tage auf die App-Store-Freigabe zu warten. Nutzer bekommen das Update im Hintergrund, während native Änderungen im normalen Review-Prozess bleiben.

Neues aus unserem Blog

Capgo gibt dir die besten Insights, um eine wirklich professionelle Mobile App zu erstellen.