Wireless Debugging Widget

无线调试小部件

只需轻点一下，即可直接从主屏幕切换无线调试（通过 Wi-Fi 进行 ADB 调试）。无需进入开发者选项，也无需下拉快速设置——只需轻点一下开关，即可轻松启用或禁用无线调试。

专为需要频繁刷写固件、运行测试或通过网络连接 IDE 的 Android 开发者打造。无线调试小部件简化了启用和禁用 ADB（通过 Wi-Fi 进行）的繁琐操作，将原本需要五次轻点的操作简化为一次。

** 工作原理 **

该小部件会读取和写入 Android 的全局设置 `adb_wifi_enabled`。获得所需权限后，轻点开关即可立即启用无线调试——效果与在开发者选项中手动切换相同，但无需离开主屏幕。

** 设置 **

由于 Android 的无线调试标志是受保护的系统设置，因此无线调试小部件需要一次性设置。 Google 仅允许拥有 WRITE_SECURE_SETTINGS 权限的应用使用此功能，而此权限无法通过标准安装对话框授予，必须通过 ADB 从计算机一次性授予。

应用内的“关于”屏幕会引导您完成整个设置过程：

1) 在您的设备上启用开发者选项。

2) 将您的设备连接到已安装 ADB 的计算机，并运行：

adb devices

3) 从输出结果中复制您的设备 ID，然后运行：

adb -s shell pm grant com.celestwatches.wirelessdebuggingwidget android.permission.WRITE_SECURE_SETTINGS

将 替换为上一步中的 ID。

4) 将小部件添加到您的主屏幕——如果您的启动器支持，只需单击一下；否则，使用标准的长按方式。

应用内也会显示这两个命令，并带有一键复制按钮。设置完成后，该小部件可以离线工作，无需帐户、无需云同步、也无需收集任何数据。

如果小部件对点击没有反应，请重新运行授权命令。Android 将 WRITE_SECURE_SETTINGS 权限限定于特定安装，因此重新安装、系统更新和备份恢复可能会静默撤销该权限。再次运行授权命令即可立即恢复小部件功能。

请注意，示例命令适用于原生 Android 系统和大多数主流设备，但部分厂商（例如小米、三星等）会在 Android 的权限系统之上添加额外的限制。如果该命令在您的设备上返回错误，您可能需要先启用辅助开发者选项或按照厂商提供的步骤操作——通常只需搜索您的设备型号以及“grant WRITE_SECURE_SETTINGS”即可找到具体步骤。

**功能特性**

- 主屏幕一键切换无线调试

- Material Design 风格的开关图标，一目了然地显示当前状态

- 自动支持浅色和深色模式 — 小部件会根据您的系统主题自动调整

- 无障碍功能：完美集成 TalkBack，并提供状态播报

- 小巧的 2×1 小部件，可放置在主屏幕的任意位置

- 应用内置设置说明和所需的 ADB 命令

- 如果未获得权限，则优雅地回退到开发者选项

**系统要求**

- Android 11（API 30）或更高版本 — 无线调试功能在 Android 11 中引入

- 一次性 ADB 设置，用于授予所需的系统权限

- 您的设备已启用开发者选项

**隐私保护**

无线调试小部件不会收集、传输或存储任何个人数据。该应用不包含用户帐户、分析、广告或第三方 SDK。唯一的网络活动是定期检查（最多每周一次），以更新应用内的“更多来自 CELEST 的内容”部分——此操作会从 celest-watches.com 获取其他 CELEST 应用的列表，并将结果缓存到本地。

**关于 CELEST**

CELEST 致力于打造小巧精致的 Android 应用和 Wear OS 表盘，无需订阅、无广告、无追踪。每款产品都专注于做好一件事——访问 celest-watches.com 或在 Google Play 搜索“CELEST”即可找到我们。