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

WindowsとLinuxからAndroidでCapacitor Live Reloadを使う

WindowsまたはLinuxマシンから、AndroidエミュレーターやUSB接続のスマートフォンで即座にリロードする方法: server.url設定、10.0.2.2、adb reverse、ファイアウォールルール、cleartextトラフィック、そして開発用設定を本番に含めないためのコツ。

Capacitor Android でのライブリロード (Windows/Linux 対応) Capgo ブログ イラスト

ライブリロードは、遅いビルド・同期・実行のループを「保存して確認する」に変えます。Mac では Capacitor CLI の --live-reload フラグはほぼそのまま動作します。Windows と Linux でも同じフラグは機能しますが、ファイアウォール、エミュレータのネットワーク設定、USB ルーティングが「リロードされない」報告の大半の原因です。このガイドでは各ケースを解説します。

Capacitor における live reload の仕組み

通常、ネイティブアプリは dist/ APK内からロードされます。一方、 server.url を設定すると、WebViewはAPK内ではなく、ViteやフレームワークのdevサーバーのURLからロードされるようになります。これにより、デスクトップブラウザとまったく同じように Hot module replacement が動作します。ネイティブ側は何も変わらず、変わるのはページのオリジンだけです。

2つの注意点:

  • デバイスはコンピュータにネットワークアクセスできる必要があります。
  • 平文の http:// には cleartext: trueが必要です。Android はデフォルトで cleartext 通信をブロックするためです。

オプションA: CLI フラグ

Capacitor CLI を使えば、1回の実行でこれを設定できます:

bun run dev -- --host 0.0.0.0 &
bunx cap run android --live-reload --host 192.168.1.20 --port 5173

ホストをコンピュータのLAN IPに置き換えてください。CLI は一時的な設定を書き込み、アプリを起動してから設定を元に戻します。devサーバーが別のポートを使っている場合は、そのポートを指定してください。

これが最も素早い方法です。このガイドの残りは、デバッグしやすく、どのフレームワークの dev server でも動作する明示的な設定を使用します。

オプションB: 明示的な設定

すべてのインターフェースにバインドして dev server を起動します:

# Vite
bun run dev -- --host 0.0.0.0
# Angular
bunx ng serve --host 0.0.0.0
# Next.js
bun run dev -- -H 0.0.0.0

次に、開発専用の Capacitor 設定を作成します。Capacitor は読み取ります capacitor.config.ts、環境変数で切り替えます:

import type { CapacitorConfig } from '@capacitor/cli';

const liveReloadUrl = process.env.CAP_LIVE_RELOAD_URL;

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'my-app',
  webDir: 'dist',
  ...(liveReloadUrl
    ? { server: { url: liveReloadUrl, cleartext: true } }
    : {}),
};

export default config;

変数を設定して実行します:

CAP_LIVE_RELOAD_URL=http://10.0.2.2:5173 bunx cap sync android
bunx cap run android

Windows PowerShell の場合:

$env:CAP_LIVE_RELOAD_URL="http://10.0.2.2:5173"; bunx cap sync android
bunx cap run android

変数を設定しないと、 cap sync 通常の config が書き込まれ、リリースビルドは安全です。

エミュレータ: 10.0.2.2 を使用

Android エミュレータ内では、 10.0.2.2 があなたのコンピュータです。トラフィックがマシン外に出ないため、Windows でも Linux でもファイアウォールの設定変更なしで動作します。それでも失敗する場合は、dev server が以下にバインドされていることを確認してください。 0.0.0.0 それだけでなく、 127.0.0.1ループバックにバインドされたサーバーは、エミュレーターの仮想ネットワークからはアクセスできません。

USB接続端末: adb reverse

実機で最もクリーンな選択肢はこちらで、Wi-Fiもファイアウォールルールも不要です:

adb reverse tcp:5173 tcp:5173

次に、 localhost:5173 スマホ側でPCを指すようにします。URLをそれに合わせて設定してください:

