# 2026-06-04 Mac App Store 发布冻结

## 冻结结论

- 冻结版本: `2.1.28`
- build: `20260604.0049`
- 分支: `codex/privatevoice-freeze-2.1.25`
- 源码冻结 commit: `9d3d275dca8e8dc442eb04434c8bd0fdad79bc04`
- release tag: `v2.1.28-build20260604.0049`
- release 记录目录: `Release/PrivateVoice-Dictation-2.1.28-build20260604.0049/`

## 已完成

- 版本号和 build 编号已同步到 Go 常量、macOS `Info.plist`、Wails 配置、Windows manifest、前端 package 和关于页兜底版本。
- 已补充 Mac App Store `.pkg` 构建脚本: `privatevoice.src/scripts/build-macappstore-pkg-macos.sh`。
- 已准备 App Store Connect 元数据草稿、隐私问卷建议、审核备注和上传命令: `Release/PrivateVoice-Dictation-2.1.28-build20260604.0049/APP_STORE_CONNECT_SUBMISSION.md`。
- 已生成本地 App Store sandbox POC DMG:
  `Release/PrivateVoice-Dictation-2.1.28-build20260604.0049/PrivateVoice Dictation-2.1.28-build20260604.0049-arm64-appstore-sandbox-poc.dmg`。
- 已补生成 Intel x86_64 本地 App Store sandbox POC DMG:
  `Release/PrivateVoice-Dictation-2.1.28-build20260604.0049/PrivateVoice Dictation-2.1.28-build20260604.0049-x86_64-appstore-sandbox-poc.dmg`。
- arm64 SHA256: `fcef2154aab52224f55874ea865d6a08efe71a2d09768d7fbc8858d319a64024`。
- x86_64 SHA256: `899bf95f579455794f9cffbadc33d1e90dbba4b6fc1b3d237229115691373606`。

## 验证

- `git diff --check`: PASS
- `bash -n privatevoice.src/scripts/build-macappstore-pkg-macos.sh`: PASS
- `npm run build`: PASS，只有既有 Svelte a11y warning
- `go test ./... -count=1`: PASS
- `./scripts/build-appstore-macos.sh arm64`: PASS
- `./scripts/build-appstore-macos.sh x86_64`: PASS
- App Store sandbox POC DMG `hdiutil verify`: arm64 PASS，x86_64 PASS
- DMG 挂载内容包含 `.app` 和 `Applications` 链接: arm64 PASS，x86_64 PASS
- 包内版本为 `2.1.28 (build 20260604.0049)`: arm64 PASS，x86_64 PASS
- 包内包含 `en.lproj` 和 `zh-Hans.lproj` 本地化资源: arm64 PASS，x86_64 PASS
- x86_64 主程序架构为 `Mach-O 64-bit executable x86_64`: PASS

## 等待用户/外部环境

当前正在等待用户提供或安装 Apple 发布环境，原因是本机没有 Mac App Store 上传所需的 Apple 分发证书、Installer 证书和 provisioning profile。

需要用户完成：

1. 在 Apple Developer / App Store Connect 中创建或确认 bundle ID `com.privatevoice.input` 的 macOS App 记录。
2. 安装 App Store app signing identity：
   `Apple Distribution: <Team> (<TeamID>)` 或 `3rd Party Mac Developer Application: <Team> (<TeamID>)`。
3. 安装 Installer signing identity：
   `3rd Party Mac Developer Installer: <Team> (<TeamID>)`。
4. 下载 Mac App Store provisioning profile，并提供本地绝对路径。
5. 提供 App Store Connect 上传方式：Transporter 登录状态，或 altool 使用的 Apple ID / app-specific password。

收到这些信息后，下一步执行：

```bash
cd /Users/ar/Projects/PrivateVoice/privatevoice.src

PRIVATEVOICE_APPSTORE_APP_IDENTITY="Apple Distribution: <Team> (<TeamID>)" \
PRIVATEVOICE_APPSTORE_INSTALLER_IDENTITY="3rd Party Mac Developer Installer: <Team> (<TeamID>)" \
PRIVATEVOICE_APPSTORE_PROVISIONING_PROFILE="/absolute/path/to/profile.provisionprofile" \
  ./scripts/build-macappstore-pkg-macos.sh arm64
```

然后用 `pkgutil --check-signature`、`xcrun altool --validate-app` 或 Transporter 验证并上传生成的 `.pkg`。