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

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

Ubuntu、Fedora、Archで完全なCapacitorワークフローを構築しましょう。NodeまたはBun、JDK、Android SDK、KVM対応エミュレータ、udevルールによるUSBデバイス設定、Capgo Buildを使ったMacなしのiOSビルドまでカバーします。

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

LinuxはCapacitorの作業に最適なプラットフォームです。WebレイヤーはNodeツールだけで、Androidツールはネイティブに動作し、KVMを使ったLinuxのエミュレータはWindows上の同じエミュレータより高速なことがよくあります。唯一のギャップはiOSです。XcodeはmacOSにしかないため、その部分にはクラウドビルドサービスが必要です。

このガイドでは、Ubuntu 24.04、Fedora 42、Archで検証済みの完全なLinuxセットアップを順に解説します。最後に、LinuxからiOSビルドを行う方法を扱います。 Capgo のビルド、Mac を所有せずに両ストアへリリースできます。

Linux で動作するものとしないもの

タスク Linux
Web開発、Vite、フレームワークツール はい
cap add android, cap sync, Gradleビルド はい
Androidエミュレーター はい、KVMで可能です
USB接続のAndroid実機 はい、udevルールを使用すれば可能です
Chrome DevTools によるリモートデバッグ はい
cap add ios, cap sync ios (生成してコピー) はい、ただしCocoaPodsがスキップされるという警告が出ます
iOS のコンパイル、署名、アーカイブ いいえ、macOS が必要です。Capgo Build を使用してください
iOS シミュレーター いいえ
iOS WebView 用 Safari Web Inspector いいえ

「No」の行にあるものはすべて、クラウドまたはTestFlightを使った実機iPhoneに移行します。最後に説明します。

1) Node または Bun をインストール

Capacitor の CLI には Node 20 以降が必要です。Bun はランタイム兼パッケージマネージャーとして動作し、インストールが高速です。

# Bun (recommended)
curl -fsSL https://bun.sh/install | bash

# Or Node via your package manager
# Ubuntu / Debian
sudo apt install -y nodejs npm
# Fedora
sudo dnf install -y nodejs
# Arch
sudo pacman -S nodejs npm

バージョンの確認:

bun --version
node --version

2) JDK のインストール

Capacitor 7 と 8 には JDK 21 が必要です。ディストリビューションのパッケージでも問題ありません。

# Ubuntu / Debian
sudo apt install -y openjdk-21-jdk

# Fedora
sudo dnf install -y java-21-openjdk-devel

# Arch
sudo pacman -S jdk21-openjdk

設定 JAVA_HOME における ~/.bashrc または ~/.zshrc。パスはディストリビューションによって異なります:

# Ubuntu / Debian
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
# Fedora
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk
# Arch
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk

複数の JDK がインストールされている場合、Gradle は JAVA_HOME が指すものを選択します。バージョンが誤っていると Unsupported class file major version 中に cap run android.

3) Android SDK のインストール

2つの方法があります。Android StudioならGUIツールが使えます。コマンドラインツールだけでもより軽量で、ビルドには十分です。

方法A: Android Studio

Android StudioのサイトからLinux用のtarballをダウンロードして展開します:

sudo tar -xzf android-studio-*.tar.gz -C /opt
/opt/android-studio/bin/studio.sh

初回起動時にセットアップウィザードが SDK を ~/Android/Sdk.

Capacitor の cap open android Studioのインストール先を指定する必要があります:

export CAPACITOR_ANDROID_STUDIO_PATH=/opt/android-studio/bin/studio.sh

方法B: コマンドラインツールのみ

mkdir -p ~/Android/Sdk/cmdline-tools
cd ~/Android/Sdk/cmdline-tools
# Download "Command line tools only" for Linux from the Android developer site, then:
unzip commandlinetools-linux-*.zip
mv cmdline-tools latest

シェルプロファイルに SDK を追加します:

export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator

Capacitor に必要なものをインストールし、ライセンスに同意します:

sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0" "emulator"
sdkmanager --licenses

プラットフォームのバージョンを compileSdkVersion 生成された android/variables.gradle. Capacitor 8 は 36 を使用、Capacitor 7 は 35 を使用。

4) エミュレータ用の KVM を有効にする

KVM がないとエミュレータは使えません。CPU が仮想化をサポートしているか確認してください:

egrep -c '(vmx|svm)' /proc/cpuinfo

結果が 0 より大きければサポートされています。KVM をインストールし、ユーザーにアクセス権を付与してください:

# Ubuntu / Debian
sudo apt install -y qemu-kvm
# Fedora
sudo dnf install -y qemu-kvm
# Arch
sudo pacman -S qemu-base

