ほとんどの Capacitor ドキュメントは Mac を前提としています。Windows で開発する場合、Web レイヤーと Android は同じように動作しますが、PowerShell、パスの長さ、エミュレーター周辺には Windows 特有の落とし穴があります。iOS は Windows ではコンパイルできない唯一の部分であり、その解決策はクラウド上の macOS ビルドです。
このガイドは、空の環境から始まり、デバイスでの Android ビルド、そして TestFlight での iOS ビルドに至るまでの Windows 11 の完全なセットアップ手順です。 Capgo のビルド.
Windowsでできること、できないこと
| タスク | Windows |
|---|---|
| Web開発、Vite、フレームワークツール | はい |
cap add android, cap sync, Gradleビルド |
はい |
| Androidエミュレーター | はい、Hyper-VまたはWHPXを使用 |
| USB接続のAndroid実機 | はい |
| Chrome DevTools によるリモートデバッグ | はい |
cap add ios, cap sync ios (生成してコピー) |
はい(CocoaPods の警告あり) |
| iOS のコンパイル、署名、アーカイブ | いいえ、macOS が必要です。Capgo Build を使用してください |
| iOS シミュレーター | いいえ |
| iOS WebView 用 Safari Web Inspector | いいえ |
1) Node または Bun をインストール
使用する winget PowerShell から:
winget install OpenJS.NodeJS.LTS
# Or Bun
winget install Oven-sh.Bun
新しいターミナルを開いて確認してください:
node --version
bun --version
PowerShellの実行ポリシーを修正する
bunx cap, npx cap そして、ほとんどの CLI shim は .ps1 スクリプトです。新しい Windows では、これらが次のポリシーでブロックされます running scripts is disabled on this system。ローカルスクリプトを一度だけ許可してください:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
2) JDK 21をインストールする
Capacitor 7 と 8 には JDK 21 が必要です。Android Studio には独自の JBR が同梱されていますが、ターミナルから Gradle を実行するときの予期せぬ問題を避けるには、システム JDK を用意しておくのがおすすめです。
winget install Microsoft.OpenJDK.21
設定 JAVA_HOME ユーザー単位で設定します。PowerShell から:
[Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Microsoft\jdk-21.0.8.9-hotspot", "User")
インストールしたバージョンに合わせてフォルダを調整してください。その後、ターミナルを再起動してください。
3) Android StudioとSDKをインストールする
winget install Google.AndroidStudio
Android Studioを起動し、セットアップウィザードで SDK をインストールします。 C:\Users\<you>\AppData\Local\Android\Sdk次に、Gradle と Capacitor が参照する環境変数を設定します:
$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")
Android Studioの SDK Managerを開き、Capacitor のバージョンに合ったプラットフォームをインストールします:Capacitor 8には API 36、Capacitor 7には API 35です。
4) エミュレーターを高速化する
エミュレータにはハードウェア仮想化が必要です。Windows 11ではエミュレータはWindows Hypervisor Platformを使用します。有効にするには:
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform
再起動します。Android StudioのDevice Managerで依然としてアクセラレーションの警告が出る場合は、BIOSまたはUEFIで仮想化が有効になっているか、古いCPUではコア分離(メモリ整合性)が妨げていないかを確認してください。
Device Manager、またはターミナルからデバイスを作成します:
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) WindowsでのUSBデバッグ
端末で開発者向けオプションとUSBデバッグを有効にします。最近の端末はほとんどドライバー不要ですが、 adb devices が空のままの場合は、SDK Manager(SDK Toolsタブ)からGoogleのUSBドライバーを、Samsungデバイスならベンダードライバーをインストールしてください。
adb devices
初回は端末に表示されるフィンガープリントの確認ダイアログを許可してください。
6) Windows固有のプロジェクト修正
Windowsで時間を節約する3つの設定:
長いパス。 Gradle と node_modules は 260 文字の制限を超える可能性があります。長いパスを一度だけ有効にしてください:
git config --global core.longpaths true
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
2 番目のコマンドには、管理者権限付きの PowerShell が必要です。
Defender の除外設定。 のリアルタイムスキャン node_modules、Gradle キャッシュと Android の SDK はビルドを目に見えて遅くします。Windows セキュリティで、または管理者として実行した PowerShell からこれらのフォルダーを除外してください:
Add-MpPreference -ExclusionPath "$env:USERPROFILE\.gradle"
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Android\Sdk"
Add-MpPreference -ExclusionPath "C:\dev"
プロジェクトは、次のような短いパスに配置してください C:\dev\my-app、OneDrive で同期しているドキュメントの下には置かないでください。
改行コード。 Gradle の gradlew シェルスクリプトはLF改行を維持しないとLinux CIが壊れます。次を追加: .gitattributes:
*.sh text eol=lf
gradlew text eol=lf
7) Capacitorプロジェクトを作成する
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 WindowsではCocoaPodsが利用できないと警告が出ます。これは想定内です。この ios/ フォルダは引き続き生成・コミットされ、クラウドビルドは pod install 後で実行されます。
エミュレーターまたはUSBデバイスで実行:
bunx cap run android
ChromeでWebViewをデバッグするには: chrome://inspect.
8) Android リリースビルド
keytool -genkeypair -v -keystore release.jks -keyalg RSA -keysize 2048 -validity 10000 -alias release
cd android
.\gradlew.bat bundleRelease
AABはここにあります: android\app\build\outputs\bundle\release\チームなら、keystoreは一度 Capgo に保存してクラウドでビルドするのがおすすめです。詳細は Capgo のAndroid向けBuild.
9) Capgo Build で Windows から iOS をビルド
XcodeはmacOS専用なので、iOSのコンパイルはCapgoのMacインフラ上で実行されます。Windowsのターミナルからは次のとおりです:
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 署名用の素材を収集します。Windowsでは、App Store ConnectのAPIキーを、以下の手順に従ってAppleポータルで手動で作成します。 iOSビルドガイド配布用証明書にKeychain Accessは不要です。CSRを作成し、 .p12 OpenSSL(winget install ShiningLight.OpenSSL.Light)またはブラウザベースの iOS証明書ジェネレーター。手順の詳細は Capacitor と Capgo Build を使って Windows から iOS アプリをビルドする.
ビルドが完了すると、Capgo が TestFlight にプッシュし、数分後に実機 iPhone にインストールできます。
10) 再ビルドなしで Web の変更を反映
両ストアが公開されたら、 Capgo Live Update JavaScript、HTML、CSSの変更には:
bunx @capgo/cli@latest init
bun run build
bunx @capgo/cli@latest bundle upload --channel production
ネイティブの再ビルドは、プラグイン、権限、Capacitor のアップグレード時のみ必要です。
Windowsでよくある問題
running scripts is disabled on this system:実行ポリシー。ステップ1を参照してください。SDK location not found:ANDROID_HOMEGradleを実行するターミナルに設定されていません。設定後にターミナルを再起動するか、作成してください。android\local.propertiesを使用してsdk.dir=C\:\\Users\\you\\AppData\\Local\\Android\\Sdk.Filename too longGitまたはGradleから:長いパスを有効にする。ステップ6を参照。- エミュレータが起動時にフリーズする:ハイパーバイザーが無効、またはBIOSの仮想化設定がオフになっています。
gradlew: bad interpreterCI環境での:gradlewが CRLF 改行でコミットされました。以下で修正してください.gitattributes上記を実行して、正規化し直してください。EPERMまたは、~中にロックされたファイルbun install:Defender または実行中の Gradle デーモンがファイルを保持しています。デーモンを停止するには.\gradlew.bat --stopを実行し、除外設定を追加してください。
まとめ
Windows では Android と Web レイヤーをエンドツーエンドでカバーできます。iOS の場合は、ローカルでプロジェクトを生成し、同期して渡します ios/ Capgo Build用のフォルダに。Live Updateを組み合わせれば、WindowsチームはオフィスにMacが一台もなくても両ストアにリリースできます。Windows上でLinuxシェルを使う場合は、以下の関連ガイドを参照してください。 WSL2を使ったCapacitor開発.