GitHub Release

Publish a new TransFlow version to GitHub Releases with DMG attachment.

Prerequisites

• gh CLI installed and authenticated (gh auth status)
• create-dmg installed (brew install create-dmg)
• Xcode Command Line Tools
• Working directory clean (no uncommitted changes unrelated to release)

Workflow

Parse the target version from the user's request (e.g. "发布 v1.2.0" → 1.2.0). Strip the v prefix for version strings used in code; keep v prefix for git tags.

Task Progress:
- [ ] Step 1: Pre-flight checks
- [ ] Step 2: Update version numbers
- [ ] Step 3: Generate release notes
- [ ] Step 4: Commit, tag, push
- [ ] Step 5: Build DMG locally
- [ ] Step 6: Create GitHub Release with DMG
- [ ] Step 7: Verify release

Step 1: Pre-flight checks

Run in parallel:

• gh auth status — confirm GitHub CLI is authenticated
• git status — confirm working directory is clean (or only has expected changes)
• git log --oneline -20 — review recent commits for release notes

Step 2: Update version numbers

Update MARKETING_VERSION in all 6 locations inside project.pbxproj:

bash
1# File: TransFlow/TransFlow.xcodeproj/project.pbxproj
2# Replace all occurrences:
3MARKETING_VERSION = <old>;  →  MARKETING_VERSION = <new>;

Update fallback version strings in Swift source:

Step 3: Generate release notes

Create release-notes/vX.Y.Z.md based on git log since the last tag (or all commits if first release).

Convention: All release notes live in the release-notes/ directory at the repo root, named v<version>.md (e.g. release-notes/v1.0.0.md).

Release notes template:

markdown
1# TransFlow vX.Y.Z
2
3[One-line summary of this release]
4
5## What's New
6- Feature 1
7- Feature 2
8
9## Improvements
10- Improvement 1
11
12## Bug Fixes
13- Fix 1 (if any)
14
15## System Requirements
16- macOS 15.0 or later
17- Apple Silicon (arm64) or Intel (x86_64)

If there is a previous tag, use git log <prev-tag>..HEAD --oneline to scope changes.

Step 4: Commit, tag, push

bash
1git add -A
2git commit -m "release: bump version to vX.Y.Z"
3git tag -a vX.Y.Z -m "TransFlow vX.Y.Z"
4git push origin main --tags

Step 5: Build DMG locally

bash
1./scripts/build-dmg.sh --clean --sign

• --sign auto-detects signing identity and auto-loads project entitlements (microphone, etc.)
• The build disables Xcode signing; the script handles signing separately for consistency
• Signing identity: 5JNN9A6Z6X, Team ID: 8RQVLSP2SC
• Set block_until_ms to 300000 (5 min) — build + DMG takes time
• Output: build/TransFlow-X.Y.Z.dmg
• Verify the DMG file exists and is non-empty before proceeding

Step 6: Create GitHub Release

bash
1gh release create vX.Y.Z \
2  --title "TransFlow vX.Y.Z" \
3  --notes-file release-notes/vX.Y.Z.md \
4  ./build/TransFlow-X.Y.Z.dmg

Step 7: Verify release

bash
1gh release view vX.Y.Z

Confirm:

• Title and tag are correct
• draft: false, prerelease: false
• DMG asset is listed with non-zero size
• Release notes render correctly

Report the release URL to the user.

Error Handling