疑難排解

Chrome 封鎖了本機網路存取

droid.devpier.dev 上的頁面會連接到你自己 Mac 上的閘道。Chrome 在首次連接時會要求權限。如果你拒絕了，頁面無法連接，在幾次失敗嘗試後，它會告知你 Chrome 封鎖了對你 Mac 的存取。

重新允許的方法：

1. 開啟 Chrome 設定 → 隱私權和安全性 → 網站設定。
2. 找到 droid.devpier.dev，允許本機網路存取。
3. 重新載入頁面。

如果仍然無法連接，請使用本機備用頁面。

連接埠已被佔用

閘道預設監聽連接埠 7300。如果另一個程式已使用該連接埠，閘道無法在此連接埠啟動。查找該程式：

lsof -nP -iTCP:7300 -sTCP:LISTEN

停止該程式，或在其他連接埠啟動閘道：

android-emu-web --port 7301

閘道會將新連接埠寫入它開啟的位址，頁面會連接到正確的連接埠。

未找到模擬器

如果頁面提示未找到正在執行的模擬器：

• 確認模擬器是否在執行：adb devices 應該列出 emulator-5554 或類似內容。
• 確認它是否在啟用 gRPC 的情況下啟動（-grpc <port>）。閘道無法讀取未啟用 gRPC 的模擬器的畫面。

你也可以從頁面的清單中啟動裝置。請參閱裝置。

未找到模擬器時，閘道會繼續執行並在終端機中列印原因。

如果閘道回報 Android SDK、emulator、platform-tools 或系統映像缺失，請按照它列印的修復方法操作。請參閱首次執行。

“sdkmanager” 缺失

Android Studio 安裝的 SDK 可能不包含 cmdline-tools（提供 sdkmanager 和 avdmanager）。閘道不會下載它。請從 developer.android.com 下載 Google 命令列工具並解壓縮，確保以下路徑存在：

<your SDK>/cmdline-tools/latest/bin/sdkmanager

權杖已過期

閘道每次啟動時都會建立新權杖。如果你重新啟動了閘道，仍持有舊權杖的頁面會顯示權杖已失效並停止重試。請開啟閘道列印的新連結，或重新執行閘道。

頁面提示閘道或頁面已過期

• 閘道已過期： 執行頁面顯示的升級命令。與安裝命令相同。
• 頁面已過期： 用 Cmd+Shift+R 強制重新整理頁面。

瀏覽器不正確

該頁面僅在 Chrome 和 Edge 中有效。在其他瀏覽器中，它會要求你切換，並不會嘗試連接。請參閱瀏覽器支援。

使用本機備用頁面

閘道在 http://127.0.0.1:7300/app/（或你選擇的連接埠）上提供相同的頁面。當公共頁面無法載入或本機網路存取被拒絕時，可使用此頁面。

畫面停止更新

如果模擬器結束或重新啟動，頁面會顯示已中斷連線。閘道繼續執行。當模擬器恢復後，頁面會重新連接，畫面也會恢復。