# TagLauncher 5.7.5 Release Package

Version: 5.7.5
Build: 575
Bundle ID: com.apptag.launcher
Minimum macOS: 15.0

## Package Contents

- `Artifacts/TagLauncher.app`
  - Built app bundle for local verification.
  - Current signature is ad-hoc. Do not upload this exact bundle to App Store Connect without re-signing on the Apple Developer machine.
- `Artifacts/TagLauncher-5.7.5.dmg`
  - Local distribution/test DMG.
  - Useful for manual validation, not the App Store upload artifact.
- `Docs/AppStore_Submission-5.7.5.md`
  - App Store listing text, What's New, privacy notes, review notes, and sandbox notes.
- `Assets/AppStore_1024.png`
  - 1024 x 1024 App Store icon PNG.
- `Source/`
  - Source snapshot and build scripts needed to rebuild on another Mac.

## Pre-Upload Checklist

1. Install Apple Developer certificates on the upload Mac.
2. Rebuild with App Store mode and a real signing identity.
3. Confirm the built app reports:
   - `CFBundleShortVersionString = 5.7.5`
   - `CFBundleVersion = 575`
4. Confirm entitlements include:
   - `com.apple.security.app-sandbox`
   - `com.apple.security.files.user-selected.read-write`
   - legacy read-only migration exception for `/Library/Application Support/Apptag/`
5. Create the upload artifact required by your upload workflow.
6. Upload through Transporter, Xcode Organizer, or the command-line workflow used on the Apple Developer machine.

## Rebuild Command

From the `Source` folder's parent directory on the Apple Developer Mac:

```bash
cd Source
APP_STORE=1 CODESIGN_IDENTITY="Apple Distribution: Your Name (TEAMID)" bash build.sh
```

The included app was built successfully with App Store entitlements, but with ad-hoc signing on this machine because no Apple Distribution identity was configured here.

## Notes For App Store Connect

Use `Docs/AppStore_Submission-5.7.5.md` for:

- version and build metadata
- English and Chinese app descriptions
- What's New text
- review notes
- privacy / sandbox explanation

Use `Assets/AppStore_1024.png` for the App Store icon asset if needed.

## Important

The DMG is useful for your own transfer/testing, but Mac App Store upload normally requires a properly signed app archive or package produced on the Developer account machine. Treat this folder as the complete handoff package, not as a pre-signed App Store upload.