sudo usermod -aG kvm $USER

ログアウトして再ログインします。デバイスを作成して起動します:

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

エミュレータが権限についてエラーを出す場合は、 /dev/kvm グループの変更がまだ反映されていません。再起動してください。

5) 実機の USB アクセス

Linux ではデフォルトで一般ユーザーが USB デバイスにアクセスできません。udev ルールを追加してください:

sudo tee /etc/udev/rules.d/51-android.rules > /dev/null <<'EOF'
SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="04e8", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="2a70", MODE="0666", GROUP="plugdev"
EOF
sudo udevadm control --reload-rules
sudo usermod -aG plugdev $USER

上記のベンダー ID は Google、Samsung、OnePlus をカバーしています。お使いの端末の ID は次で確認してください: lsusb 端末が一覧にない場合は、USB デバッグを有効にして接続し、フィンガープリントのプロンプトを承認してから、次を実行してください:

adb devices

6) 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 Linux 上で実行すると CocoaPods が利用できないという警告が表示されます。これは想定内の動作です。 ios/ フォルダは依然として作成され、Capgo Build が後でコンパイルする対象となります。

エミュレーターまたはデバイスで実行します:

bunx cap run android

ChromeでWebViewをデバッグするには: chrome://inspect.

7) Linux でのリリースビルド

Android のリリースビルドは完全にローカルで実行されます。JDK の keytool:

keytool -genkeypair -v -keystore release.jks -keyalg RSA -keysize 2048 -validity 10000 -alias release

次にビルドします:

cd android
./gradlew bundleRelease

AAB は android/app/build/outputs/bundle/release/に配置されます。ラップトップに署名キーを保存したくない場合は、 Capgo のAndroid向けBuild keystore を一度保存し、iOS で使用するのと同じ CLI からクラウドでビルドします。

8) Capgo Build を使った Linux からの iOS

これはLinuxだけではできないステップです。ワークフローは次のとおり:

  1. Webアセットをビルドし、以下に同期: ios/.
  2. iOSの署名認証情報を一度保存するだけです。
  3. クラウドビルドをリクエストします。Capgo がコンパイルと署名を行い、TestFlightへアップロードできます。
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 認証情報について順を追って案内します。Linuxでは、Appleポータルで App Store Connect の API キーを手動で作成します。その iOSビルドガイド クリック操作をすべて示します。配布用証明書に Keychain Access は一切不要です。CSRを生成し、 .p12 OpenSSLで、次の説明に従って iOS証明書とプロビジョニングプロファイルの解説、または次を使用: iOS証明書ジェネレーター.

ログはターミナルにリアルタイムで流れます。LinuxからTestFlightまでの全フローの詳細は CapacitorとCapgo BuildでLinuxからiOSアプリをビルド.

9) Live Updateでネイティブ再ビルドをスキップ

ネイティブシェルがストアに公開された後は、日常のほとんどの変更はJavaScript、HTML、CSSです。これらはLinuxから数秒で配信できます。 Capgo Live Update:

bunx @capgo/cli@latest init
bun run build
bunx @capgo/cli@latest bundle upload --channel production

ネイティブビルドは、プラグイン変更、権限変更、およびCapacitorのアップグレードに限定してください。

Linuxでよくある問題

  • SDK location not found: ANDROID_HOME Gradleを実行するシェルにエクスポートされていません。プロファイルに追加して新しいターミナルを開くか、を作成してください。 android/local.properties を使用して sdk.dir=/home/you/Android/Sdk.
  • Unsupported class file major version:JDK が違います。 JAVA_HOME JDK 21 を指定してください。
  • エミュレータの画面が黒い、または非常に遅い:KVM が無効です。確認してください。 ls -l /dev/kvm およびグループのメンバーシップ。
  • adb devices 表示 no permissions:udevルールが見つからないか、リロードされていません。リロード後にデバイスを抜き差ししてください。
  • Gradleデーモンがメモリ不足になる:追加 org.gradle.jvmargs=-Xmx4g まで android/gradle.properties.
  • WaylandとAndroid Studioの不具合:Studioを次のコマンドで起動 _JAVA_AWT_WM_NONREPARENTING=1 ウィンドウが空白のままの場合。

まとめ

LinuxはAndroidとWebレイヤーのCapacitorループをネイティブで処理でき、他のデスクトップ環境より速いことも多いです。iOSはローカルでプロジェクトを生成してアセットを同期し、macOS側の処理はCapgo Buildに任せましょう。これにLive Updatesを組み合わせれば、Xcodeを意識するのはAppleがSDKの最小要件を変更したときだけになります。

Capacitor アプリ向けの Live Updates

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

最新のブログ記事

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