跳到內容

首次執行

終端機視窗
android-emu-web

閘道預設監聽 127.0.0.1,連接埠 7300。如需使用其他連接埠,請參閱命令列。

啟動時,閘道會檢查 Android SDK、cmdline-tools、emulator、platform-tools、系統映像 system-images;android-34;google_apis;arm64-v8a,以及至少一個虛擬裝置(AVD)。它會按以下順序列印每個缺失項目及修復方法:

缺失項目 閘道的處理方式
Android SDK 或 cmdline-tools 列印 Google 命令列工具的下載頁面和解壓縮目錄。它不會自行下載。
emulator、platform-tools、系統映像 列印 sdkmanager 命令和大致大小,然後詢問 [y/N]。
無 AVD 提議建立名為 emu_web_default 的預設裝置(Pixel 5 設定,4096 MB RAM),然後詢問 [y/N]。

預設答案為 N。除非你輸入 y,否則不會下載或建立任何內容。如果你回答 N,閘道會列印相應命令供你自行執行,並繼續啟動。

使用 sdkmanager 安裝套件前,必須接受 Android SDK 授權條款。sdkmanager --licenses 會在終端機中顯示授權條款內容,你需要自行接受。

例如,手動安裝系統映像:

終端機視窗
sdkmanager "system-images;android-34;google_apis;arm64-v8a"

閘道每次啟動時都會建立一個新的隨機權杖,並在預設瀏覽器中開啟類似如下的位址:

https://droid.devpier.dev/app/#port=7300&token=<token>

連接埠和權杖位於 # 之後,因此瀏覽器不會將它們傳送到 Web 伺服器。頁面會將其儲存在瀏覽器中,並從位址列移除。如果你的預設瀏覽器不是 Chrome 或 Edge,請將終端機中顯示的位址複製到 Chrome 或 Edge 中開啟。

當頁面首次連接到你 Mac 上的閘道時,Chrome 會顯示一個權限提示,詢問是否允許 droid.devpier.dev 存取你的本機網路。請允許。Chrome 會記住該網站的選擇。

如果你拒絕了,請參閱疑難排解。

如果已有啟用 gRPC 的模擬器在執行,頁面會直接顯示其畫面。

否則,在清單中選擇一個裝置並啟動它。請參閱裝置。

點擊畫面以取得鍵盤焦點。然後:

  • 點擊即為輕觸;拖曳即為滑動。
  • 使用 Mac 鍵盤輸入。請參閱鍵盤與輸入。
  • 使用畫面上方的返回、首頁和最近使用按鈕。

在執行閘道的終端機中按 Ctrl+C。正在執行的模擬器會繼續執行。下次啟動閘道時,它會重新連接到這些模擬器。

閘道也在 http://127.0.0.1:7300/app/(或你選擇的連接埠)上提供相同的頁面。當公共頁面無法載入或無法連接時,可使用此頁面。