部署指南¶
Status: Current
Last verified: 2026-07-01
Code anchors:.cargo/config.toml,scripts/dev/setup-env.sh,scripts/android/android-runner.sh,apps/android-collector/scripts/ship-system.sh
这篇文档回答什么:如何把 DiPECS 从源码构建、部署到 Android 模拟器/真机,以及如何打包 release。
适合谁读:需要在设备上运行 daemon 或发布 APK 的人。
TL;DR¶
- 装依赖:
build-essential pkg-config libssl-dev lld。 - 装 Rust toolchain(仓库
rust-toolchain.toml自动锁定)。 - 装 NDK r27d 并导出
ANDROID_NDK_HOME。 cargo build --target aarch64-linux-android --release。- 用
adb push把dipecsd推到设备并运行;或./scripts/android/run-daemon-in-emulator.sh。
环境准备¶
系统依赖¶
Rust toolchain¶
在仓库根目录执行任意 cargo 命令会自动安装 rust-toolchain.toml 中指定的 channel、components 和 targets:
- channel:
1.95.0 - targets:
x86_64-unknown-linux-gnu、aarch64-linux-android、x86_64-linux-android
NDK¶
wget https://dl.google.com/android/repository/android-ndk-r27d-linux.zip
unzip android-ndk-r27d-linux.zip -d ~/Android/ndk/
export ANDROID_NDK_HOME="$HOME/Android/ndk/android-ndk-r27d"
export PATH="$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH"
验证:
注意:Rust daemon 当前使用 API 33 链接器;Android app 的 compileSdk/targetSdk 是 35。
一键自检¶
该脚本会检查系统依赖、toolchain、NDK,安装 git hooks,并把 NDK 工具链加入 PATH。
构建 Rust daemon¶
Linux 本地¶
Android ARM64¶
或只构建 daemon:
仓库已配置 cargo alias:
Android x86_64(模拟器)¶
运行 dipecsd¶
手动 push + 运行¶
adb push target/aarch64-linux-android/release/dipecsd /data/local/tmp/dipecsd
adb shell chmod +x /data/local/tmp/dipecsd
adb shell /data/local/tmp/dipecsd --no-daemon
带 Android JSONL 输入:
adb push data/traces/sample_replay.jsonl /data/local/tmp/sample.jsonl
adb shell /data/local/tmp/dipecsd --no-daemon \
--android-trace-jsonl /data/local/tmp/sample.jsonl
使用 cargo runner¶
.cargo/config.toml 配置了 scripts/android/android-runner.sh,运行时会自动 push 并执行:
模拟器一键脚本¶
默认使用 x86_64 构建、bridge token dipecs-dev-emulator-shared-token-00000000、端口 46321。
设备内闭环验证¶
该脚本会检测 ABI、交叉编译、push 二进制和 JSONL、运行 dipecsd、验证 action loop 闭环。
构建 Android APK¶
Debug¶
输出:app/build/outputs/apk/debug/app-debug.apk
Release¶
输出:app/build/outputs/apk/release/app-release.apk
默认使用 ~/.android/debug.keystore。
Platform-signed 系统应用¶
创建 apps/android-collector/signing/platform.properties:
platform.storeFile=/path/to/platform.keystore
platform.storePassword=android
platform.keyAlias=platform
platform.keyPassword=android
platform.certificateFile=/path/to/platform.x509.pem
构建:
系统镜像集成¶
使用 apps/android-collector/scripts/ship-system.sh 把 platform-signed APK 和 daemon 二进制刷入 system 分区:
该脚本会:
- 构建 platform-signed APK
- 交叉编译
dipecsdfor ARM64 adb root+adb remount- 推送
dipecsd到/system/bin/dipecsd - 推送 APK 到
/system/priv-app/DiPECSCollector/ - 设置
persist.dipecs.bridge.token - 重启设备
其他模式:
./scripts/ship-system.sh --build-only
./scripts/ship-system.sh --start-only
./scripts/ship-system.sh --stop
./scripts/ship-system.sh --uninstall
./scripts/ship-system.sh --verify
验证系统部署:
adb shell /system/bin/dipecsd --version
adb shell "ss -tlnp | grep 46321"
adb shell pm list packages -f com.dipecs.collector
CI 发布¶
.github/workflows/android-collector.yml:debug 构建 + 单元测试。.github/workflows/android-collector-release.yml:在v*tag 上创建 GitHub Release 并上传app-release.apk。.github/workflows/build.yml:交叉编译 Linux/Android release 二进制并做 ELF audit。