第三方应用如何远离 BMW 云端:mgu-store 的 app-privacy 组件如何补丁 MainApp
第三方应用如何远离 BMW 云端:mgu-store 的 app-privacy 组件如何补丁 MainApp
mgu-store 是为 BMW iDrive 7 / iDrive 8 车机打造的第三方应用商店,让你从 GitHub 仓库、网址或 U 盘安装和更新车载应用。但这些装进去的应用,会不会一直被 BMW 后台“盯着”?本文讲清楚它自带的 app-privacy 组件如何打补丁修改车机上的 MainApp,把清单上报、自动更新、仓库版本查询和分析事件统统屏蔽掉,让第三方应用彻底远离 BMW 云端。
为什么车载应用需要“隐身”
车机上真正管理应用的,是 BMW 的在线应用平台管理器 oap-mainapp(俗称 MainApp)。它天生会做几件事:
- 把“装了什么应用”的清单上报给 BMW 后台
- 定期向 BMW 应用仓库查询新版本、触发自动更新
- 记录
APP_INSTALL、APP_CRASH、APP_START等平台分析事件 - 在应用损坏、崩溃时向后台提交故障报告(甚至带上 VIN 车架号)
对 BMW 官方应用来说这很正常。但 mgu-store 装进来的都是第三方应用,它们不需要、也不希望被上报。app-privacy 组件就是来解决这件事的:它不改应用本身,而是给 MainApp 的两个核心代码包打补丁,让 MainApp 在处理这些第三方应用时“睁一只眼闭一只眼”。
一个补丁工具,而不是一堆配置
app-privacy 是一个独立的“工具组件”,随 mgu-store 一起安装,位于 native/app-privacy/ 目录:
- component.json 声明了组件版本(当前
1.7.1),同时支持 iDrive 7 与 iDrive 8("mguHmi": ["ID7", "ID8"]) - 核心是单个脚本 patch_mainapp.js,直接在车机自带的 Node 8 上以 root 运行,零依赖
- INTEGRATION.md 是它和安装器之间的“契约”,规定了打补丁的时机与规则
它支持车机上已知的 MainApp 版本:iDrive 7 的 8.3.2 / 8.2.10 / 8.1.1 / 6.5.5(位于 /usr/lib/oap-mainapp),以及 iDrive 8 的 MainApp-21 9.3.4 / 9.2.15(位于 /usr/lib/oap-mainapp21)。真正要改的文件,是这两个目录下的 main.js 与 AppManagement/AppManagement.js 两个包。
第一步:如何认出“本地应用”
补丁要在运行时逐个判断“这个应用是不是我们自己的”,靠的不是应用名列表,而是应用自报家门。
每个由 mgu-store 构建的应用,打包时都会被打上一个标记。tools/oap_pack.js 在打包前把 "mguLocalOnly": true 写进 package.json,所以标记会跟着 tgz 一路落到已安装应用的 oap_<uid>/source/package.json 里。
补丁给 MainApp 注入一个判断函数 isLocalOnlyApp,它按顺序检查:
- 手动覆盖表:
/var/opt/public/oap/oap_12201/data/local-only-apps.json(可选,给没带标记的旧构建兜底) - 已注册应用:读应用注册表
oap_12201/data/apps/<appId>.json里的 uid,再读对应package.json的mguLocalOnly - 即将安装的应用:看
preinstalled_apps/里待安装的 tgz 包是否带标记
任何读不到、解析失败的情况,都按“非本地应用”处理——也就是说,BMW 官方应用的行为完全不受影响。好处是:你装几个、改几个名字、新增应用,都不需要维护任何名单。
被屏蔽的六类 BMW 云端通道
这是 app-privacy 的核心价值。补丁按“锚点”精准修改 MainApp,让下面这些路径在遇到本地应用时直接跳过(完整对照表见 README.md):
| 通道 | 补丁后的效果 |
|---|---|
后端应用清单 getAllInstalledApps |
第三方应用不出现在上报给 BMW 的清单里 |
后端触发的全量更新 updateAllApps |
不再对本地应用发起更新 |
仓库版本查询 getLatestAppVersion |
不再带着 BMW-Vin 头去仓库查版本 |
平台分析事件(APP_INSTALL/APP_CRASH 等) |
携带应用名的分析事件被过滤 |
| 损坏应用报告(含 VIN) | 不再向后台提交本地应用的故障信息 |
诊断读取 DiagOap.StatusOap |
第三方应用不出现在诊断读出里 |
其中“仓库版本查询”和“包下载”是必需编辑:没有它们,一旦本地包里缺失,MainApp 会转头去仓库下载一个同名但来自 BMW 仓库的包顶替你的应用。补丁用 package-source 编辑强制本地应用只从 preinstalled_apps/ 取包,从仓库“消失”。
崩溃恢复:只重启,不清除
车机原装的 MainApp 有一套“升级式”崩溃恢复阶梯:应用崩溃后先重启,第二次崩溃就删数据,再不行就卸载重装,最后禁用图标并上报后台。这对第三方应用是灾难——数据随时可能被清掉。
补丁用 crash-gate 改写了这条阶梯:
- 本地应用每次崩溃都只重启,数据保留、应用保留、图标保留
- 只有当它10 分钟内重启了 5 次(阈值见 CRASH_RESTARTS),下一次崩溃才会让它保持停止状态,并写日志说明“已停止,等再次启动”
- 一个“开机就崩”的应用,几次尝试后自然停住,不会无限循环重启
- 关机过程中的死亡不计入;其他 BMW 官方应用仍走原装阶梯
换句话说:崩溃的应用只会被温柔地重启,而不是被清数据、禁图标、上报云端。
iDrive 7 与 iDrive 8 的差异
两套车机的补丁逻辑一致,但生效时机不同,这也是新手容易踩的点:
- iDrive 7:补丁写入后,如果 MainApp 正在运行且早于补丁启动,安装器会重启 MainApp 的 node 子进程让补丁立即生效
- iDrive 8:从不重启 MainApp-21。补丁在车机下次启动时生效,应用安装走队列,在下一次开机时安装
另外 iDrive 7 还有一项 iDrive 8 没有的必需编辑 keychain-time:把证书链(keychain)创建超时从 35 秒放宽到 125 秒,否则长耗时的本地应用安装会失败。
补丁如何“长长久久”地生效
一个隐患是:车机做软件更新后,固件会替换掉 MainApp 的两个包,补丁就没了。app-privacy 的解法是让补丁每次开机自动重新打上。
它随组件安装一个开机服务 app-privacy.service:
Type=oneshot、RemainAfterExit=yes,排在oapcontroller.service之前启动- 开机时执行
patch_mainapp.js boot(即 apply,永远返回 0),在 MainApp 启动前完成补丁 - 因此无论固件更新多少次,下一次开机前补丁一定就位
每次 apply 运行后,工具还会把结果写进 /var/opt/app-privacy/edit-record.json,记录每次编辑的锚点、文件 sha256、MainApp 版本,方便排查某条编辑在哪个固件上没匹配到。
如何验证补丁状态
在车机上运行脚本即可查看状态(详细参数见 README.md):
node /var/opt/app-privacy/current/patch_mainapp.js check --json
返回的 state 字段有三个值,是判断补丁是否真正生效的关键:
patched:已打补丁,restartNeeded为false时补丁已完全生效unpatched:尚未打补丁mismatch:固件与已知版本不符,补丁拒绝写入(什么都不改)
每次安装/更新组件后,安装器都会先跑 apply --json 确认状态,遇到 exit 2(拒绝)会直接中止应用安装——保证补丁一定先于应用就位。
小结
mgu-store 的 app-privacy 组件,本质是一个给 MainApp 打补丁的隐私守门员:
- 用
"mguLocalOnly": true标记自动识别本地应用,无需维护名单 - 精准屏蔽清单上报、自动更新、仓库查询、分析事件、故障报告、诊断读取六大云端通道
- 把崩溃恢复从“删数据、禁图标、上报”改成“只重启、保留数据”
- 通过开机服务让补丁随每次开机自动重新生效,固件更新也不怕
对第三方应用而言,这意味着它们装上车机后就能安静运行,不再被 BMW 后台持续追踪。相关测试可在 native/app-privacy/test/run.sh 中运行,组件说明以 native/app-privacy/README.md 为准。


