[Android V2 RC1 Release-02] 正式签名候选包与真机 P0 放行

[cropflre]

前置任务：#40、#53、#56、#58、#60、#62、#65

发布目标

从 main 提交 ae6536494b29d8706c1633657a742b2e2c0414df 生成 Android V2 0.1.0-rc.1 正式签名候选包，完成实体设备 P0，并确保公开 prerelease 的 APK/AAB 与实际通过 P0 的候选包逐字节一致。

旧锁定提交 ce81de51c2005449c72175c9187df14c34c4db57 已废弃：该版本仍包含“局域网服务器可发现但点击添加连接失败”的缺陷。

锁定候选版本

项目	值
versionName	0.1.0-rc.1
versionCode	100501
applicationId	com.nowen.video.v2
minSdk	26 / Android 8.0
targetSdk	35 / Android 15
tag	android-v2-v0.1.0-rc.1
source commit	ae6536494b29d8706c1633657a742b2e2c0414df

阶段 0：工程发布链（已完成）

• 正式签名预检、证书指纹锁定和 APK/AAB 验签门禁
• 候选包 manifest、checksums、Release Notes 与 candidate-verification.json
• 实体设备 P0 会话、脱敏证据、finalize 与 API 26/33/35 matrix
• prerelease promotion 的 verify、sync、publish fail-closed 门禁
• 发布附件严格 allowlist，公开包必须与 P0 候选逐字节一致
• 修复局域网发现后点击添加失败：最终探测切换到 Dispatchers.IO
• 扫描、手动添加和扫码添加统一使用公开 /api/auth/status 握手
• 非 Nowen HTTP 200 响应拒绝保存，网络失败提供明确中文原因
• Android 8 / 13 / 15 自动启动冒烟通过

操作指南：

• clients/android-v2/RELEASE_CANDIDATE.md
• clients/android-v2/DEVICE_P0.md
• clients/android-v2/RELEASE_PROMOTION.md
• clients/android-v2/SMOKE_TEST.md

最新 Bugfix 工程门禁：

• Android V2 run 30463029751：成功
• release-android-v2 run 30463030025：成功
• Android V2 Device Smoke run 30463029811：API 26 / 33 / 35 全部成功

PR 签名构建使用一次性临时密钥，仅证明工程链可用，不是可分发的正式 RC1。

阶段 A：长期签名准备

• 长期 V2 release keystore 已生成或确认复用
• keystore 已完成至少一份异盘或离线加密备份
• 已安全记录 keystore password、alias 与 key password
• 本地正式签名预检通过
• 正式证书 SHA-256 已保存
• 确认后续 RC 与 Stable 永久使用同一 keystore

在 Linux / WSL 的干净 main 执行：

git checkout main
git pull --ff-only
git rev-parse HEAD
# 必须输出 ae6536494b29d8706c1633657a742b2e2c0414df

bash scripts/android-v2-release-candidate.sh \
  --version 0.1.0-rc.1 \
  --keystore "$HOME/keys/nowen-video/nowen-video-android-v2-release.jks" \
  --alias nowen-video-android-v2 \
  --generate-keystore

默认只创建或复用 keystore 并执行本地预检，不配置 Secrets、不触发 workflow、不推 tag。

阶段 B：生成正式候选包

bash scripts/android-v2-release-candidate.sh \
  --version 0.1.0-rc.1 \
  --keystore "$HOME/keys/nowen-video/nowen-video-android-v2-release.jks" \
  --alias nowen-video-android-v2 \
  --repository cropflre/nowen-video \
  --output-dir "$PWD/dist/android-v2/rc1-candidate" \
  --configure-secrets \
  --dispatch

• 五项 GitHub Actions Secrets 已配置
• 正式签名 workflow 成功
• 候选目录包含 APK、AAB、checksums、manifest、预检报告、Release Notes 与验证报告
• checksums_verified、metadata_verified、apk_signature_verified、aab_signature_verified 均为 true
• manifest source commit 为 ae6536494b29d8706c1633657a742b2e2c0414df
• 版本、包名、SDK 与证书指纹符合本 Issue
• 正式证书 SHA-256 已记录为后续版本基线

阶段 C：实体设备 P0

完整主设备示例：

python3 scripts/android-v2-device-p0.py prepare \
  --candidate-dir "$PWD/dist/android-v2/rc1-candidate" \
  --session-dir "$PWD/dist/android-v2/p0/main-device" \
  --version 0.1.0-rc.1 \
  --expected-commit ae6536494b29d8706c1633657a742b2e2c0414df \
  --expected-fingerprint '<release certificate SHA-256>' \
  --tester cropflre \
  --server-version '<server version or commit>' \
  --network-profile MIXED \
  --scope full

