13 KiB
13 KiB
PX3 地图拷贝功能流程图
1. 文档说明
| 项目 | 内容 |
|---|---|
| 适用工程 | YX_MainInterface_ZhongQi |
| 适用平台 | Android 4.4 PX3 车机 |
| 新流程适用范围 | PX3 且 eMMC 判定为 32G 的设备 |
| 旧设备兼容 | 非 32G 设备继续使用原 TF 卡地图流程 |
| 文档依据 | 2026-09-09 当前代码实现 |
本文档只描述当前有效的 ZIP 地图方案。Map 分区正式文件直接位于 /mnt/map 根目录，不再使用旧路径 /mnt/map/amapauto9/amapauto9.zip。
2. 固定路径
| 用途 | 当前路径 |
|---|---|
| U 盘地图压缩包 | /mnt/usb_storage/amapauto9.zip |
| Map 导入临时文件 | /mnt/map/amapauto9.zip.part |
| Map 正式地图压缩包 | /mnt/map/amapauto9.zip |
| 内部地图目录 | /mnt/sdcard/amapauto9/data/navi/compile_v2/chn |
| 内部语音目录 | /mnt/sdcard/amapauto9/data/voice |
| 解压中标记 | /mnt/sdcard/amapauto9/.yaxon_map_copying |
| 解压完成标记 | /mnt/sdcard/amapauto9/.yaxon_map_complete |
| 旧设备 TF 卡地图 | /mnt/external_sd0/amapauto9 |
ZIP 内只处理以下两个目录：
amapauto9/data/navi/compile_v2/chn/...
amapauto9/data/voice/...
3. 总体流程
flowchart TD
A["设备启动"] --> B["BSP 挂载 tfcard 分区到 /mnt/map"]
B --> C["设置 /mnt/map 属主 system:system 和权限 0770"]
C --> D{"/mnt/map 挂载成功且 system UID 可写?"}
D -- "否" --> E["U盘导入和Map删除不可执行<br/>提示检查Map分区挂载权限"]
D -- "是" --> F["主界面和工程菜单可使用地图功能"]
F --> G{"入口类型"}
G -- "点击导航" --> H["执行导航入口流程"]
G -- "进入工程模式" --> I["执行地图数据管理流程"]
4. 导航入口流程
flowchart TD
A0["主界面加载功能图标"] --> A1{"车辆配置是否有记录仪?"}
A1 -- "否" --> A2["MAIN_ICON3或MAIN_ICON4<br/>当前不显示导航图标"]
A1 -- "是" --> A3["MAIN_ICON或MAIN_ICON2<br/>显示导航图标"]
A3 --> A["用户点击主界面导航图标"]
A --> B{"是否为 PX3 + 32G eMMC?"}
B -- "否" --> C{"/mnt/external_sd0/amapauto9 是否存在?"}
C -- "是" --> D["启动高德导航"]
C -- "否" --> E["提示插入含离线地图的 TF 卡"]
B -- "是" --> F{"当前是否有地图任务正在执行?"}
F -- "是" --> G["进入地图初始化页<br/>恢复并显示后台任务状态"]
F -- "否" --> H{"内部地图快速检查是否可用?"}
H -- "是" --> D
H -- "否" --> I["进入地图初始化页"]
I --> J{"/mnt/map/amapauto9.zip 是否存在且非空?"}
J -- "否" --> K["提示地图数据不可用<br/>联系服务人员"]
J -- "是" --> L["自动启动 Map 到 sdcard 解压任务"]
L --> M["显示初始化提示、进度条和百分比"]
M --> N{"任务结果"}
N -- "成功" --> O["显示初始化完成<br/>本次不直接打开导航"]
N -- "失败" --> P["显示失败原因<br/>允许重试或返回"]
N -- "用户返回" --> Q["可选后台运行、停止任务或继续等待"]
当前代码的 32G 判定流程：
flowchart TD
A["读取 /proc/partitions 中 mmcblk0 总块数"] --> B{"读取结果是否有效?"}
B -- "是" --> C["块数乘1024，得到物理容量字节数"]
B -- "否" --> D["读取 /sys/block/mmcblk0/size"]
D --> E{"读取结果是否有效?"}
E -- "是" --> F["扇区数乘512，得到物理容量字节数"]
E -- "否" --> G["容量类型 UNKNOWN<br/>不进入32G内部地图流程"]
C --> H{"容量是否在 24GiB 到 40GiB 之间?"}
F --> H
H -- "是" --> I["判定为 EMMC_32G"]
H -- "否" --> J["继续判断8G范围或判定UNKNOWN"]
I --> K{"Build.PRODUCT、DEVICE或MODEL 是否为 rkpx3?"}
K -- "是" --> L["启用32G内部地图流程"]
K -- "否" --> M["不启用内部地图流程"]
物理容量首次读取成功后会缓存在进程内，后续判断不重复读取块设备节点。
内部地图快速检查条件：
- 不存在
.yaxon_map_copying未完成标记。 chn、voice目录存在。- 核心文件
chn/a0/m1.ans非空。 chn中存在区域目录，voice中存在非空语音文件。- Map 正式 ZIP 存在时，完成标记必须匹配 ZIP 的文件大小和修改时间。
- Map 正式 ZIP 不存在时，兼容旧设备已经存在的内部地图数据。
5. 工程模式入口流程
flowchart TD
A["进入工程模式"] --> B{"是否为 PX3 + 32G eMMC?"}
B -- "否" --> C["不显示 地图数据管理 入口"]
B -- "是" --> D["显示 地图数据管理 入口"]
D --> E["进入地图数据管理页"]
E --> F["后台检测 eMMC、U盘、Map压缩包和内部地图状态"]
F --> G{"选择操作"}
G --> H["从U盘导入到Map分区"]
G --> I["删除Map分区地图"]
G --> J["复制地图到sdcard目录"]
G --> K["清除sdcard地图数据"]
H --> L["执行U盘导入流程"]
I --> M["二次确认后删除正式ZIP和part文件"]
J --> N["执行Map解压流程"]
K --> O["二次确认后执行内部地图清理流程"]
L --> P["刷新页面状态"]
M --> P
N --> P
O --> P
工程页四项操作互相独立，不会自动串联。首次部署建议顺序为：
必要时删除Map分区旧地图
-> 从U盘导入到Map分区
-> 复制地图到sdcard目录
6. 从 U 盘导入到 Map 分区
flowchart TD
A["点击 从U盘导入到Map分区"] --> B{"设备是否为 PX3 + 32G?"}
B -- "否" --> X1["提示仅支持32G设备"]
B -- "是" --> C{"U盘是否已挂载?"}
C -- "否" --> X2["提示先插入U盘"]
C -- "是" --> D{"U盘根目录是否存在非空 amapauto9.zip?"}
D -- "否" --> X3["提示未找到地图压缩包"]
D -- "是" --> E{"Map正式ZIP或part是否已存在?"}
E -- "是" --> X4["提示先删除Map分区旧数据"]
E -- "否" --> F{"/mnt/map 是否为目录且可写?"}
F -- "否" --> X5["提示Map分区不可写"]
F -- "是" --> G["读取ZIP64中央目录"]
G --> H{"ZIP结构、白名单目录和核心文件是否合法?"}
H -- "否" --> X6["提示地图压缩包无效"]
H -- "是" --> I{"Map剩余空间 >= ZIP大小 + 32MiB?"}
I -- "否" --> X7["提示Map分区存储空间不足"]
I -- "是" --> J["流式复制到 /mnt/map/amapauto9.zip.part"]
J --> K["同步文件并校验源、目标大小"]
K --> L["再次校验目标ZIP结构"]
L --> M{"校验是否成功?"}
M -- "否" --> N["删除part并返回失败"]
M -- "是" --> O["同目录重命名为 /mnt/map/amapauto9.zip"]
O --> P["显示导入成功"]
J -. "取消、拔出U盘或I/O异常" .-> N
说明：.part 是正在复制的临时文件，校验成功后直接重命名为正式 ZIP，不会在 Map 分区长期保留两份完整压缩包。
7. Map 解压到 sdcard
flowchart TD
A["导航页自动初始化<br/>或工程页点击复制地图到sdcard目录"] --> B["MapDataCopyService 接收任务"]
B --> C{"是否已有地图任务运行?"}
C -- "是" --> X1["拒绝重复启动并显示当前任务"]
C -- "否" --> D["停止高德进程并等待文件释放"]
D --> E{"高德是否已停止?"}
E -- "否" --> X2["取消操作并提示失败"]
E -- "是" --> F{"Map正式ZIP是否存在且非空?"}
F -- "否" --> X3["提示Map地图源不存在"]
F -- "是" --> G["读取ZIP64中央目录并生成白名单解压计划"]
G --> H{"压缩格式、路径和必需条目是否合法?"}
H -- "否" --> X4["提示压缩包无效"]
H -- "是" --> I["只处理 chn 和 voice 文件"]
I --> J{"是否为未完成恢复或ZIP身份变化?"}
J -- "是" --> K["受管文件全部重新解压"]
J -- "否" --> L["目标文件大小相同则跳过<br/>缺失或大小不同则解压"]
K --> M["计算本次所需新增空间"]
L --> M
M --> N{"sdcard剩余空间 >= 新增空间 + 300MiB?"}
N -- "否" --> X5["提示内部存储空间不足"]
N -- "是" --> O["写入 .yaxon_map_copying 标记并同步"]
O --> P["按计划流式解压并实时校验条目大小和CRC"]
P --> Q["每累计约512MiB执行批量sync"]
Q --> R{"全部计划文件校验是否通过?"}
R -- "否" --> X6["保留未完成状态<br/>返回失败或允许重试"]
R -- "是" --> S["写入 .yaxon_map_complete 完成标记"]
S --> T["删除 .yaxon_map_copying 并最终sync"]
T --> U["任务进度置为100%并提示成功"]
U --> V["后台重启高德进程<br/>使其重新初始化离线地图"]
当前写入策略：
- 新增文件直接写正式目标，写入失败时删除不完整文件。
- 覆盖已有文件时使用
.yaxon_part临时文件，再重命名替换。 - 解压过程边写边计算 CRC；完成前进度最高显示
99.9%，最终成功后显示100%。 - 当前差异计划以目标文件大小判断是否跳过；解压写入的文件会校验 ZIP 中记录的大小和 CRC。
8. 删除 Map 分区地图
flowchart TD
A["点击 删除Map分区地图"] --> B{"正式ZIP或part是否存在?"}
B -- "否" --> C["提示Map分区无地图数据"]
B -- "是" --> D["显示二次确认弹框"]
D -- "取消" --> E["不做修改"]
D -- "确认" --> F{"/mnt/map 是否可写?"}
F -- "否" --> G["提示Map分区不可写"]
F -- "是" --> H["删除 /mnt/map/amapauto9.zip"]
H --> I["删除 /mnt/map/amapauto9.zip.part"]
I --> J{"两个文件是否均已删除?"}
J -- "是" --> K["提示删除成功"]
J -- "否" --> L["提示删除失败"]
该操作只删除地图正式 ZIP 和残留 .part，不会删除 /mnt/map 目录，也不会清理 Map 分区中的其他文件。
9. 清除 sdcard 地图数据
flowchart TD
A["点击 清除sdcard地图数据"] --> B{"是否存在受管地图或语音数据?"}
B -- "否" --> C["提示sdcard无地图数据"]
B -- "是" --> D["显示慎重操作二次确认弹框"]
D -- "取消" --> E["不做修改"]
D -- "确认" --> F["停止高德进程并等待文件释放"]
F --> G["写入未完成标记并同步"]
G --> H["清空 chn 目录内容<br/>保留 chn 目录本身"]
H --> I["清理 voice 中可重新导入的数据<br/>保留 voice 目录本身和指定配置"]
I --> J["删除完成标记"]
J --> K{"清理是否全部成功?"}
K -- "否" --> L["保留未完成状态并提示失败"]
K -- "是" --> M["删除未完成标记并最终sync"]
M --> N["提示清理成功"]
必须保留的语音内容：
/mnt/sdcard/amapauto9/data/voice/voice_conf
/mnt/sdcard/amapauto9/data/voice/common.irf
/mnt/sdcard/amapauto9/data/voice/isstts.cfg
/mnt/sdcard/amapauto9/data/voice/xiaoyan.irf
10. 后台任务和页面交互
flowchart TD
A["Activity 发起地图操作"] --> B["绑定同进程 MapDataCopyService"]
B --> C["Service 保证同一时刻只有一个地图任务"]
C --> D["MapDataCopyManager 在工作线程执行文件操作"]
D --> E["Service 保存操作类型、进度、字节数和结果快照"]
E --> F{"用户操作"}
F -- "停留页面" --> G["页面持续刷新进度和提示"]
F -- "按Home" --> H["Activity离开，Service继续后台执行"]
F -- "再次进入" --> I["重新绑定Service并恢复当前快照"]
F -- "按返回" --> J["弹框选择后台运行、停止任务或继续等待"]
D --> K{"任务完成时页面是否绑定?"}
K -- "是" --> L["页面显示结果弹框并刷新状态"]
K -- "否" --> M["Service 使用Toast提示后台结果"]
页面进度回调按当前交互约定节流，最多约每 500ms 更新一次，减少主线程刷新开销。
11. 工程页状态显示
flowchart LR
A["Map分区状态"] --> A1["无数据<br/>正式ZIP和part均不存在"]
A --> A2["数据不完整<br/>存在part或正式ZIP小于7GiB"]
A --> A3["数据完整<br/>正式ZIP不小于7GiB且无part"]
B["内部地图状态"] --> B1["无数据<br/>chn和voice无受管数据"]
B --> B2["数据不完整<br/>有未完成标记或受管数据小于10GiB"]
B --> B3["数据完整<br/>无未完成标记且受管数据不小于10GiB"]
以上三态用于工程页面快速展示，不替代实际导入、解压时的 ZIP 结构、空间、文件大小和 CRC 校验。
12. BSP 前置条件与验证边界
BSP 侧目标启动顺序：
mount ext4 /dev/block/platform/emmc/by-name/tfcard /mnt/map wait noatime nodiratime nosuid nodev noexec noauto_da_alloc,discard
chown system system /mnt/map
chmod 0770 /mnt/map
flowchart TD
A["编译包含BSP修改的固件"] --> B["烧录boot或完整固件"]
B --> C["重启设备"]
C --> D["检查 /proc/mounts 中 /mnt/map 挂载来源和rw状态"]
D --> E["检查 ls -ld /mnt/map 的属主和权限"]
E --> F["使用系统应用执行U盘导入和删除"]
F --> G["重启后再次复测，确认权限持续有效"]
截至 2026-09-09，本次可访问的 BSP 文件
Z:\znzc\003_zhongqi\android4.4_rkpx3_zhongqi_pro\device\rockchip\rksdk\ZQ_PRO_32G\ZQ_PRO_32G_init.rc
仍保留两条 /mnt/map 挂载和 start chmodmap，尚未呈现上面的目标顺序。因此这里描述的是应用正常工作的前置要求，不表示该 BSP 修改已经进入源码或固件。
BSP 修改是否进入最终镜像、设备重启后 /mnt/map 是否仍可写，以及完整地图导入和解压结果，均必须以编译产物和真机日志为准。