メインコンテンツへスキップ

Capacitor Windowsでの開発:完全セットアップガイド

Windows 11でCapacitorをセットアップ: NodeまたはBun、JDK 21、Android Studioとエミュレーター、USBデバッグ、PowerShellの修正、長いパスの問題、そしてCapgo BuildによるMacなしでのiOSビルド。

Capacitor Windows での開発セットアップガイド Capgo ブログイラスト

ほとんどの 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_HOME Gradleを実行するターミナルに設定されていません。設定後にターミナルを再起動するか、作成してください。 android\local.properties を使用して sdk.dir=C\:\\Users\\you\\AppData\\Local\\Android\\Sdk.
  • Filename too long GitまたはGradleから:長いパスを有効にする。ステップ6を参照。
  • エミュレータが起動時にフリーズする:ハイパーバイザーが無効、またはBIOSの仮想化設定がオフになっています。
  • gradlew: bad interpreter CI環境での: 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開発.

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。