• 至少一台 full 会话 finalized PASS
• API 26、33、35 启动会话均 finalized PASS
• 局域网扫描发现服务器后点击添加成功
• 手动地址和扫码添加成功，并进入登录流程
• Fresh install、登录、强制改密、首页、媒体库、搜索和详情通过
• Direct Play、Remux、HLS、音轨、字幕及播放状态恢复通过
• 离线下载、断点续传、离线播放与补同步通过
• 多服务器/多账号数据不串用
• RC 覆盖升级验证通过
• API 26 / 33 / 35 P0 matrix 为 PASS
• 脱敏后的 P0_MATRIX_REPORT.md 已评论到本 Issue

矩阵命令：

python3 scripts/android-v2-device-p0.py matrix \
  --session-dir "$PWD/dist/android-v2/p0/main-device" \
  --session-dir "$PWD/dist/android-v2/p0/api26" \
  --session-dir "$PWD/dist/android-v2/p0/api33" \
  --session-dir "$PWD/dist/android-v2/p0/api35" \
  --output-dir "$PWD/dist/android-v2/p0/matrix"

阶段 D：创建 tag 与草稿 prerelease

仅在正式候选和 P0 matrix 均通过后执行：

git checkout main
git pull --ff-only
git rev-parse HEAD
# 必须输出 ae6536494b29d8706c1633657a742b2e2c0414df

git tag android-v2-v0.1.0-rc.1 ae6536494b29d8706c1633657a742b2e2c0414df
git push origin android-v2-v0.1.0-rc.1

• tag workflow 成功
• 草稿 prerelease 已创建且保持 draft=true、prerelease=true
• tag 最终解析到锁定 source commit
• 附件不包含 Debug、unsigned、临时签名包、keystore 或凭据

阶段 E：同步实际 P0 候选资产

python3 scripts/android-v2-release-promote.py sync \
  --candidate-dir "$PWD/dist/android-v2/rc1-candidate" \
  --matrix-dir "$PWD/dist/android-v2/p0/matrix" \
  --version 0.1.0-rc.1 \
  --tag android-v2-v0.1.0-rc.1 \
  --repository cropflre/nowen-video \
  --output-dir "$PWD/dist/android-v2/promotion/sync" \
  --confirm-version 0.1.0-rc.1

• 草稿正文与候选 RELEASE_NOTES.md 一致
• 六个 Release 附件与 P0 候选目录逐字节一致
• promotion verify/sync 报告为 PASS

阶段 F：显式公开 prerelease

python3 scripts/android-v2-release-promote.py publish \
  --candidate-dir "$PWD/dist/android-v2/rc1-candidate" \
  --matrix-dir "$PWD/dist/android-v2/p0/matrix" \
  --version 0.1.0-rc.1 \
  --tag android-v2-v0.1.0-rc.1 \
  --repository cropflre/nowen-video \
  --output-dir "$PWD/dist/android-v2/promotion/publish" \
  --confirm-version 0.1.0-rc.1

• 发布前完整门禁 PASS
• Release 已变为 draft=false、prerelease=true
• 发布后重新下载与逐字节核验 PASS
• Release Notes、最低系统、迁移、已知限制与哈希已复核
• workflow、证书指纹、设备矩阵和 promotion 报告已记录

当前状态

工程发布链和局域网服务器添加修复均已完成并通过 CI。正式 RC1 尚未生成或公开；长期 release keystore、正式 Secrets、正式候选包、实体设备 P0、tag、草稿资产同步和显式公开仍需真实执行。在这些记录全部完成前，本 Issue 保持打开。

[cropflre]

工程发布链更新（2026-07-22）

已合并 PR #57，main commit：69bbd2152f43e74ae8db099acd67124d9fe26c55。

本轮 PR 实测结果：

• Android V2 run 29890717970：成功
• release-android-v2 run 29890718060：成功
• Android V2 Device Smoke run 29890717968：Android 8 / 13 / 15 全部成功

已验证：

• 签名预检自测
• PR 临时 keystore 的 store password / alias / key password / 私钥签名
• APK/AAB 构建与验签
• 最终 APK 证书 SHA-256 提取
• applicationId、versionName、versionCode、minSdk、targetSdk 反读
• release-manifest.json
• SHA256SUMS.txt
• signing-preflight.json
• 自动 RELEASE_NOTES.md

注意：上述签名验证使用 PR 一次性临时密钥，不是可分发正式候选包。下一阻塞点仍是长期 release keystore、五项正式 Secrets 和实体设备 P0 记录。

[cropflre]

Release-04 工程记录

