命令助手 Android 是命令助手的 App 版本,在核心脚本之外 增加了壳子层的能力,如一键粘贴、适配器、从文件管理器加载命令库等。
- 支持无障碍服务,提供粘贴与监听非打印按键接口
- 支持特殊 Intent 调用
- 支持适配器
- 支持开机自启
| 仓库 | 说明 |
|---|---|
| https://github.com/codesenlin/CA | 本 fork 的核心脚本(构建 APK 前需要先构建它,见下) |
| https://gitee.com/projectxero/ca | 原作者的核心脚本仓库 |
| https://github.com/XeroAlpha/cadroid | 原作者的 Android 壳仓库(本仓库的上游) |
依赖版本集中在:
gradle/libs.versions.toml
AGP、Kotlin、AndroidX、Rhino、QuickJS 和 buildscript 的 CVE 修补版本都从这里读取;
本地 app/libs/ 里的 SDK 仍按文件是否存在决定是否启用。
本仓库只是壳子,核心逻辑用 Kotlin/JS 编写并打包成 JS,源码在 CA。构建前先确认
app/src/main/assets/script.cjs 存在——推荐直接用 CA 的构建工具生成(它会把下面这套活全干完):
cd ../CA
node ./cabuildtools/main.js shellPrepareDebug # 调试用:组装核心 → gzip → 加密 → 写入 assets
node ./cabuildtools/main.js shellBuildRelease # 正式包:额外做 dex 校验、zipalign、apksigner、导出- 构建工具读 CA 的
config/shell.json,SDK / JDK / cadroid 路径会自动探测,无需手填 local 文件 - 正式包会导出到
CA/build/dist/命令助手(x.y.z).apk;日常调试也可以直接./gradlew :app:assembleDebug(用assets/里已有的script.cjs)
为什么脚本要加密(手动做法)
assets/script.cjs 是「GZIP 压缩 + 用 APK 签名证书 DER 逐字节异或」后的结果,运行时由
ScriptFileStream 读取当前签名证书解密。所以签名密钥必须和 app/signatures/*.signature
保持一致。手动打包步骤:未压缩的脚本写入 assets/script.cjs → GZIP → 用签名证书 DER 异或加密。
./gradlew :app:assembleDebug # 调试包(用 app/signatures/release.keystore 的 testkey 签名)
./gradlew :app:assembleRelease # 未签名包,交给 CA 的 zipalign + apksigner 签名JDK 不用手动装:字节码级别固定在 Java 17(compileOptions),用来跑构建的 JVM 由
gradle/gradle-daemon-jvm.properties 固定为 JBR 17,配合 settings.gradle 里的
foojay-resolver,缺了会自动下载(Android Studio 用的是它自带的 JBR,一般直接命中)。
从命令行跑 Gradle 时仍需要环境里有一个 Java(或设 JAVA_HOME),否则 wrapper 起不来。
app/signatures/、app/libs/、assets/script.cjs 都不入库,缺了也能编译。
工程不依赖任何本地文件即可构建:缺少的统计/广告 SDK 会被自动跳过,对应功能关闭。
下面两个 SDK 需要自己下载,放进 app/libs/(该目录不入库)。
- 到 https://www.talkingdata.com/ 按官方流程注册账号并定制专属 SDK,最新版本会发到你指定的邮箱
- 解压后把
.jar放进app/libs/ - 改
app/build.gradle.kts里两处文件名(tdAvailable的判断、以及implementation(files(...))), 让它们和你刚放进来的文件名一致 - Sync / 重新构建
- 按官方指引 https://datanexus.qq.com/doc/develop/guider/sdk/android/init 下载 GDT_ActionSDK_Android.zip
- 解压后把
.aar放进app/libs/ - 改
app/build.gradle.kts里两处文件名(gdtAvailable的判断、以及implementation(files(...))) - Sync / 重新构建
⚠️ 这个 aar 带 arm 的 native 库(armeabi/armeabi-v7a/arm64-v8a的libturingad.so), 加了它之后 APK 只支持 arm 架构,x86 设备 / 模拟器装不上。补充:优量汇的广告 SDK 本体走 Maven(
com.qq.e.union:union),不用手动放。广告 SDK 与 转化 SDK 是成套加载的——本地没有这个 aar 时两个都不加载(BuildConfig.GDT_ENABLED=false, 不请求广告),避免出现「投放广告但缺转化回传」的半套状态。
账号信息推荐用模板快速配置:
cp app/secrets/template.json app/secrets/local.json然后在 app/secrets/local.json 里填需要的字符串——每条都允许为空,空条目会自动
回退,不影响其它条目。
| 优先级 | 文件 | 说明 |
|---|---|---|
| 1 | app/secrets/local.json |
本机私人配置(已 gitignore,可选) |
| 2 | app/secrets/standard.json |
默认配置:CA 原作者公开的那份值(TalkingData token、优量汇 AppID/广告位、Gitee OAuth 凭据) |
| 3 | app/secrets/template.json |
模板:全部留空,兜底 |
合并是按条目(每个 getter)来的,不是整份文件:例如只填了 TalkingData token、其余留空, 那么广告 AppID / 广告位 / Gitee 那几项会各自回退到默认配置的值;某一条在默认里也是空, 才落回模板的空实现(该功能关闭)。
实现:app/build.gradle.kts 在构建时解析这三份 JSON、逐条合并,生成 Kotlin
com/xero/ca/gen/Secret.kt 参与编译(app/secrets/ 只当数据源,不参与编译)。
JSON 的值统一是字符串,密钥/公钥也直接填 Base64。
构建日志会列出每一项最终来自哪份:
Secret 配置(逐条合并):
getTDToken: local(本机) (已配置)
getGDTAppID: standard(默认) (已配置)
...
热更新校验公钥是公开信息,默认配置里有两把(双 key 兼容):
getVerifyKey():我们自己的公钥,配app/signatures/privateKey.pem,由 CA 的shellBuildRelease签热更新包;换签名密钥时同步更新这一把getLegacyVerifyKey():作者原版正式包里的公钥,用于兼容作者签发的官方热更新
core.sign 会用两把 key 依次验签,任一通过即接受;两把都不通过才拒绝。
本项目使用或参考了以下开源项目,感谢作者与贡献者:
- PEWS-API — Minecraft WebSocket 协议 SDK,本仓库使用 Android 兼容 fork
- Java-WebSocket — WebSocket 传输层
- Rhino — Android 脚本引擎
- quickjs-kt — Android QuickJS 绑定,侧载加速 worker(Apache-2.0)
- Kotlin — Kotlin Multiplatform / Kotlin/JS
| 文档 | 说明 |
|---|---|
| docs/quickjs-sidecar.md | 为什么 QuickJS 只做侧载、前后性能对比、给后来者的验证清单 |
| docs/migration-kotlin-quickjs.md | Kotlin 化 + JS 引擎迁移的完整过程记录(E0-E2.17) |
| docs/apk-build.md | APK 构建、签名、AAB/16KB 等打包相关说明 |