首次运行
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/（或你选择的端口）上提供相同的页面。当公共页面无法加载或无法连接时，可使用此页面。