ライブリロードは、遅いビルド・同期・実行のループを「保存して確認する」に変えます。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 のビルド.