要在 Android 设备上启用开发者模式，打开 设置 > 关于手机 并点击 构建号 七次，然后输入您的 PIN。 A 开发者选项 菜单出现，您可以开启 USB 调试 或 USB 调试 Wireless 调试 adb 或 bunx cap run android 所以 Android Studio
可以安装和调试您的应用。具体到 Build 号的路径取决于制造商，因此每个品牌的步骤如下。
Android 开发者选项是什么 (以及它们不是什么)
- USB 调试Android 开发者选项是一个隐藏的设置菜单，专门为应用开发者设计。打开它本身不会产生任何效果。它只会显示一些 switch，如:
adb:允许信任的计算机运行命令、安装构建和读取日志。 - USB 调试通过 Wi-Fi (Android 11+) 同时启用 (Android 11+)。
- 保持唤醒屏幕充电时保持唤醒，测试时很有用。
- 动画比例控制系统动画的速度，UI 测试时有用。
- 不保留活动销毁活动，当你离开它们时，Capacitor app 的状态恢复测试很有用。
- 显示点击 / 指针位置用于录制演示和检查触摸目标。
你 不 需要开发者选项来从浏览器或文件管理器安装 APK，使用大多数应用或接收 OTA 更新。
通过品牌启用开发者选项
| 品牌 | 7 次点击的位置 | 菜单出现的位置 |
|---|---|---|
| 谷歌像素 / stock Android | 设置 > 关于手机 > 构建号 | 设置 > 系统 > 开发者选项 |
| 三星 (One UI) | 设置 > 关于手机 > 软件信息 > 构建号 | 设置 > 开发者选项 (列表底部) |
| 小米、红米、POCO (HyperOS) | 设置 > 关于手机 > 系统版本 | 设置 > 高级设置 > 开发者选项 |
| 小米 (旧版 MIUI) | 设置 > 关于手机 > MIUI 版本 | 设置 > 高级设置 > 开发者选项 |
| 一加 (OxygenOS) | 设置 > 关于设备 > 版本 > 构建号 | 设置 > 系统设置 > 开发者选项 |
| OPPO / realme (ColorOS / realme UI) | 设置 > 关于手机 > 版本号 版本号 | 设置 > 高级设置 > 开发者选项 |
| Motorola | 设置 > 信息 > 版本号 | 设置 > 系统 > 开发者选项 |
| Huawei / Honor (EMUI / MagicOS) | 设置 > 信息 > 版本号 | 设置 > 系统更新 > 开发者选项 |
菜单在不同操作系统版本之间移动。如果您无法找到“Build number”，请打开“设置”，并使用搜索字段：输入“build number”。在几乎所有Android设备中，搜索可以直接找到它。
Google Pixel (Android 14, 15, 16)
- 打开 设置 并滚动到 关于手机.
- 滚动到底部并点击 Build number 七次。几次点击后，您会看到一个倒计时toast。
- 输入您的PIN、图案或密码。
- 返回到 设置 > 系统 > 开发者选项.
三星Galaxy
- 打开 设置 > 关于手机 > 软件信息.
- 点击 构建号 确认七次并使用您的PIN
- 开发者选项 现在出现在主设置列表的最底部，下面是关于手机
小米、红米和POCO
- 打开 设置 > 关于手机.
- 点击 系统版本 (HyperOS) 或 MIUI版本 (较旧设备) 七次。
- 前往 设置 > 附加设置 > 开发者选项.
小米在开发者选项中添加了两个额外switch： 通过USB安装 和 USB调试（安全设置）. 如果没有“通过USB安装”， adb install 则会失败 INSTALL_FAILED_USER_RESTRICTED. 需要登录小米账户并插入SIM卡才能打开这些选项。
OnePlus, OPPO 和 realme
- 打开 设置 > 关于设备 > 版本.
- 点击 版本号 点击七次。
- 打开 设置 > 系统设置 > 开发者选项 (OnePlus) 或 设置 > 附加设置 > 开发者选项 (OPPO, realme)
华为和荣耀
- 打开 设置 > 关于手机.
- 点击 构建号 七次。
- 前往 设置 > 系统 & 更新 > 开发者选项.
在华为设备上，还需要设置USB连接模式为 文件传输 当您连接时，否则 adb 可能无法看到设备。如果您打算将这些手机运送，请阅读 How to publish a Capacitor app on Huawei AppGallery因为很多设备上没有Google Play服务
工作配置文件和受管理的设备
如果公司管理手机，管理员可以阻止开发者选项。您会看到“开发者选项不可用”。请向IT部门索取测试设备，而不是试图绕过政策
打开USB调试
- 开启 开发者选项 切换开启 USB调试.
- 将手机连接到支持数据传输的USB线（许多便宜的线只支持充电）。
- 在手机上接受 允许USB调试？ 对话框。勾选。 始终从本机计算机允许 在自己的机器上。
- 在计算机上，检查连接：
adb devices您应该看到：
List of devices attached
R5CT1234ABC deviceunauthorized 意味着您没有接受提示。 offline 通常意味着有一个坏的电缆或端口，或者一个来自旧的__CAPGO_KEEP_0__的服务器。 adb 随Android SDK平台工具一起提供。如果安装了Android Studio，它位于
adb 带有 Android SDK 平台工具的。 如果安装了 Android Studio，它位于 ~/Library/Android/sdk/platform-tools 在 macOS 或 %LOCALAPPDATA%\Android\Sdk\platform-tools .新手Android工具链？我们的 PATH帮助文档将指导您完成整个过程。 Android setup for Capacitor apps 涵盖了它。
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 可以直接构建和安装:
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC为了更快的循环，使用实时重载，使应用程序从网络加载开发服务器:
bunx cap run android -l --external手机需要连接到您的机器的IP地址才能实现此功能。当您希望测试者在不重新安装的情况下看到更改时，请查看 Capgo 实时更新 而不是开发服务器。
要在应用程序运行时读取本机日志:
adb logcat | grep -i -E "capacitor|chromium"并要调试 WebView，请在桌面 Chrome 中打开 chrome://inspect 在调试构建运行时，Capacitor 应用程序的 WebView 调试默认开启。
故障排除
点击构建号无效。 点击构建号无效。
设备未连接 adb devices.
adb kill-server
adb start-server
adb devices然后尝试使用不同电缆和直接连接到电脑的端口，而不是中继器。切换USB模式通知到 文件传输.
Windows无法识别手机。 安装OEM USB驱动程序（Samsung、Xiaomi等发布自己的）或从SDK管理器中获取Google USB驱动程序，适用于Pixel设备。
INSTALL_FAILED_UPDATE_INCOMPATIBLE. 已安装的应用程序使用不同的密钥签名（例如Play Store版本与您的debug版本）。首先卸载它： adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED 在Xiaomi上。 启用 通过USB安装 在开发者选项中。
无线调试始终关闭。 Android会在您更改Wi-Fi网络时关闭它。一些电池节能器也会停止它。保持手机在同一网络上并充电，长时间会话期间。
无法在更新 Android Studio 后登录。 在开发者选项中，ADB 密钥已 ~/.android/adbkey 在开发者选项中点击 撤销 USB 调试授权,重新连接并接受提示。
如何关闭开发者选项
- 打开 开发者选项.
- 切换 使用开发者选项 (或 开发者选项 在 Samsung 设备上，菜单位于顶部，点击即可关闭。
菜单在某些设备上始终可见，但内部 switch 重置为默认值。要完全隐藏菜单，请前往 设置 > 应用 > 设置 > 存储 并清除 Settings 应用的存储空间。这样会重置其他设置偏好，因此这通常不是一个好主意。
在将测试手机交给他人之前，还要点击 撤销 USB 调试授权 以便旧电脑无法再连接。
安全提示
- USB 调试允许授权电脑安装应用并读取调试构建中的应用数据。不要在公共充电站或您不信任的电脑上接受 RSA 提示。
- 某些银行和支付应用程序在开发者选项或 USB 调试开启时拒绝运行。完成后，请在您的个人手机上关闭它们。
- 不要将
android:debuggable="true".Capacitor 的发布构建交付给用户。Capacitor 的发布构建默认情况下不可调试。
iOS 的等价物
iPhone 有自己的 开发者模式 switch 您需要在运行开发或 ad hoc 构建之前查看 如何在 iOS 上启用开发者模式.
