ADB_X - 无线ADB调试增强 Xposed 模块

Release License Platform Xposed

功能

  • 固定ADB无线调试端口 - 自定义端口号,避免每次随机分配
  • 查看配对码 - 从系统捕获并显示无线调试配对码
  • 读取保存的WiFi列表 - 获取系统中已保存的WiFi网络
  • 设置信任WiFi - 从列表中勾选信任的WiFi
  • 自动开启无线调试 - 连接到信任WiFi时自动启用ADB无线调试
  • 自动关闭无线调试 - 离开信任WiFi时自动关闭(可选)

环境要求

  • Android 11 (API 30) 及以上
  • LSPosed / Xposed 框架
  • Root 权限(固定端口和配对码功能需要)

构建

# Windows
gradlew.bat assembleRelease

# Linux/macOS
./gradlew assembleRelease

生成的 APK 在 app/build/outputs/apk/release/

安装

  1. 安装 APK 到设备
  2. 在 LSPosed 管理器中启用本模块
  3. 作用域选择 android设置 (com.android.settings)
  4. 重启系统或相关进程
  5. 打开 ADB_X 应用进行配置

工作原理

固定端口

通过 Hook SystemProperties.set 拦截 service.adb.tls.port 属性设置,将随机端口替换为用户指定的固定端口。

自动开启

在 system_server 中注册 WiFi 状态监听器,当连接到信任WiFi时自动写入 Settings.Global.ADB_WIFI_ENABLED

配对码

Hook AdbDebuggingManager 和设置应用的配对对话框,捕获配对码并写入 /data/local/tmp/adb_x_pairing_code 供应用读取。

WiFi列表

通过 WifiManager.getConfiguredNetworks() 或扫描结果获取可用的WiFi网络列表。

项目结构

ADB_X/
├── app/
│   ├── build.gradle.kts
│   └── src/main/
│       ├── AndroidManifest.xml
│       ├── assets/xposed_init
│       ├── kotlin/top/cbug/adbx/
│       │   ├── App.kt
│       │   ├── MainActivity.kt
│       │   ├── store/Settings.kt
│       │   ├── util/
│       │   │   ├── AdbHelper.kt
│       │   │   ├── ShellUtils.kt
│       │   │   └── WifiHelper.kt
│       │   ├── ui/WifiAdapter.kt
│       │   └── xposed/
│       │       ├── XposedInit.kt
│       │       ├── AdbSystemHooks.kt
│       │       └── SettingsHooks.kt
│       └── res/
│           ├── layout/
│           ├── values/
│           └── ...
├── build.gradle.kts
├── settings.gradle.kts
└── gradle/wrapper/

License

MIT

Releases

7/15/2026, 12:10:30 PM

ADB_X v1.0.0 - wireless ADB enhancement Xposed module.

Changes since previous release

  • 9002310 ci: stop mirroring APK into $VC/ subdirectories
  • e2ff81c ci: write changelog to file instead of GITHUB_OUTPUT
  • b0d115f ci: fetch full git history in release job for changelog
  • 4d0ddf7 ci: include changelog since last release in release notes
  • e23a6af ci: fix find delete error in mirror step
  • a8e7df1 ci: produce LSPosed-indexer-compatible release tags
  • a5d852b fix: honour bootStart toggle, drop foreground service, fix pairing read
  • 0c71f59 chore: stop tracking app/build artifacts

Source: https://github.com/blockman3063/ADB_X

Assets

1

7/15/2026, 12:00:57 PM

ADB_X v1.0.0 - wireless ADB enhancement Xposed module.

Changes since previous release

  • e2ff81c ci: write changelog to file instead of GITHUB_OUTPUT
  • b0d115f ci: fetch full git history in release job for changelog
  • 4d0ddf7 ci: include changelog since last release in release notes
  • e23a6af ci: fix find delete error in mirror step
  • a8e7df1 ci: produce LSPosed-indexer-compatible release tags
  • a5d852b fix: honour bootStart toggle, drop foreground service, fix pairing read
  • 0c71f59 chore: stop tracking app/build artifacts

Source: https://github.com/blockman3063/ADB_X

Assets

1

7/14/2026, 1:40:43 PM

ADB_X v1.0.0 - wireless ADB enhancement Xposed module.

Bug fixes since v1.0.0-r2:

  • bootStart toggle now actually skips boot path
  • AdbMonitorService removed (killed by Android 14+ dataSync restrictions)
  • pairing code file no longer holds stale values
  • external IP cached 10 min to stop hammering ipify
  • adb_wifi_enabled logic hardened in AdbSystemHooks
  • Strings moved to strings.xml
  • Tag format $VC-$VN for LSPosed indexer compat

Source: https://github.com/blockman3063/ADB_X

Assets

1

7/14/2026, 1:37:31 PM

ADB_X v1.0.0 - wireless ADB enhancement Xposed module.
Source: https://github.com/blockman3063/ADB_X

Bug fixes since v1.0.0-r2:

  • bootStart toggle now actually skips boot path
  • AdbMonitorService removed (killed by Android 14+ dataSync restrictions)
  • pairing code file no longer holds stale values
  • external IP cached 10 min to stop hammering ipify
  • adb_wifi_enabled logic hardened in AdbSystemHooks

Assets

1