xuqmGroup/XuqmGroup-RNSDK
0
0
派生 0
代码 工单 合并请求 版本发布 百科 动态

docs(rn-sdk): record published App4 integration baseline

浏览代码
这个提交包含在：
XuqmGroup 2026-07-18 07:35:05 +08:00
父节点 04fc964a92
当前提交 7589db7332
共有 1 个文件被更改，包括 27 次插入 和 19 次删除
显示统计 下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

46
docs/IMPLEMENTATION_HANDOFF.md
查看文件

@ -60,7 +60,7 @@
### 3.3 已确认缺口 ### 3.3 已确认缺口
- RN update 已编码 `XuqmAppUpdateModule`，只桥接 XuqmGroup Android `sdk-update:2.0.0-SNAPSHOT`；待 Jenkins 发布 Android Snapshot 后完成宿主 Gradle 编译和模拟器验证。 - RN update 已编码 `XuqmAppUpdateModule`，只桥接 XuqmGroup Android `sdk-update:2.0.0-SNAPSHOT`；Android Snapshot、Bridge 编译和 App4 完整 debug 构建已通过，模拟器安装事务仍待验证。
- release-set 已统一使用 SHA-256，但签名 manifest 尚待实现。 - release-set 已统一使用 SHA-256，但签名 manifest 尚待实现。
- 原生 state 已成为 Bundle 版本与事务状态唯一真相；App 更新提示缓存仍可使用 AsyncStorage，但不保存 Bundle 版本。 - 原生 state 已成为 Bundle 版本与事务状态唯一真相；App 更新提示缓存仍可使用 AsyncStorage，但不保存 Bundle 版本。
- 客户端已改为 `/api/v1/rn/release-set/check` 单次请求目标入口依赖闭包；租户平台服务端接口尚待同步实现。 - 客户端已改为 `/api/v1/rn/release-set/check` 单次请求目标入口依赖闭包；租户平台服务端接口尚待同步实现。
@ -68,30 +68,29 @@
- 插件 API 已拆分为纯检查 `checkPluginRelease`、确认后安装 `installPluginRelease` 和自动场景 `checkAndInstallPlugin`；检查阶段不下载、不写本地状态。 - 插件 API 已拆分为纯检查 `checkPluginRelease`、确认后安装 `installPluginRelease` 和自动场景 `checkAndInstallPlugin`；检查阶段不下载、不写本地状态。
- bugcollect 的采样、限频、fatal 绕过采样和 fatal/error 持久化策略已有纯逻辑测试覆盖。 - bugcollect 的采样、限频、fatal 绕过采样和 fatal/error 持久化策略已有纯逻辑测试覆盖。
- xwebview 的相册保存仍是可选宿主能力；其余文件下载能力已经下沉到 common。 - xwebview 的相册保存仍是可选宿主能力；其余文件下载能力已经下沉到 common。
- Jenkins 发布参数已收敛到 common、update、bugcollect、xwebview；仍需增加依赖版本存在性与发布顺序硬校验。 - Jenkins 发布参数已收敛到 common、update、bugcollect、xwebview；common/xwebview/update 新 alpha 已发布，仍需增加依赖版本存在性与发布顺序硬校验。
## 4. 实施进度 ## 4. 实施进度
| 工作项 | 状态 | 说明 | | 工作项 | 状态 | 说明 |
| ----------------------------- | ------ | ----------------------------------------------------- | | ----------------------------- | -------- | ------------------------------------------------------ |
| 基线审计与门禁 | 完成 | 2026-07-17 本地 validate 全通过 | | 基线审计与门禁 | 完成 | 2026-07-17 本地 validate 全通过 |
| 实时接管文档 | 进行中 | 本文件为唯一实施状态入口 | | 实时接管文档 | 进行中 | 本文件为唯一实施状态入口 |
| common 公共上下文收敛 | 完成 | 公共基础与共享生命周期 16 测试 | | common 公共上下文收敛 | 完成 | 公共基础与共享生命周期 16 测试 |
| bugcollect 依赖 common 与测试 | 完成 | 自动初始化、SHA、版本与策略已统一，4 测试 | | bugcollect 依赖 common 与测试 | 完成 | 自动初始化、SHA、版本与策略已统一，4 测试 |
| xwebview 文件/权限能力与测试 | 完成 | 文件下沉 common，H5 摄像头/麦克风统一授权，4 测试通过 | | xwebview 文件/权限能力与测试 | 完成 | 文件下沉 common，H5 摄像头/麦克风统一授权，4 测试通过 |
| update release set 与原生事务 | 进行中 | Android Snapshot 已发布；待 Bridge 编译和模拟器验证 | | update release set 与原生事务 | 进行中 | Android Snapshot、Bridge、App4 构建通过；待事务 E2E |
| package 内容校验 | 待实施 | 四包完成后执行 | | package 内容校验 | 待实施 | 四包完成后执行 |
| Jenkins alpha 发布 | 待实施 | 仅在全部门禁通过后触发 | | Jenkins alpha 发布 | 完成 | `#59/#60` 已发布 common、xwebview、update |
| App4 接入 | 进行中 | App4 已接入已发布 alpha；等待包含初始化重试的新 alpha | | App4 接入 | 完成构建 | 精确 alpha 已接入，六 Hermes 插件与 debug APK 构建通过 |
## 5. 下一步操作 ## 5. 下一步操作
1. 通过 Jenkins 发布包含 common 初始化重试的新 alpha；本地源码版本号不手工替代 Jenkins 的原子版本分配。 1. 在网络正常的 Android 设备验证自动初始化、登录及扩展共享会话。
2. App4 使用新精确版本后，在网络正常的 Android 设备验证自动初始化、登录及扩展共享会话。 2. 在 Android 宿主补充 release-set 安装、冷启动确认和崩溃回滚仪器测试。
3. 用仓库内 `native-test` 编译 RN Java Bridge，再在 Android 宿主补充 release-set crash/recovery 仪器测试。 3. 收敛 Jenkins 四包依赖发布顺序和 package 内容检查。
4. 收敛 Jenkins 四包依赖发布顺序和 package 内容检查。 4. 后续租户平台实现 `/api/v1/rn/release-set/check`，服务端只返回目标入口与 common 的兼容闭包。
5. 后续租户平台实现 `/api/v1/rn/release-set/check`，服务端只返回目标入口与 common 的兼容闭包。 5. App4 保持使用 Jenkins 精确版本，禁止链接 SDK 源码、手改 `node_modules` 或本地发布正式制品。
6. Jenkins 下一版 `@xuqm/rn-update` 必须包含 Hermes 字节码构建改造；App4 不允许长期依赖手工修改的 `node_modules`。
## 6. 常用验证命令 ## 6. 常用验证命令
@ -106,6 +105,15 @@ pnpm --dir packages/update test
## 7. 本轮变更记录 ## 7. 本轮变更记录
### 2026-07-18 / Jenkins #58—#60 与 App4 精确版本接入
- `sdk-rn-publish #58` 被 Windows Hermes 测试正确阻断：测试曾把文本写成 `hermesc.exe`，Windows `spawnSync` 无法执行；该构建未发布任何包。
- CLI 测试改为复制并执行 React Native 实际依赖的 Hermes 编译器，同一测试覆盖 Windows 可执行文件规则和真实字节码输出，不保留伪编译器兼容分支。
- `sdk-rn-publish #59` 成功发布 `@xuqm/rn-common@0.6.0-alpha.15` 与 `@xuqm/rn-xwebview@0.3.0-alpha.11`。
- `sdk-rn-publish #60` 成功发布包含 Hermes CLI 改造的 `@xuqm/rn-update@0.5.0-alpha.13`。
- App4 已使用上述精确版本；startup/common/app/szyx/miniapp/workbench 六模块均生成为 Hermes bytecode version 98，Gradle 自动嵌入后 debug APK 构建成功。
- 本仓库代码提交 `aacfbf0` 完成宿主运行时/XWebView 协议收敛，`04fc964` 修复 Windows 真实 Hermes 门禁；发布与 App4 构建证据均已取得，剩余仅为设备端 release-set 事务与网络场景验证。
### 2026-07-18 / Android Hermes 插件产物 ### 2026-07-18 / Android Hermes 插件产物
- `xuqm-rn` 从宿主 `android/gradle.properties` 读取唯一 `hermesEnabled`，不要求用户再维护插件引擎字段。 - `xuqm-rn` 从宿主 `android/gradle.properties` 读取唯一 `hermesEnabled`，不要求用户再维护插件引擎字段。