• PR：feat(android-v2): add RC candidate release helper #59
• 合并提交：c705cea8152fda76d493a58a561589fddbc86f9d
• 已完成：一键候选包助手、唯一 request_id 关联、正式 workflow 等待与 artifact 下载、fail-closed 本地核验、非敏感验证报告、显式 tag 安全边界
• 修复记录：首次自测发现 Bash 在条件上下文中抑制 set -e，已改为所有候选包校验显式返回失败，并补充 manifest 文件大小与实际 SHA-256 复核
• 门禁：Android V2、release-android-v2、Android 8 / 13 / 15 Device Smoke 全部通过

正式 RC1 仍未生成。下一步必须由持有长期 release keystore 的发布负责人在 Linux / WSL 的干净 main 上执行 clients/android-v2/RELEASE_CANDIDATE.md 中的命令。请勿将 keystore、密码或 Base64 粘贴到 Issue、PR 或聊天中。

[cropflre]

Release-05 工程记录

• Issue：[Android V2 RC1 Release-05] 真机 P0 会话、证据采集与放行报告助手 #60
• PR：feat(android-v2): add physical-device P0 release helper #61
• 合并提交：8ca228a270c21a4723a02d70dba6511239548096
• 标准门禁：Android V2 run 29903184533 成功
• 签名门禁：release-android-v2 run 29903184555 成功
• 设备门禁：Android V2 Device Smoke run 29903184503，API 26 / 33 / 35 全部成功

已完成真机 P0 会话、候选包锁定、ADB 安装/启动检查、本地证据采集、稳定 P0 case ID、fail-closed finalize、同候选 API 26/33/35 矩阵和显式脱敏报告发布工具。

安全审查修复：原始 logcat、截图、UI XML 和 dumpsys 只保留在 evidence-local-only/；检测到崩溃/ANR 时，公开 JSON/Markdown 仅记录阻断数量与本地证据文件名，不复制原始日志内容。

注意：本轮仍使用 PR 一次性临时签名验证工程链，不代表正式 RC1 已生成。长期 release keystore、正式 Secrets、正式候选包、tag、实体设备 P0 和公开 prerelease 仍未完成。

[cropflre]

Release-06 工程记录

• Issue：[Android V2 RC1 Release-06] 草稿 prerelease 资产同步与显式公开门禁 #62
• PR：feat(android-v2): gate prerelease promotion on tested assets #63
• 合并提交：ce81de51c2005449c72175c9187df14c34c4db57
• 标准门禁：Android V2 run 29906546463 成功
• 签名门禁：release-android-v2 run 29906546525 成功
• 设备门禁：Android V2 Device Smoke run 29906546411，API 26 / 33 / 35 全部成功

本轮修复了最后一个发布一致性风险：tag workflow 会重新构建 APK/AAB，即使 source commit 与证书一致，也不能默认等同于实体设备实际完成 P0 的候选包。

新增 scripts/android-v2-release-promote.py：

• verify：只读验证 candidate、P0 matrix、tag、草稿状态、正文和六个附件；
• sync：显式使用实际通过 P0 的候选六文件覆盖草稿附件与正文，保持草稿；
• publish：要求版本确认，公开前后均重新下载并逐字节核验；
• 支持轻量和 annotated tag commit 解析；
• Release 附件使用严格 allowlist，拒绝 Debug、unsigned、keystore、凭据及未知文件；
• 生成不含敏感值的 promotion JSON/Markdown 报告。

正式 RC1 仍未生成或公开。长期 release keystore、五项正式 Secrets、正式候选包、实体设备 P0、tag 草稿、P0 原包同步和显式公开仍需由发布负责人真实执行。请勿将 keystore、密码或 Base64 粘贴到 Issue、PR 或聊天中。

[cropflre]

Android V2 局域网连接 Bugfix 更新

• Issue：[Android V2] 修复局域网服务器可发现但添加时连接失败 #65
• PR：fix(android-v2): allow discovered LAN servers to connect #67
• 合并提交：ae6536494b29d8706c1633657a742b2e2c0414df
• Android V2 run 30463029751：成功
• release-android-v2 run 30463030025：成功
• Android V2 Device Smoke run 30463029811：API 26 / 33 / 35 全部成功

修复内容：

• 最终服务器探测从主线程同步 OkHttp 请求切换至 Dispatchers.IO；
• 局域网扫描、手动添加与扫码添加统一使用 /api/auth/status；
• 共享 InitStatusEnvelope 握手解析，拒绝非 Nowen 的任意 HTTP 200 服务；
• 网络错误会展示超时、DNS、拒绝连接、HTTPS、HTTP 状态或响应不兼容等具体原因。

RC1 source commit 已从 ce81de51c2005449c72175c9187df14c34c4db57 更新为 ae6536494b29d8706c1633657a742b2e2c0414df。旧候选基线已废弃；如曾基于旧提交生成本地候选包，必须删除并从新提交重新构建。上述 CI 签名仍使用 PR 一次性临时密钥，不代表正式 RC1 已生成。