adb指令扩展方案

项目背景 & 痛点

当前 AOSP 开发中，绝大多数功能开关、调试选项、云控能力都依赖系统属性（ro./persist./debug. 等 prop）来实现，主要存在以下硬伤：

只能传递字符串，无返回值机制
参数表达能力极弱（多个参数需要手动拼接与解析）
系统属性值长度有限制（PROPERTY_VALUE_MAX = 92 字节）其中 SM=92、HM=128
无法返回复杂数据（如 JSON、数组、二进制日志等）
权限控制粗糙，容易被误操作或被外部工具随意修改

解决方案：扩展自定义 adb 命令子系统（cloud）

基于 Android 原生 cmd 服务机制，新增了一套专用的云控指令入口：

bash 复制代码

adb shell cloud <module> <action> [args...]

典型用法示例：

bash 复制代码

adb shell cloud audio wired_headphone 1 如需要帮助可执行 adb shell cloud audio 会打印如下帮助信息
Usage: cloud audio <command> [options]
Commands:
    wired_headphone // 模拟插拔耳机操作
Options:
    1 - 插入耳机
    0 - 拔出耳机

相比传统 prop 的核心优势

能力维度	传统 setprop/getprop	新 cloud 命令方案	提升效果
参数数量与类型	仅支持单个字符串，需手动拼接解析	原生支持任意多个参数（int、string、bool、byte\[\] 等）	支持复杂业务逻辑
返回值能力	几乎无（只能再读一次 prop）	可直接返回字符串、JSON、二进制、结构体等	前端可实时获取执行结果
数据长度限制	最大 92 字节	无限制（Parcel 最大 1MB）	可返回完整日志、配置、状态
复杂数据结构支持	不支持	支持 JSON、List、Map、自定义 Parcelable	云控能力大幅增强
权限精细控制	依赖 SELinux，粒度粗	可按 uid、caller package、secontext 精确控制	更安全，可防误操作
操作日志与审计	几乎无日志	服务端可完整记录每次调用（谁、在何时、调了什么）	便于问题追溯与安全审计
事务性与原子性	多步操作无法保证一致性	单命令可封装完整事务逻辑	减少中间异常状态
扩展性	基本无	可无限增加子模块（audio/camera/perf/log 等）	统一云控指令框架

实际使用场景举例

bash 复制代码

# 旧方式（prop）------ 几乎无法实现
adb shell setprop debug.camera.dump_raw 1    # 只能开，无法知道是否真的成功，也无法取回图片

# 新方式（cloud）------ 一条命令全部搞定
adb shell cloud camera capture_raw /sdcard/test.yuv   # 直接返回拍摄的 raw 图路径或二进制数据
adb shell cloud audio get_mic_status                  # 返回 JSON: {"mic1": true, "mic2": false, "aec": true}
adb shell cloud perf run_antutu                        # 执行跑分并返回分数
adb shell cloud factory reset_all                     # 一键恢复出厂设置（比 recovery 更可控）