veeN7Cockpit Android
原生 Android 车舱应用。功能模式页从服务器 A 的 Cognitive_Agent 获取预设模式， 提交模式任务，并每秒同步 Web/Android 共用的执行事件与最终车端状态。
跨服务器迁移请优先阅读 MIGRATION_GUIDE.md。可迁移 ZIP
通过 scripts\create-portable-package.ps1 生成，包内不包含设备令牌、构建缓存、
历史 APK 或本机测试产物。
服务器 B 构建
工程使用 Android Gradle Plugin 8.7.3、Gradle 8.9、JDK 17+ 和 Android SDK 35。 工程已包含 Gradle Wrapper，服务器安装 JDK 17 或更高版本和 Android SDK 35 后可直接构建。
服务器 A 地址和设备令牌通过 Gradle 属性或环境变量注入。真实设备不能填写
127.0.0.1；该地址会指向 Android 设备自身。10.0.2.2 只适用于 Android
模拟器访问宿主机。
$env:COGNITIVE_AGENT_BASE_URL = 'http://192.168.1.10:8000'
$env:COGNITIVE_AGENT_DEVICE_API_TOKEN = '<与服务器A相同的长随机令牌>'
./gradlew.bat assembleRelease
也可使用 -PorchestratorBaseUrl=...、-PorchestratorApiToken=...、
-PorchestratorVehicleId=denza_n7、-PorchestratorHardwareClientId=hwc-n7cockpit-001
和 -PorchestratorExecutionTarget=hardware。APK 输出位于
app/build/outputs/apk/release/。
未传 orchestratorExecutionTarget 时默认使用 dry_run。真实 CAN 构建必须显式
传入 -PorchestratorExecutionTarget=hardware，避免普通调试构建误入硬件执行。
开发环境允许局域网 HTTP；生产跨服务器部署应在服务器 A 前配置 HTTPS，并关闭 Manifest 的明文流量许可。令牌会进入 APK 的 BuildConfig，因此它只用于受控车机， 如 APK 会公开分发，应改为设备注册后下发短期凭据。
模拟器远程联调
启动已安装的远程联调应用时，不要解析 resolve-activity 输出后直接拼接命令；
部分 Android 版本会先输出匹配优先级元数据。使用固定、完整组件名启动，并验证
Activity 确实处于前台：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-remote-app.ps1
自动联调脚本会校验模式目录、启动 Android、点击“宝宝午睡模式”，并检查
queued -> executing -> succeeded 事件、相同的 execution_id 和车端状态回显。
脚本只允许 10.0.2.2:8000 且强制要求 APK 的执行目标为 dry_run；不申请硬件
控制权限，也不会执行真实 CAN：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\test-remote-link.ps1