首次執行
1. 啟動閘道
Section titled “1. 啟動閘道”android-emu-web閘道預設監聽 127.0.0.1,連接埠 7300。如需使用其他連接埠,請參閱命令列。
2. 讓閘道檢查 Android SDK
Section titled “2. 讓閘道檢查 Android SDK”啟動時,閘道會檢查 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"3. 開啟頁面
Section titled “3. 開啟頁面”閘道每次啟動時都會建立一個新的隨機權杖,並在預設瀏覽器中開啟類似如下的位址:
https://droid.devpier.dev/app/#port=7300&token=<token>連接埠和權杖位於 # 之後,因此瀏覽器不會將它們傳送到 Web 伺服器。頁面會將其儲存在瀏覽器中,並從位址列移除。如果你的預設瀏覽器不是 Chrome 或 Edge,請將終端機中顯示的位址複製到 Chrome 或 Edge 中開啟。
4. 允許本機網路存取
Section titled “4. 允許本機網路存取”當頁面首次連接到你 Mac 上的閘道時,Chrome 會顯示一個權限提示,詢問是否允許 droid.devpier.dev 存取你的本機網路。請允許。Chrome 會記住該網站的選擇。
如果你拒絕了,請參閱疑難排解。
5. 使用模擬器
Section titled “5. 使用模擬器”如果已有啟用 gRPC 的模擬器在執行,頁面會直接顯示其畫面。
否則,在清單中選擇一個裝置並啟動它。請參閱裝置。
點擊畫面以取得鍵盤焦點。然後:
- 點擊即為輕觸;拖曳即為滑動。
- 使用 Mac 鍵盤輸入。請參閱鍵盤與輸入。
- 使用畫面上方的返回、首頁和最近使用按鈕。
在執行閘道的終端機中按 Ctrl+C。正在執行的模擬器會繼續執行。下次啟動閘道時,它會重新連接到這些模擬器。
本機備用頁面
Section titled “本機備用頁面”閘道也在 http://127.0.0.1:7300/app/(或你選擇的連接埠)上提供相同的頁面。當公共頁面無法載入或無法連接時,可使用此頁面。