docs: 修正 B-149 上游差异表、2c9dab1 回退范围与 SHA256 当次产物说明

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: multica-agent <github@multica.ai>
This commit is contained in:
编码工程师
2026-08-20 02:11:04 +08:00
co-authored by Cursor multica-agent
parent e26abad4e1
commit 45d91684bc
3 changed files with 14 additions and 8 deletions
+1 -1
View File
@@ -41,4 +41,4 @@
## 回退 ## 回退
`docs/upstream/build-and-rollback.md`SDK 接入提交(2c9dab1)仅改 4 个依赖文件,可单独 `git revert` `docs/upstream/build-and-rollback.md`SDK 接入提交(`2c9dab1`)改 3 个 `pubspec.yaml` + 1 个 `pubspec.lock` + 1 个实测记录文档,可单独 `git revert`(会一并撤掉该文档)
+7 -5
View File
@@ -14,14 +14,16 @@
## 与本卡仓库(tongxunruanjian)的差异 ## 与本卡仓库(tongxunruanjian)的差异
基线在官方原版基础上只做了「必须才能构建/入库」的最小改动,业务代码零改动 基线在官方原版基础上只做了「必须才能构建/入库」的最小改动,**业务代码零改动**。与上游提交 `b3dfdb1e` 整树比对(`git diff b3dfdb1e 8046ec7:mobile-next`)的实际差异如下。
| 文件 | 差异 | 原因 | | | 差异 | 说明 |
|---|---|---| |---|---|---|
| `mobile-next/.gitignore` | 追加 `/build/``/android/.gradle/``/android/local.properties` | 上游未忽略 Flutter 构建产物与本机 SDK 路径,避免构建垃圾入库 | | `mobile-next/pubspec.lock` | `flutter_openim_sdk` 由锁文件 `3.8.3+2` 对齐为 `3.8.3+3` | `flutter pub get``pubspec.yaml` 声明 `3.8.3+3` 重新解析;上游锁文件落后于 pubspec。属官方产物,已披露。 |
| `mobile-next/pubspec.lock` | `flutter_openim_sdk` 由锁文件 `3.8.3+2` 对齐为 `3.8.3+3``flutter pub get``pubspec.yaml` 声明 `3.8.3+3` 重新解析) | 上游锁文件落后于 pubspec 声明,属官方产物 | | 6 个 `.dart` 文件 | 仅文件模式/权限位变化,blob 哈希完全相同 | 内容零改动,不属于业务差异。 |
| `.DS_Store` | 上游工作树中的 macOS 垃圾文件未随导入入库 | 删除/忽略,无源码改动。 |
| `mobile-next/.gitignore` | **与上游完全一致** | Flutter 构建产物忽略规则加在了**仓库根** `.gitignore`,不是 `mobile-next/.gitignore`。 |
除上述两处外,`mobile-next/` 与上游提交 `b3dfdb1e`整棵工作树一致(不含 `.git``.DS_Store``build/``.dart_tool/` 等非跟踪内容)。本卡已用 `git diff --no-index` 与上游归档树复核:零差异(仅上述 2 处)。 除上外,`mobile-next/` 与上游提交 `b3dfdb1e`跟踪内容一致(不含 `.git``build/``.dart_tool/` 等非跟踪内容)。**不存在未披露的业务改动。**
## 工具链锁定 ## 工具链锁定
+6 -2
View File
@@ -40,6 +40,8 @@ flutter build apk --release :: 产物 build/app/outputs/flutter-apk/app-relea
| debug | 成功 | `app-debug.apk` | 109,454,925 B | `DD7D9700BC1F5830B7495875387948AAD536CA63FDC3EF66B4C0F4D152407B72` | | debug | 成功 | `app-debug.apk` | 109,454,925 B | `DD7D9700BC1F5830B7495875387948AAD536CA63FDC3EF66B4C0F4D152407B72` |
| release | 成功 | `app-release.apk` | 53,323,411 B | `4969AF4A4800A8E7C0B0C2F50687CB8C765925E4F2B3B7A53762D1D9E49CA604` | | release | 成功 | `app-release.apk` | 53,323,411 B | `4969AF4A4800A8E7C0B0C2F50687CB8C765925E4F2B3B7A53762D1D9E49CA604` |
> SHA256 与字节大小仅为**当次构建产物记录**,不是位级可复现承诺。APK 内嵌构建时间戳,换机/换次重跑时哈希必然不同;大小差通常在时间戳/元数据量级。可复现的是工具链、构建命令与包名/签名证书。B-149 复核重跑:debug 109,454,749 B(差 176 B)、release 53,323,375 B(差 36 B),签名证书 SHA-256 与上表一致。
APK 元数据(aapt badging):package `io.openim.flutter.demo`versionCode `180`versionName `3.8.3`minSdk 24 / targetSdk 33 / compileSdk 34。 APK 元数据(aapt badging):package `io.openim.flutter.demo`versionCode `180`versionName `3.8.3`minSdk 24 / targetSdk 33 / compileSdk 34。
release 签名(apksigner verify --print-certs):CN=openim,证书 SHA-256 `1f38a82fb3c33be7951fb5d964ef5bd9c6c9bfc084ae1e2a8a40a0d1f44ae1fe`,与官方基线同一 keystore。 release 签名(apksigner verify --print-certs):CN=openim,证书 SHA-256 `1f38a82fb3c33be7951fb5d964ef5bd9c6c9bfc084ae1e2a8a40a0d1f44ae1fe`,与官方基线同一 keystore。
@@ -56,6 +58,8 @@ release 签名(apksigner verify --print-certs):CN=openim,证书 SHA-256
| 主题 | 提交 | 回退命令 | | 主题 | 提交 | 回退命令 |
|---|---|---| |---|---|---|
| 官方基线导入 + 双构建 | 8046ec7483d68f67011913da12e5e671479b5ff0 | `git revert 8046ec7483d68f67011913da12e5e671479b5ff0``git rm -r mobile-next` | | 官方基线导入 + 双构建 | 8046ec7483d68f67011913da12e5e671479b5ff0 | `git revert 8046ec7483d68f67011913da12e5e671479b5ff0``git rm -r mobile-next` |
| SDK hotfix.12 接入 + 核心能力实测 | 2c9dab160eefcaa5a4ad76a24ec2948bffaccc7e | `git revert 2c9dab160eefcaa5a4ad76a24ec2948bffaccc7e`(仅 4 个依赖文件) | | SDK hotfix.12 接入 + 核心能力实测 | 2c9dab160eefcaa5a4ad76a24ec2948bffaccc7e | `git revert 2c9dab160eefcaa5a4ad76a24ec2948bffaccc7e` |
回退任一提交均不影响 `mobile/``pc-client/``account-service/`、现网服务器与已发布安装包。SDK hotfix 提交的手动回退:把 `mobile-next/pubspec.yaml``openim_common/pubspec.yaml``openim_live/pubspec.yaml``flutter_openim_sdk` 改回 `3.8.3+3``flutter pub get` `2c9dab1` 实际包含 **5 个文件**`mobile-next/pubspec.yaml``openim_common/pubspec.yaml``openim_live/pubspec.yaml``mobile-next/pubspec.lock`,以及实测记录文档 `docs/mobile-next-hotfix-sdk-verification.md``git revert` 会一并撤掉该文档,不只是 4 个依赖文件
回退任一提交均不影响 `mobile/``pc-client/``account-service/`、现网服务器与已发布安装包。SDK hotfix 提交的手动回退:把上述 3 个 `pubspec.yaml``flutter_openim_sdk` 改回 `3.8.3+3``flutter pub get`(锁文件随之回写;实测记录文档需另行保留或删除)。