要在 Android 上开启开发者模式，请打开 设置 > 关于手机 并点击 版本号 连续七次，然后输入 PIN 码。此时 开发者选项 菜单将出现，你可以在其中开启 USB 调试 或 无线调试 以便 Android Studio adb 或 bunx cap run android 能够安装并调试你的 App。由于“版本号”的具体路径取决于厂商，各品牌的具体步骤如下。
开发者选项的作用（以及局限性）
开发者选项是一个专为应用开发者设计的隐藏设置菜单。开启它本身不会产生任何影响，它只是会显示如下开关：
- USB 调试：允许受信任的计算机运行
adb命令、安装 build 并读取 logs。 - 无线调试：通过 Wi-Fi 实现相同功能 (Android 11+)。
- 不锁定屏幕：充电时屏幕保持常亮，方便测试时使用。
- 动画缩放：加速或关闭系统动画，对 UI 测试非常有用。
- 不保留活动：退出时销毁 activity，是测试 Capacitor 应用状态恢复的绝佳方式。
- 显示点击操作 / 指针位置：非常适合录制演示视频和检查触摸目标。
您 不 需要开启开发者选项即可通过浏览器或文件管理器安装 APK、使用大多数应用或接收 OTA 更新。
按品牌开启开发者选项
| 品牌 | 在哪里连续点击 7 次 | 随后菜单出现的位置 |
|---|---|---|
| Google Pixel / 原生 Android | 设置 > 关于手机 > 版本号 | 设置 > 系统 > 开发者选项 |
| 三星 (One UI) | 设置 > 关于手机 > 软件信息 > 版本号 | 设置 > 开发者选项 (位于列表底部) |
| 小米, Redmi, POCO (HyperOS) | 设置 > 关于手机 > 系统版本 | 设置 > 更多设置 > 开发者选项 |
| 小米 (旧版 MIUI) | 设置 > 关于手机 > MIUI 版本 | 设置 > 其他设置 > 开发者选项 |
| 一加 (OxygenOS) | 设置 > 关于设备 > 版本 > 版本号 | 设置 > 系统设置 > 开发者选项 |
| OPPO / realme (ColorOS / realme UI) | 设置 > 关于设备 > 版本 > 版本号 | 设置 > 其他设置 > 开发者选项 |
| 摩托罗拉 | 设置 > 关于手机 > 版本号 | 设置 > 系统 > 开发者选项 |
| 华为 / Honor (EMUI / MagicOS) | 设置 > 关于手机 > 版本号 | 设置 > 系统和更新 > 开发者选项 |
菜单可能会随 OS 版本变化。如果找不到“版本号”，请打开设置并使用搜索框：输入“版本号”。在几乎所有 Android 设备上，搜索都能直接找到它。
Google Pixel (Android 14, 15, 16)
- 打开 设置 并滚动至 关于手机.
- 滚动到底部并点击 版本号 连续点击七次。稍后你会看到一个倒计时提示。
- 输入你的 PIN 码、图案或密码。
- 返回至 设置 > 系统 > 开发者选项.
三星 Galaxy
- 打开 设置 > 关于手机 > 软件信息.
- 点击 版本号 七次，并使用你的 PIN 码进行确认。
- 开发者选项 现在出现在主设置列表的最底部，位于“关于手机”下方。
小米、Redmi 和 POCO
- 打开 设置 > 关于手机.
- 点击 OS 版本 (HyperOS) 或 MIUI 版本 (旧款设备) 七次。
- 前往 设置 > 更多设置 > 开发者选项.
小米还增加了两个开发时通常需要的额外开关： 通过 USB 安装 和 USB 调试（安全设置）。如果不开启“通过 USB 安装”， adb install 会报错： INSTALL_FAILED_USER_RESTRICTED。开启这些选项可能需要登录小米账号并插入 SIM 卡。
OnePlus、OPPO 和 realme
- 打开 设置 > 关于设备 > 版本.
- 点击 版本号 七次。
- 打开 设置 > 系统设置 > 开发者选项 (OnePlus) 或 设置 > 其他设置 > 开发者选项 (OPPO, realme)。
华为和荣耀
- 打开 设置 > 关于手机.
- 点击 版本号 七次。
- 前往 设置 > 系统和更新 > 开发者选项.
在华为设备上，还需将 USB 连接模式设置为 文件传输 后再进行连接，否则 adb 可能无法识别设备。如果你打算向这些手机用户发布应用，请阅读 如何在 Huawei AppGallery 上发布 Capacitor 应用，因为其中许多设备没有 Google Play 服务。
工作资料与受管设备
如果你的手机由公司管理，管理员可能会禁用开发者选项。你会看到“此用户无法使用开发者选项”。请向 IT 部门申请测试设备，而不是尝试绕过策略。
开启 USB 调试
- 打开 开发者选项 并开启 USB 调试.
- 使用支持数据传输的 USB 线连接手机（许多廉价线缆仅支持充电）。
- 在手机上，确认 允许 USB 调试吗？ 对话框。勾选 始终允许来自此计算机的连接 并在你的设备上确认。
- 在电脑上，检查连接状态：
adb devices你应该看到：
List of devices attached
R5CT1234ABC deviceunauthorized 表示你未接受 prompt。 offline 通常意味着线缆或接口故障，或者 adb 旧版 SDK 的服务器。
adb 随 Android SDK Platform-Tools 一起发布。如果已安装 Android Studio，它位于 ~/Library/Android/sdk/platform-tools 在 macOS 上或 %LOCALAPPDATA%\Android\Sdk\platform-tools 在 Windows 上。将该文件夹添加到你的 PATH。刚接触 Android 工具链？我们的 针对 Capacitor 应用的 Android 设置指南 涵盖了这些内容。
开启无线调试 (Android 11 及更高版本)
无线调试可以摆脱线缆。你的电脑和手机必须处于同一个 Wi-Fi 网络下，部分公司或酒店网络会拦截设备间的流量。
- 在 开发者选项中，打开 无线调试 并接受网络提示。
- 点击 无线调试 打开它，然后 使用配对 code 配对设备。请保持此屏幕开启。
- 在电脑上，使用配对对话框中显示的 IP 地址和端口进行配对：
adb pair 192.168.1.42:37145
# Enter pairing code: 482913- 使用无线调试主界面显示的 IP 和端口进行连接（该端口与配对端口不同）：
adb connect 192.168.1.42:41827
adb devicesAndroid Studio 还有 通过 Wi-Fi 配对设备 功能，它会显示一个 QR code，你只需扫描无线调试界面上的即可。
每次无线调试重启时端口都会变化，因此在 adb connect 重启后需要重复此操作。配对信息会被记录。
在 Android 10 及更早版本上，请使用旧方法：先通过 USB 连接，运行 adb tcpip 5555，拔掉线缆，然后 adb connect <phone-ip>:5555.
在设备上运行你的 Capacitor 应用
当设备出现在 adb devices列表中时，Capacitor CLI 可以直接进行 build 和安装：
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC为了获得更快的开发循环，请使用 live reload，让应用通过网络加载你的 dev server：
bunx cap run android -l --external此功能需要手机能够访问你电脑的 IP。如果你希望网络外的测试人员无需重新安装即可查看更改，请查看 Capgo Live Updates 而不是使用 dev server。
要在应用运行时查看 native logs：
adb logcat | grep -i -E "capacitor|chromium"若要调试 WebView，请打开 chrome://inspect 并在运行 debug build 时使用桌面版 Chrome。Capacitor 应用的 debug build 默认开启 WebView 调试功能。
故障排除
连续点击版本号没有反应。 可能是你点错了字段（例如点了 Android 版本而非版本号），或者设备受组织管理。部分小米设备需要点击“OS 版本”而非“版本号”。
设备未在以下位置显示： adb devices.
adb kill-server
adb start-server
adb devices尝试更换数据线，并直接连接电脑端口而非使用集线器。将 USB 连接模式切换为 文件传输.
Windows 无法识别手机。 请安装 OEM USB 驱动（三星、小米等厂商提供自有驱动），或通过 SDK Manager 为 Pixel 设备安装 Google USB Driver。
INSTALL_FAILED_UPDATE_INCOMPATIBLE. 已安装的应用使用了不同的签名密钥（例如 Play Store 版本与你的 debug build 不同）。请先卸载它： adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED 在小米设备上。 启用 通过 USB 安装 在开发者选项中。
无线调试不断自动关闭。 切换 Wi-Fi 网络时 Android 会自动关闭该功能。部分电池优化设置也会导致此问题。在进行长时间调试时，请确保手机连接在同一网络并保持充电状态。
更新 Android Studio 后显示未授权。 adb 密钥位于 ~/.android/adbkey 发生变化。在开发者选项中点击 撤销 USB 调试授权，重新连接并再次接受提示即可。
如何关闭开发者选项
- 打开 开发者选项.
- 切换 使用开发者选项 (或 开发者选项 在三星设备上) 将顶部的开关关闭。
在某些设备上，该菜单仍会显示，但内部的所有开关都会重置为默认值。若要完全隐藏该菜单，请前往 设置 > 应用 > 设置 > 存储 并清除“设置”应用的存储空间。这也会重置其他设置偏好，因此通常不建议这样做。
在将测试机交给他人之前，请点击 撤销 USB 调试授权 以防止旧电脑再次连接。
安全提示
- USB 调试允许已授权的计算机安装应用，并从可调试构建中读取应用数据。不要在公共充电站或你不信任的计算机上接受 RSA 提示。
- 某些银行和支付应用在开启开发者选项或 USB 调试时会拒绝运行。用完后，请在个人手机上关闭它们。
- 切勿发布包含以下内容的 Release 构建：
android:debuggable="true". Capacitor Release 构建默认不可调试。
iOS 上的对应操作
iPhone 也有自己的 开发者模式 开关，在运行开发构建或 ad hoc 构建前需要开启。请参阅 如何在 iOS 上开启开发者模式。想不用数据线把构建装到测试人员的手机上，请阅读 如何把 iOS 和 Android 应用分发给测试人员.