CAP_LIVE_RELOAD_URL=http://localhost:5173 bunx cap sync android

adb reverse デバイスが再接続するとクリアされるため、ケーブルを抜いた後に再実行してください。CLI が自動でやってくれます: bunx cap run android --live-reload --host localhost --port 5173 --forwardPorts 5173:5173。Linuxユーザーは、以下のページにあるudevルールが必要です: Linuxセットアップガイド の前に adb でスマホを認識させます。

Wi-Fi接続端末: LAN IPとファイアウォール

USBが使えない場合は、PCのLAN IPを使用してポートを開放してください。

IPの確認方法:

# Linux
ip -4 addr show | grep inet
# Windows
ipconfig

Windowsでポートを開放します。管理者権限で起動したPowerShellから:

netsh advfirewall firewall add rule name="Vite dev server" dir=in action=allow protocol=TCP localport=5173

Windowsのパブリックネットワークプロファイルでは、企業環境によってはルールがあっても受信接続がブロックされます。スマホからまだ接続できない場合は、設定でWi-Fiネットワークを「プライベート」に切り替えてください。

Linux (ufwを使用している場合):

sudo ufw allow 5173/tcp

Fedora (firewalldを使用している場合):

sudo firewall-cmd --add-port=5173/tcp

次に:

CAP_LIVE_RELOAD_URL=http://192.168.1.20:5173 bunx cap sync android
bunx cap run android

両方のデバイスが同じサブネットにある必要があります。ゲスト用Wi-Fiはクライアントを分離することが多く、ファイアウォールの問題とまったく同じに見えます。

WSL2の注意点

ViteをWSL2内で実行している場合、Windowsホストはポートを自動的に公開しません。mirrored networkingを有効にしてください: .wslconfig またはWindows側でポートプロキシを追加します。詳細は次の WSL2ガイド.

HMR WebSocket の問題

ページは読み込まれるが変更が反映されない場合、HMR WebSocket が誤ったホストに接続しようとしています。Vite にパブリックアドレスを指定してください:

// vite.config.ts
export default defineConfig({
  server: {
    host: '0.0.0.0',
    hmr: {
      host: '192.168.1.20', // or 10.0.2.2 for the emulator
      port: 5173,
    },
  },
});

Angular や Next.js にも同様のオプションがあります。症状は同じで、修正方法は WebSocket ホストを固定することです。

Chrome DevTools でのデバッグ

開く chrome://inspect PCのChromeまたはEdgeで。WebViewは、開発サーバーURL付きのデバイスの下に表示されます。WindowsでもLinuxでも、コンソール、ネットワーク、ソース、ブレークポイントが利用できます。デバイスが表示されない場合は、 adb devices USBデバッグが許可されていることを確認してください。

開発設定を本番にリリースしない

が設定されたリリースビルドは、存在しないマシンから読み込もうとして、アプリが白画面になります。これを防ぐには: server.url 上記の環境変数パターンを使用し、デフォルト設定に

  • ブロックが含まれないようにしてください。 server ブロック。
  • ビルドされた成果物に android/app/src/main/assets/capacitor.config.json を含む "url".
  • また、 Capgo Live Updateも使用している場合は、次の点に注意してください。 server.url 設定がアップデーターのbundleを上書きするため、2つのワークフローは分けて管理してください。

まとめ

AndroidでのLive reloadは、WindowsとLinuxからでも、次の3点を押さえれば動作します。dev serverをすべてのインターフェースにバインドし、デバイスから実際に到達できるアドレスを選ぶ(10.0.2.2 エミュレーターの場合は、 adb reverse USBの場合はLAN IP、Wi-Fiの場合はファイアウォールルールを設定)、dev設定はリリースビルドに含めないでください。Androidでイテレーションループが速くなれば、共有WebレイヤーはiOSに届く前に、次の経路を通じてテスト済みです Capgo のビルド.

Capacitor アプリ向けの Live Updates

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

最新のブログ記事

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