# 2026-06-30 上架提交

## 用户目标

先完成 TagLauncher `8.2.8` build `20260630.0128` 代码冻结，再使用冻结版本提交 App Store 审核。

## 当前冻结点

- 源码目录：`/Users/ar/Projects/Taglauncher/src`
- 分支：`codex/pro-custom-hotkeys-8.2.0`
- 冻结 commit：`bcceca83ce966598e00e0319d85ec11d6df9d272`
- 冻结 tag：`v8.2.8-build20260630.0128`
- HEAD 与冻结 tag 一致。
- 远端 push 仍未完成，原因是当前环境没有 GitHub HTTPS 凭据。

## 已完成事项

- 基于冻结版本生成 App Store 上传包：
  - `/Users/ar/Projects/Taglauncher/src/Release/AppStore-8.2.8-20260630.0128/Upload/TagLauncher-8.2.8-build20260630.0128.pkg`
  - SHA256：`e1ae1e0d1addec9c9af95974c230cb9060835d77d9d85f`
- 保留本地回滚 DMG：
  - `/Users/ar/Projects/Taglauncher/src/Release/AppStore-8.2.8-20260630.0128/Archive/TagLauncher-8.2.8-build20260630.0128.dmg`
  - SHA256：`47b7d7127781a7c5dbf709b6a9f65be1baa9f1f0f5fd1e93b531fcc61eaaf61a`
- 完成 package preflight：
  - `pkgutil --check-signature` PASS
  - `pkgutil --expand-full` PASS
  - expanded app `codesign --verify --deep --strict` PASS
  - `CFBundleIdentifier = com.taglauncher.app`
  - `CFBundleShortVersionString = 8.2.8`
  - `CFBundleVersion = 20260630.0128`
  - `com.apple.quarantine` 已清除
- 使用 Transporter 上传最终 PKG。
- Transporter 最终状态：`APP 可供内部测试`
- Transporter 交付时间：`2026-06-30 04:23 CST`

## 关键问题与处理

1. 首次 Transporter 校验失败：
   - 错误：`Invalid Code Signing`
   - 原因：同名 `3rd Party Mac Developer Application` 证书有两张，首次使用了 `404B695635AF53AAF0A65956B935115BD5A9DD50`，但 provisioning profile 绑定的是 `0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C`。
   - 处理：改用 profile 绑定证书 `0D7D5484FDE4EC1CA2C9225F1E71E65A256A1E7C` 重新签名。

2. 第二次 Transporter 处理失败：
   - 错误：`Invalid package contents (91109)`
   - 原因：`Contents/embedded.provisionprofile` 带有 `com.apple.quarantine` 扩展属性。
   - 处理：递归清理 staged app 的 quarantine xattr，重新签名并重新打包。

3. `pkgutil --payload-files` 仍能看到 AppleDouble `._*` 记录：
   - 与 macOS 本地 provenance 行为相关。
   - 最终包已被 Transporter 接受并处理到内部测试状态，因此本轮记录为非阻塞。

## Release 记录

新增 release 目录：

`/Users/ar/Projects/Taglauncher/src/Release/AppStore-8.2.8-20260630.0128/`

其中包括：

- `README.md`
- `RELEASE_MANIFEST.md`
- `PKG_PREFLIGHT_REPORT.md`
- `UPLOAD_STATUS.md`
- `APP_STORE_CONNECT_METADATA.md`
- `APP_REVIEW_NOTES.md`
- `QA_RELEASE_EVIDENCE.md`
- `APP_STORE_RELEASE_CHECKLIST.md`
- `SHA256SUMS.txt`
- `Archive/TagLauncher-8.2.8-build20260630.0128.dmg`
- `Upload/TagLauncher-8.2.8-build20260630.0128.pkg`

这些 release 文件当前是新增未跟踪文件，尚未单独 commit。

## 当前阻塞

App Store Connect 页面已在 Arc 打开，但停在 Apple 账号认证页：

- 账号：`shanghai3168@gmail.com`
- URL 指向 App Store Connect/TestFlight macOS build 页面
- 状态：需要用户完成 Apple ID 认证、通行密钥、密码、Touch ID 或 2FA

Codex 不能代输或代点账号认证、密码、通行密钥、Touch ID 或 2FA，因此最终选择 build、填写 ASC 元数据并点击提交审核还未完成。

## 下一步

用户在 Arc 中完成 Apple ID 登录后，继续：

1. 进入 TagLauncher App Store Connect macOS 版本页。
2. 选择 build `8.2.8 (20260630.0128)`。
3. 如出现 Missing Compliance，选择 `None of the algorithms mentioned above`。
4. 使用 `APP_STORE_CONNECT_METADATA.md` 填写 What's New。
5. 使用 `APP_REVIEW_NOTES.md` 填写 Review Notes。
6. 点击 `Add for Review` / `Submit for Review`。