edit | blame | history | raw

Build, Sign, Package, Upload

当前状态

本目录内的 DMG 是本地 QA / 可回滚候选包：

  • Archive/TagLauncher-7.8.13-build20260604.1121.dmg
  • SHA256: f594509807ca5aa72c6a9fdf118a4f3c9ee991528cd5dbe68587ea5fe601d6f6

它不是 App Store Connect 最终上传包。App Store 上传需要 Apple Developer 账号侧证书和 provisioning profile。

账号侧前置条件

  • Apple Developer Program 会员有效。
  • App Store Connect 中存在 macOS app record。
  • Bundle ID 是 com.taglauncher.app。
  • Keychain 中有 Mac App Distribution 或 Apple Distribution 证书。
  • Keychain 中有 Mac Installer Distribution 证书。
  • 已下载并安装匹配 com.taglauncher.app 的 Mac App Store provisioning profile。

手动签名构建示例

把证书名称替换为你 Keychain 中的真实名称：

APP_STORE=1 \
APP_BUILD=20260604.1121 \
CODESIGN_IDENTITY="Mac App Distribution: YOUR NAME (TEAMID)" \
zsh ./build.sh

验证：

codesign --verify --deep --strict build/TagLauncher.app
codesign -d --entitlements :- build/TagLauncher.app
/usr/libexec/PlistBuddy -c 'Print :CFBundleShortVersionString' build/TagLauncher.app/Contents/Info.plist
/usr/libexec/PlistBuddy -c 'Print :CFBundleVersion' build/TagLauncher.app/Contents/Info.plist

生成 Mac App Store 上传包

示例命令：

mkdir -p build/AppStore
productbuild \
  --component build/TagLauncher.app /Applications \
  --sign "Mac Installer Distribution: YOUR NAME (TEAMID)" \
  build/AppStore/TagLauncher-7.8.13-build20260604.1121.pkg

验证 package 签名：

pkgutil --check-signature build/AppStore/TagLauncher-7.8.13-build20260604.1121.pkg

上传方式

Apple 当前支持用 Xcode、Swift Playground、altool 或 Transporter 上传构建。对这个项目，推荐先用 Transporter 图形界面上传 .pkg，因为它能直接显示交付日志和错误。

可选命令行校验和上传：

xcrun altool --validate-app \
  -f build/AppStore/TagLauncher-7.8.13-build20260604.1121.pkg \
  -t macos \
  -u APPLE_ID_EMAIL \
  -p APP_SPECIFIC_PASSWORD

xcrun altool --upload-app \
  -f build/AppStore/TagLauncher-7.8.13-build20260604.1121.pkg \
  -t macos \
  -u APPLE_ID_EMAIL \
  -p APP_SPECIFIC_PASSWORD

上传后检查

  • App Store Connect 中 build 进入 Processing。
  • Processing 完成后，选择 version 7.8.13 的 build。
  • 检查没有 Invalid Binary、Missing Entitlement、Bundle ID mismatch、version/build mismatch。
  • 填写 APP_STORE_CONNECT_METADATA.md 中的文案。
  • 上传 Screenshots/AppStore/ 中的截图。
  • 发布隐私政策 URL，并在 App Privacy 中提交问卷。
  • 提交 App Review。