162 lines
6.7 KiB
Markdown
162 lines
6.7 KiB
Markdown
|
# Continental Retail APP | uni-app / uni-app x PoC 验证结论
|
||
|
|
|
||
|
|
## 1. 验证说明
|
||
|
|
|
||
|
|
本文档记录经典 uni-app 与 uni-app x（蒸汽模式）在同一业务范围下的 PoC 结果，重点判断：
|
||
|
|
|
||
|
|
- 三端工程是否能构建、安装和运行
|
||
|
|
- 常用业务能力是否可接入
|
||
|
|
- 鸿蒙平台的问题能否被复现和定位
|
||
|
|
- 一名前端能否独立完成维护和发布
|
||
|
|
|
||
|
|
验证环境：App-Android、App-iOS、App-鸿蒙；本文当前重点记录 uni-app x 鸿蒙结果。
|
||
|
|
|
||
|
|
## 2. 验证结果
|
||
|
|
|
||
|
|
### 2.1 三端工程
|
||
|
|
|
||
|
|
**结论：通过。**
|
||
|
|
|
||
|
|
鸿蒙本地打包、unsigned 包构建、DevEco Studio 安装启动均已跑通，构建链路无阻塞。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
|
||
|
|
### 2.2 登录与会话
|
||
|
|
|
||
|
|
**结论：通过。**
|
||
|
|
|
||
|
|
鸿蒙下 Storage 读写稳定；`onShow`/`onHide` 生命周期可用；App 从后台恢复后能够刷新过期会话，退出登录可清理存储。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
|
||
|
|
注：当前 PoC 使用普通 Storage，正式版仍需评估鸿蒙加密存储能力。
|
||
|
|
|
||
|
|
### 2.3 扫码与权限
|
||
|
|
|
||
|
|
**结论：部分通过。**
|
||
|
|
|
||
|
|
`uni.scanCode` 可以拉起鸿蒙扫码界面，说明扫码 API、页面调用链和相机能力接入基本可用。系统出现 `Limited access to camera`，表明相机处于受限授权状态；当前截图尚未证明二维码/条码结果回传成功，权限被回收后的二次申请也未完成验证。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
- 
|
||
|
|
|
||
|
|
实现： [pages/scan/scan.uvue](pages/scan/scan.uvue)，权限和模块配置见 [manifest.json](manifest.json)。
|
||
|
|
|
||
|
|
### 2.4 定位
|
||
|
|
|
||
|
|
**结论：失败/受阻。**
|
||
|
|
|
||
|
|
`uni.getLocation({ type: 'wgs84' })` 调用后返回：
|
||
|
|
|
||
|
|
```text
|
||
|
|
getLocation:fail Failed to get provider
|
||
|
|
```
|
||
|
|
|
||
|
|
虽然工程已声明 `uni-location` 和 `ohos.permission.LOCATION`，但当前 Harmony 环境没有返回可用定位 provider，未获得经纬度和精度。因此目前不能确认 uni-app x 鸿蒙定位能力可用于正式业务，需要在具备定位服务的真机上复测，并继续核对框架、插件和 Harmony 版本兼容性。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
|
||
|
|
实现： [pages/gps/gps.uvue](pages/gps/gps.uvue)。
|
||
|
|
|
||
|
|
### 2.5 推送与深链
|
||
|
|
|
||
|
|
**结论：推送受阻，应用内深链可单独验证。**
|
||
|
|
|
||
|
|
调用 `getPushClientId` 返回：
|
||
|
|
|
||
|
|
```text
|
||
|
|
getPushClientId: fail
|
||
|
|
errCode: 15032
|
||
|
|
```
|
||
|
|
|
||
|
|
未获得有效 Push Client ID，因此 `onPushMessage`、前后台到达、关闭态通知点击和通知深链无法形成完整验证。页面内的 query 参数跳转只能验证应用内路由承接，不能替代真实通知点击测试。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
|
||
|
|
实现： [pages/push/push.uvue](pages/push/push.uvue)。
|
||
|
|
|
||
|
|
### 2.6 文件链路
|
||
|
|
|
||
|
|
**结论：基础链路通过。**
|
||
|
|
|
||
|
|
相册选择能够返回临时文件路径并在应用内预览；下载能够返回 HTTP 状态码和本地临时路径，下载结果也能正常渲染。拍照、PDF/Office 外部打开和复杂 URI 兼容性仍需真机复测。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
|
||
|
|
实现： [pages/file/file.uvue](pages/file/file.uvue)。
|
||
|
|
|
||
|
|
### 2.7 ERP H5
|
||
|
|
|
||
|
|
**结论：基础链路通过。**
|
||
|
|
|
||
|
|
本地 H5 加载和 H5 -> Native JSBridge 通信已验证。鸿蒙 WebView 注入的是 `window.__uniapp_x_`，不是常见的 `window.__uniapp_x_postMessage`，因此需要按平台做兼容判断。真实 ERP、SSO、网络环境和长期后台恢复仍需复测。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
|
||
|
|
实现： [pages/erp/erp.uvue](pages/erp/erp.uvue)、[static/erp/mock-erp.html](static/erp/mock-erp.html)。
|
||
|
|
|
||
|
|
### 2.8 维护演练
|
||
|
|
|
||
|
|
**结论：需人工介入。**
|
||
|
|
|
||
|
|
修改代码后重新本地打包鸿蒙工程，若上一次生成的工程目录仍存在，会出现无法删除旧工程的错误；必须手动清理后才能重新打包，增加了单人维护和发布成本。
|
||
|
|
|
||
|
|
证据：
|
||
|
|
|
||
|
|
- 
|
||
|
|
|
||
|
|
## 3. 结论汇总
|
||
|
|
|
||
|
|
| 验证项 | uni-app x 鸿蒙结论 | 状态 |
|
||
|
|
| --- | --- | --- |
|
||
|
|
| 三端工程 | 本地打包、unsigned 构建、DevEco 安装启动通过 | 通过 |
|
||
|
|
| 登录与会话 | Storage、生命周期、前后台会话恢复通过 | 通过 |
|
||
|
|
| 扫码与权限 | 可拉起扫码界面；相机为受限授权，结果回传和权限恢复待验证 | 部分通过 |
|
||
|
|
| 定位 | `Failed to get provider`，未获得定位结果 | 失败/受阻 |
|
||
|
|
| 推送与深链 | `getPushClientId` 返回 `errCode: 15032`；应用内深链可单独验证 | 受阻 |
|
||
|
|
| 文件链路 | 相册、下载、本地预览基础链路通过 | 基础通过 |
|
||
|
|
| ERP H5 | 本地 H5 与 JSBridge 基础通信通过 | 基础通过 |
|
||
|
|
| 维护演练 | 重复打包前需手动删除旧工程目录 | 需人工介入 |
|
||
|
|
|
||
|
|
**总体判断：** uni-app x 鸿蒙的工程构建、会话、文件和基础 WebView 链路可行；扫码已能进入系统能力，但结果和权限恢复仍需补测；定位和推送分别受到 provider 获取失败、Push Client ID 错误 `15032` 阻断，不建议在问题未明确前直接承诺正式业务可用。
|
||
|
|
|
||
|
|
## 4. 问题与复测项
|
||
|
|
|
||
|
|
| 编号 | 模块 | 现象 | 状态 |
|
||
|
|
| --- | --- | --- | --- |
|
||
|
|
| ISSUE-001 | 推送与深链 | 关闭态通知点击后的目标路由未完成验证 | 受推送能力阻断 |
|
||
|
|
| ISSUE-002 | 扫码与权限 | 相机受限授权，权限回收后的二次扫码未验证 | 待真机复测 |
|
||
|
|
| ISSUE-003 | 文件链路 | 拍照、外部文件打开和复杂 URI 未覆盖 | 待真机复测 |
|
||
|
|
| ISSUE-004 | ERP H5 | 长时间后台后的 WebView 恢复未覆盖 | 待真机复测 |
|
||
|
|
| ISSUE-005 | 维护演练 | 重复打包需手动删除旧鸿蒙工程目录 | 已复现 |
|
||
|
|
| ISSUE-006 | 定位 | `uni.getLocation` 返回 `Failed to get provider` | 已复现，待确认平台/环境原因 |
|
||
|
|
| ISSUE-007 | 推送 | `getPushClientId` 返回 `errCode: 15032` | 已复现，待确认服务配置/API 兼容性 |
|
||
|
|
|
||
|
|
### 复测优先级
|
||
|
|
|
||
|
|
1. 在具备定位服务的 Harmony 真机上复测定位。
|
||
|
|
2. 确认鸿蒙推送服务开通、应用配置和当前 HBuilderX/uni-app x 版本，再复测 Push Client ID。
|
||
|
|
3. 在带摄像头的真机上完成二维码识别、权限拒绝和权限恢复测试。
|
||
|
|
4. 使用真实推送服务验证前台、后台、关闭态通知和通知点击深链。
|