更新记录

1.0.0（2026-06-27） 下载此版本

初次提交

平台兼容性

uni-app(5.14)

laoqianjunzi-otg

laoqianjunzi-otg 是一个面向 uni-app x 的 UTS 插件，聚焦 Android 设备调试与控制场景，统一提供本机 Shell、OTG ADB、Wi-Fi ADB、无线调试配对、设备交互与结果持久化能力。

适用场景

• 在 Android 设备上执行本机 Shell 命令
• 通过 OTG 线连接另一台 Android 设备并执行 ADB 命令
• 通过局域网、无线调试配对或服务发现连接 Wi-Fi ADB 设备
• 获取远端设备信息、分辨率、截图、文本输入等调试辅助能力
• 通过自身设备无线调试配对服务，完成当前设备的本机配对链路

平台实现状态

当前示例页 uni_modules/laoqianjunzi-otg/pages/index.uvue 按 Android 实机调试场景设计。

环境要求

• uni-app x
• HBuilderX 5.07+
• Android minSdkVersion: 28
• 使用 OTG 时，当前设备需支持 USB Host
• 使用 Wi-Fi ADB 服务发现、前台保活时，需具备局域网与通知相关权限
• 使用 Shizuku 时，目标设备需已安装并完成授权

Android 侧声明能力

插件已在 utssdk/app-android/AndroidManifest.xml 中声明以下关键能力：

• android.hardware.usb.host
• ACCESS_NETWORK_STATE
• ACCESS_WIFI_STATE
• INTERNET
• NEARBY_WIFI_DEVICES
• CHANGE_WIFI_MULTICAST_STATE
• POST_NOTIFICATIONS
• FOREGROUND_SERVICE
• FOREGROUND_SERVICE_CONNECTED_DEVICE

如果你的业务只使用部分链路，可以先调用 getCoreCapabilities() 决定是否展示对应 UI，再按需触发更重的连接或调试流程。

安装与导入

将插件放入项目的 uni_modules 目录后，可以直接从插件根路径导入：

import {
  getPluginInfo,
  getCoreCapabilities,
  listOtgDevices,
  connectOtg,
  runOtgCommand
} from '@/uni_modules/laoqianjunzi-otg'

不要直接从 utssdk/app-android/index.uts 这样的具体平台文件导入。

API 设计约定

1. 插件信息与能力矩阵

• getPluginInfo()：读取插件基础信息，返回 pluginId、pluginVersion、platform、implementation
• getCoreCapabilities()：读取当前端可用能力矩阵，适合在页面初始化时决定展示哪些调试面板

2. 统一结果结构

插件大量使用以下结果结构：

• LqjBooleanResult：ok + value
• LqjStringResult：ok + value
• LqjShellExecResult：ok、mode、command、stdout、stderr、exitCode
• LqjOtgConnectionResult / LqjWifiConnectionResult：连接结果与状态说明

当调用失败时，通常会附带：

• errCode
• errMsg

推荐业务写法：先判断 ok，再消费 value、stdout 或连接状态字段。

能力总览

基础信息与环境检测

本机 Shell 与流式输出

OTG ADB

Wi-Fi ADB

保存设备与快速重连

自身设备无线调试配对

已连接设备与远端交互

以下能力同时适用于当前已连接的 otg 或 wifi 设备：

终端辅助与文件输出

远端文件管理

推荐调用顺序

本机命令

1. getCoreCapabilities()
2. isRootAvailable() 或 isShizukuAvailable()
3. sanitizeAdbShellCommand()
4. execLocalShell() 或 execShizukuShell()

OTG 调试

1. isUsbHostSupported()
2. listOtgDevices()
3. requestOtgPermission(deviceId)
4. connectOtg(deviceId)
5. runOtgCommand() / getDeviceInfo('otg') / screenshot('otg')
6. disconnectOtg()

Wi-Fi ADB 调试

如果你已经知道主机和端口：

1. connectWifiAdb(host, port)
2. runWifiAdbCommand()
3. saveWifiAdbDevice()
4. disconnectWifiAdb()

如果你需要从无线调试流程进入：

1. isWirelessDebuggingSupported()
2. startWifiAdbDiscovery()
3. getWifiPairingServices() / getWifiConnectServices()
4. pairWifiAdb() 或 pairAndConnectWifiAdb()
5. runWifiAdbCommand()

示例

读取插件信息与能力矩阵

import { getPluginInfo, getCoreCapabilities } from '@/uni_modules/laoqianjunzi-otg'

const plugin = getPluginInfo()
const capabilities = getCoreCapabilities()

console.log(plugin)
console.log(capabilities)

OTG 调试最小链路

import {
  listOtgDevices,
  requestOtgPermission,
  connectOtg,
  runOtgCommand
} from '@/uni_modules/laoqianjunzi-otg'

const devices = listOtgDevices()
if (devices.length > 0) {
  const deviceId = devices[0].deviceId
  const permission = requestOtgPermission(deviceId)
  if (permission.ok && permission.value) {
    const connected = connectOtg(deviceId)
    if (connected.ok && connected.connected) {
      const shell = runOtgCommand('getprop ro.product.model')
      console.log(shell.stdout)
    }
  }
}

Wi-Fi ADB 配对并连接

import { pairAndConnectWifiAdb, runWifiAdbCommand } from '@/uni_modules/laoqianjunzi-otg'

const connection = pairAndConnectWifiAdb('192.168.1.20', 37001, '123456')
if (connection.ok && connection.connected) {
  const result = runWifiAdbCommand('getprop ro.serialno')
  console.log(result.stdout)
}

错误码

示例页说明

本插件内置了一个面向 Android 的演示页：

• 路径：uni_modules/laoqianjunzi-otg/pages/index.uvue
• 目标：串起本机命令、OTG ADB、Wi-Fi ADB、自身设备配对四类典型流程
• 特点：只调用当前正式 API，不展示任何旧接口入口

如果你要在业务项目中接入，建议先跑通示例页，再把你真正需要的按钮和流程拆到业务页面中。