From 94c5e7e2dbda6c311f5685c8a211c04bc06438db Mon Sep 17 00:00:00 2001 From: Ariver <shanghai3168@gmail.com> Date: Mon, 25 May 2026 00:22:30 +0800 Subject: [PATCH] Freeze App Store release pack for build 20260525.0016 --- Release/AppStore-7.6.0-20260525.0016/Support/SUPPORT.md | 52 +++++ Release/AppStore-7.6.0-20260525.0016/BUILD_SIGN_UPLOAD.md | 10 Release/AppStore-7.6.0-20260525.0016/Screenshots/SCREENSHOT_SHOT_LIST.md | 63 +++++++ Release/AppStore-7.6.0-20260525.0016/Archive/TagLauncher-7.6.0-20260525.0016-local-QA.dmg | 0 Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.zh-Hans.md | 74 ++++++++ Release/AppStore-7.6.0-20260525.0016/APP_STORE_ASSET_INVENTORY.md | 76 ++++++++ Release/AppStore-7.6.0-20260525.0016/README.md | 25 ++ Release/AppStore-7.6.0-20260525.0016/APP_STORE_CONNECT_METADATA.md | 6 Release/AppStore-7.6.0-20260525.0016/QA_RELEASE_EVIDENCE.md | 17 + Release/AppStore-7.6.0-20260525.0016/FIRST_TIME_MAC_APP_STORE_TODO.md | 8 Release/AppStore-7.6.0-20260525.0016/Submitted/.gitkeep | 0 Release/AppStore-7.6.0-20260525.0016/Review/APP_REVIEW_NOTES.md | 34 +++ Release/AppStore-7.6.0-20260525.0016/Support/GITHUB_PAGES_PUBLICATION_GUIDE.md | 79 ++++++++ Release/AppStore-7.6.0-20260525.0016/Assets/TagLauncher-AppIcon-1024.png | 0 Release/AppStore-7.6.0-20260525.0016/Screenshots/raw/.gitkeep | 0 Release/AppStore-7.6.0-20260525.0016/Upload/.gitkeep | 0 Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.md | 74 ++++++++ Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore/.gitkeep | 0 18 files changed, 492 insertions(+), 26 deletions(-) diff --git a/Release/AppStore-7.6.0-20260525.0016/APP_STORE_ASSET_INVENTORY.md b/Release/AppStore-7.6.0-20260525.0016/APP_STORE_ASSET_INVENTORY.md new file mode 100644 index 0000000..0fc59a1 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/APP_STORE_ASSET_INVENTORY.md @@ -0,0 +1,76 @@ +# App Store Asset Inventory + +This release pack is frozen for TagLauncher `7.6.0` build `20260525.0016`. + +Use this file as the submission asset checklist. Anything marked `Needs user input` must be completed before submitting in App Store Connect. + +## Frozen Build + +- Version: `7.6.0` +- Local QA build: `20260525.0016` +- Source commit: `0258b3e` +- Local QA DMG: `Archive/TagLauncher-7.6.0-20260525.0016-local-QA.dmg` +- DMG SHA-256: `4689856f4a976c394ef4737db5bb5eebcc5b5bb95eea81fe72f5b6c3e3ed4b23` +- App binary SHA-256: `01ace57df10061fd7d684fa8a5bd795f87f55ee2c713cbb1ab2d01f5f63ed404` + +## Metadata + +- Draft App Store metadata: `APP_STORE_CONNECT_METADATA.md` +- First-time submission checklist: `FIRST_TIME_MAC_APP_STORE_TODO.md` +- Build/sign/upload instructions: `BUILD_SIGN_UPLOAD.md` +- QA and release evidence: `QA_RELEASE_EVIDENCE.md` +- Changelog source: `../../CHANGELOG.md` + +Status: ready as draft, but App Store Connect fields must still be reviewed manually. + +## Screenshots + +- Screenshot instructions: `Screenshots/SCREENSHOT_SHOT_LIST.md` +- Raw screenshot staging folder: `Screenshots/raw/` +- App Store-ready screenshot folder: `Screenshots/AppStore/` + +Status: needs user screenshots. + +Apple accepts one to ten screenshots for Mac apps. Mac screenshots must use a 16:10 size such as `2880 x 1800`, `2560 x 1600`, `1440 x 900`, or `1280 x 800`. + +Recommended final screenshot count: 5. + +## App Icon + +- App icon source copy: `Assets/TagLauncher-AppIcon-1024.png` + +Status: present. + +## Legal And URLs + +- Privacy policy draft: `Legal/PRIVACY_POLICY.md` +- Simplified Chinese privacy policy draft: `Legal/PRIVACY_POLICY.zh-Hans.md` +- Support page draft: `Support/SUPPORT.md` +- Public URL publication guide: `Support/GITHUB_PAGES_PUBLICATION_GUIDE.md` + +Status: content drafted; needs user identity/contact fields and public URLs. + +Needs user input: + +- Developer or company display name. +- Support email. +- Privacy contact email, if different. +- Public privacy policy URL. +- Public support URL. +- Copyright holder. + +## App Review + +- App Review notes draft: `Review/APP_REVIEW_NOTES.md` +- Manual QA notes area: `Review/` + +Status: ready as draft. + +## Upload Artifacts + +- App Store upload staging folder: `Upload/` +- Submitted artifact archive folder: `Submitted/` + +Status: waiting for App Store signing assets and final uploaded build. + +The local DMG is not an App Store upload artifact. App Store upload still requires Mac App Distribution signing, Mac Installer Distribution signing if packaging a `.pkg`, and a Mac App Store provisioning profile for `com.taglauncher.app`. diff --git a/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md b/Release/AppStore-7.6.0-20260525.0016/APP_STORE_CONNECT_METADATA.md similarity index 97% rename from Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md rename to Release/AppStore-7.6.0-20260525.0016/APP_STORE_CONNECT_METADATA.md index 34152b4..0831030 100644 --- a/Release/AppStore-7.6.0-20260524.1849/APP_STORE_CONNECT_METADATA.md +++ b/Release/AppStore-7.6.0-20260525.0016/APP_STORE_CONNECT_METADATA.md @@ -5,9 +5,9 @@ Frozen local QA source for this metadata: - Version: `7.6.0` -- Build: `20260524.1849` -- Source commit: `ba34712` -- Release pack: `Release/AppStore-7.6.0-20260524.1849` +- Build: `20260525.0016` +- Source commit: `0258b3e` +- Release pack: `Release/AppStore-7.6.0-20260525.0016` ## App Information diff --git a/Release/AppStore-7.6.0-20260525.0016/Archive/TagLauncher-7.6.0-20260525.0016-local-QA.dmg b/Release/AppStore-7.6.0-20260525.0016/Archive/TagLauncher-7.6.0-20260525.0016-local-QA.dmg new file mode 100644 index 0000000..0aa8fd1 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Archive/TagLauncher-7.6.0-20260525.0016-local-QA.dmg Binary files differ diff --git a/Release/AppStore-7.6.0-20260525.0016/Assets/TagLauncher-AppIcon-1024.png b/Release/AppStore-7.6.0-20260525.0016/Assets/TagLauncher-AppIcon-1024.png new file mode 100644 index 0000000..3633d92 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Assets/TagLauncher-AppIcon-1024.png Binary files differ diff --git a/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md b/Release/AppStore-7.6.0-20260525.0016/BUILD_SIGN_UPLOAD.md similarity index 91% rename from Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md rename to Release/AppStore-7.6.0-20260525.0016/BUILD_SIGN_UPLOAD.md index 185534e..dbd91bd 100644 --- a/Release/AppStore-7.6.0-20260524.1849/BUILD_SIGN_UPLOAD.md +++ b/Release/AppStore-7.6.0-20260525.0016/BUILD_SIGN_UPLOAD.md @@ -4,10 +4,10 @@ The local QA build is suitable for verification and direct local testing, but it is not an App Store upload artifact. -- Frozen local QA build: `20260524.1849` -- Frozen source commit: `ba34712` -- Frozen DMG SHA-256: `dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193` -- Frozen app binary SHA-256: `a59f08f214bd4ac667197f6b2f2672aaf4a57c1fdd9872ea385099e84f18fa57` +- Frozen local QA build: `20260525.0016` +- Frozen source commit: `0258b3e` +- Frozen DMG SHA-256: `4689856f4a976c394ef4737db5bb5eebcc5b5bb95eea81fe72f5b6c3e3ed4b23` +- Frozen app binary SHA-256: `01ace57df10061fd7d684fa8a5bd795f87f55ee2c713cbb1ab2d01f5f63ed404` - Local build command: `bash build.sh` - Local DMG command: `bash make_dmg.sh` - App path: `build/TagLauncher.app` @@ -54,7 +54,7 @@ APP_STORE=1 \ CODESIGN_IDENTITY="3rd Party Mac Developer Application: <TEAM NAME> (<TEAMID>)" \ -APP_BUILD=20260524.1849 \ +APP_BUILD=20260525.0016 \ bash build.sh productbuild \ diff --git a/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md b/Release/AppStore-7.6.0-20260525.0016/FIRST_TIME_MAC_APP_STORE_TODO.md similarity index 95% rename from Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md rename to Release/AppStore-7.6.0-20260525.0016/FIRST_TIME_MAC_APP_STORE_TODO.md index 924943c..e340b0b 100644 --- a/Release/AppStore-7.6.0-20260524.1849/FIRST_TIME_MAC_APP_STORE_TODO.md +++ b/Release/AppStore-7.6.0-20260525.0016/FIRST_TIME_MAC_APP_STORE_TODO.md @@ -5,9 +5,9 @@ Frozen release pack: - Version: `7.6.0` -- Local QA build: `20260524.1849` -- Source commit: `ba34712` -- Release folder: `Release/AppStore-7.6.0-20260524.1849` +- Local QA build: `20260525.0016` +- Source commit: `0258b3e` +- Release folder: `Release/AppStore-7.6.0-20260525.0016` ## 0. Before Touching App Store Connect @@ -67,7 +67,7 @@ - [ ] Build the App Store-signed app using `BUILD_SIGN_UPLOAD.md`. - [ ] Verify `CFBundleShortVersionString = 7.6.0`. -- [ ] Start from frozen local QA build `20260524.1849`; use a newer `CFBundleVersion` only if App Store upload retries require it. +- [ ] Start from frozen local QA build `20260525.0016`; use a newer `CFBundleVersion` only if App Store upload retries require it. - [ ] Increment `CFBundleVersion` for every upload attempt. - [ ] Verify sandbox entitlements are present. - [ ] Run `Scripts/window_logic_qa.sh` against the signed build before uploading. diff --git a/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.md b/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.md new file mode 100644 index 0000000..af15d6f --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.md @@ -0,0 +1,74 @@ +# Privacy Policy for TagLauncher + +Effective date: May 24, 2026 + +Developer: `[YOUR NAME OR COMPANY NAME]` + +Contact: `[PRIVACY OR SUPPORT EMAIL]` + +This Privacy Policy explains how TagLauncher handles information. + +## Summary + +TagLauncher is designed as a local macOS utility. It does not include analytics, advertising SDKs, tracking SDKs, or telemetry. TagLauncher does not sell personal information and does not track users across apps or websites. + +## Information TagLauncher Handles Locally + +TagLauncher may access or store the following information on your Mac: + +- A local list of installed applications, used to build the app launcher grid and search index. +- App names, bundle identifiers, icons, tags, notes, category layout, display preferences, and keyboard shortcut settings. +- Imported or exported category/layout files that you explicitly choose through macOS file panels. + +This information is used only to provide TagLauncher's app organization, launch, search, import/export, and settings features. + +## Data Collection + +TagLauncher does not collect personal data from you or transmit personal data to the developer. + +TagLauncher does not use: + +- Analytics services. +- Advertising networks. +- Third-party tracking SDKs. +- Remote telemetry. +- User behavior profiling. + +## Network Access + +TagLauncher does not require a network service to organize or launch your local apps. + +If you open external links such as Help, Support, or Privacy Policy links, macOS may open those links in your web browser. Those external websites are subject to their own privacy practices. + +## Local Storage + +TagLauncher stores preferences and app organization data locally on your Mac, using standard macOS storage such as UserDefaults and the user's Application Support folder. + +You can remove local TagLauncher data by deleting the app and its related local support files, subject to normal macOS behavior. + +## User-Selected Files + +TagLauncher may read from or write to files only when you choose import or export locations through macOS file panels. TagLauncher uses those files only for the import/export operation you requested. + +## App Store Privacy + +Based on the current TagLauncher build, the intended App Store privacy response is: + +- Data collected: No. +- Tracking: No. + +These answers should be reviewed again before submission if new features, network services, analytics, crash reporting, or support integrations are added. + +## Children's Privacy + +TagLauncher is a general-purpose macOS utility and is not directed to children. TagLauncher does not knowingly collect personal information from children. + +## Changes To This Policy + +This policy may be updated when TagLauncher changes. The effective date at the top of this page indicates the latest version. + +## Contact + +If you have questions about this Privacy Policy or TagLauncher privacy behavior, contact: + +`[PRIVACY OR SUPPORT EMAIL]` diff --git a/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.zh-Hans.md b/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.zh-Hans.md new file mode 100644 index 0000000..db81910 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.zh-Hans.md @@ -0,0 +1,74 @@ +# TagLauncher 隐私政策 + +生效日期：2026 年 5 月 24 日 + +开发者：`[你的姓名或公司名称]` + +联系邮箱：`[隐私或支持邮箱]` + +本隐私政策说明 TagLauncher 如何处理信息。 + +## 摘要 + +TagLauncher 是一个本地运行的 macOS 工具。当前版本不包含分析 SDK、广告 SDK、追踪 SDK 或遥测功能。TagLauncher 不出售个人信息，也不会跨 App 或网站追踪用户。 + +## TagLauncher 在本地处理的信息 + +TagLauncher 可能会在你的 Mac 上访问或保存以下信息： + +- 本机已安装应用列表，用于生成应用启动网格和搜索索引。 +- 应用名称、Bundle ID、图标、标签、备注、分类布局、显示偏好和快捷键设置。 +- 你通过 macOS 文件选择面板主动选择导入或导出的分类/布局文件。 + +这些信息只用于提供 TagLauncher 的应用整理、启动、搜索、导入导出和设置功能。 + +## 数据收集 + +TagLauncher 不会从你这里收集个人数据，也不会把个人数据发送给开发者。 + +TagLauncher 不使用： + +- 分析服务。 +- 广告网络。 +- 第三方追踪 SDK。 +- 远程遥测。 +- 用户行为画像。 + +## 网络访问 + +TagLauncher 不需要网络服务即可整理和启动本地应用。 + +如果你打开帮助、支持或隐私政策等外部链接，macOS 可能会在浏览器中打开这些网页。外部网站适用其各自的隐私规则。 + +## 本地存储 + +TagLauncher 使用标准 macOS 存储方式在本机保存偏好和应用整理数据，例如 UserDefaults 和用户的 Application Support 文件夹。 + +你可以按照 macOS 的常规方式删除 App 及其相关本地支持文件，以移除 TagLauncher 的本地数据。 + +## 用户选择的文件 + +只有当你通过 macOS 文件选择面板主动选择导入或导出位置时，TagLauncher 才会读取或写入相关文件。TagLauncher 只会将这些文件用于你请求的导入或导出操作。 + +## App Store 隐私信息 + +基于当前 TagLauncher 构建，计划填写的 App Store 隐私信息为： + +- 收集的数据：否。 +- 追踪：否。 + +如果后续加入网络服务、分析、崩溃上报、支持系统或其他新功能，提交前需要重新审核这些答案。 + +## 儿童隐私 + +TagLauncher 是通用 macOS 工具，并非面向儿童。TagLauncher 不会有意收集儿童的个人信息。 + +## 政策更新 + +当 TagLauncher 发生变化时，本政策可能会更新。页面顶部的生效日期表示当前版本。 + +## 联系方式 + +如果你对本隐私政策或 TagLauncher 的隐私行为有问题，请联系： + +`[隐私或支持邮箱]` diff --git a/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md b/Release/AppStore-7.6.0-20260525.0016/QA_RELEASE_EVIDENCE.md similarity index 76% rename from Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md rename to Release/AppStore-7.6.0-20260525.0016/QA_RELEASE_EVIDENCE.md index 26a210d..1403c9e 100644 --- a/Release/AppStore-7.6.0-20260524.1849/QA_RELEASE_EVIDENCE.md +++ b/Release/AppStore-7.6.0-20260525.0016/QA_RELEASE_EVIDENCE.md @@ -3,8 +3,8 @@ ## Local Build - Version: `7.6.0` -- Build: `20260524.1849` -- Frozen source commit: `ba34712` +- Build: `20260525.0016` +- Frozen source commit: `0258b3e` - App path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.app` - DMG path: `/Users/ar/Projects/Taglauncher/build/TagLauncher.dmg` - App executable size: `1.4M` @@ -13,8 +13,8 @@ ## Hashes ```text -dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193 build/TagLauncher.dmg -a59f08f214bd4ac667197f6b2f2672aaf4a57c1fdd9872ea385099e84f18fa57 build/TagLauncher.app/Contents/MacOS/TagLauncher +4689856f4a976c394ef4737db5bb5eebcc5b5bb95eea81fe72f5b6c3e3ed4b23 build/TagLauncher.dmg +01ace57df10061fd7d684fa8a5bd795f87f55ee2c713cbb1ab2d01f5f63ed404 build/TagLauncher.app/Contents/MacOS/TagLauncher ``` ## Commands Run @@ -36,7 +36,7 @@ ALL WINDOW LOGIC QA PASSED ``` -This is the frozen QA result for build `20260524.1849`. Earlier build `20260524.1652` should not be used for App Store prep because it did not include the final fullscreen/Split View Quick Search and Settings session fix. +This is the frozen QA result for build `20260525.0016`. Earlier builds `20260524.1652` and `20260524.1849` should not be used for App Store prep because they did not include the final fullscreen/Split View Quick Search, Settings close/refocus, and same-app Split View fixes. Covered checks: @@ -47,14 +47,16 @@ - Fullscreen Space overlay bounds must match the fullscreen target display and remain stable across repeated samples. - Fullscreen Space Quick Search opens from app grid without switching away from the current fullscreen app. - Fullscreen Space Settings opens from app grid without switching away from the current fullscreen app. +- Closing Settings in a fullscreen/Split View overlay session does not reactivate TagLauncher into another Space. - Split View fullscreen geometry is checked for 50/50 and 33/67 split layouts, while ordinary side-by-side desktop windows are rejected. +- Same-app two-window Split View geometry follows the same fullscreen Split View path as two-app Split View. - App grid claims foreground, hides Dock, and keeps menu bar visible. - Settings floats above app grid. - File panel floats above Settings. - Quick Search stays above app grid and supports two-Escape logic. - Clicking outside Quick Search closes search, not app grid. - System Force Quit window stays above TagLauncher. -- Pointer-following logic was checked; this machine had one physical display, so the static single-display code path was verified. +- Pointer-following logic was checked on two displays; AppGrid followed the pointer on each screen. ## Crash Check @@ -80,7 +82,8 @@ ## Help PDF Verification -- The broken macOS system Help menu entry was removed. +- The broken macOS Help Book binding was removed. +- The standard menu bar now has a localized Help menu with a single `Download Help PDF` item. - The About page includes an `Open Help PDF` button and a copy-link button. - The app binary contains the immutable GitHub Release Help PDF URL shape. - The app binary no longer contains the old `raw.githubusercontent` Help URL or `TagLauncherLocalizedHelpMenuItem`. diff --git a/Release/AppStore-7.6.0-20260524.1849/README.md b/Release/AppStore-7.6.0-20260525.0016/README.md similarity index 74% rename from Release/AppStore-7.6.0-20260524.1849/README.md rename to Release/AppStore-7.6.0-20260525.0016/README.md index 3e67d7e..9b10aed 100644 --- a/Release/AppStore-7.6.0-20260524.1849/README.md +++ b/Release/AppStore-7.6.0-20260525.0016/README.md @@ -8,18 +8,18 @@ - Platform: macOS / Mac App Store - Bundle ID: `com.taglauncher.app` - Version: `7.6.0` -- Local QA build: `20260524.1849` -- Frozen source commit: `ba34712` +- Local QA build: `20260525.0016` +- Frozen source commit: `0258b3e` - Frozen source branch: `main` -- Release folder: `Release/AppStore-7.6.0-20260524.1849` -- DMG SHA-256: `dc5bc9cf90b9e04a9e4fda155b757e6e0af681ff1b79bf109552ae0c3ce2a193` -- App binary SHA-256: `a59f08f214bd4ac667197f6b2f2672aaf4a57c1fdd9872ea385099e84f18fa57` +- Release folder: `Release/AppStore-7.6.0-20260525.0016` +- DMG SHA-256: `4689856f4a976c394ef4737db5bb5eebcc5b5bb95eea81fe72f5b6c3e3ed4b23` +- App binary SHA-256: `01ace57df10061fd7d684fa8a5bd795f87f55ee2c713cbb1ab2d01f5f63ed404` ## Freeze Status -This release pack is frozen on the locally QA-passed build `20260524.1849`. Use this folder, its hashes, and its metadata as the source of truth for the first Mac App Store submission prep. +This release pack is frozen on the locally QA-passed build `20260525.0016`. Use this folder, its hashes, and its metadata as the source of truth for the first Mac App Store submission prep. -Do not use earlier prep folders or builds such as `20260524.1652`; they predate the final fullscreen/Split View secondary-window fix. +Do not use earlier prep folders or builds such as `20260524.1652` or `20260524.1849`; they predate the final fullscreen/Split View secondary-window close and same-app Split View fixes. ## What Changed For This Release @@ -33,15 +33,26 @@ - Hardened fullscreen Space presentation so the app grid stays above the current fullscreen app instead of moving to another Space. - Added Split View fullscreen detection so two apps sharing one fullscreen Space also keep the app grid on the current Space. - Kept Quick Search and Settings inside the same fullscreen/Split View Space session instead of activating TagLauncher and sliding to another Space. +- Kept Settings close/refocus inside the same fullscreen/Split View Space session. +- Treated same-app two-window Split View as fullscreen Split View, not only two different apps. - Expanded window QA to cover fullscreen Space behavior with Dock icon both enabled and disabled, including AppGrid, Quick Search, Settings, and stability checks. - Strengthened the window logic QA script to cover fullscreen Space, duplicate Dock tiles, repeated self-launch, force quit layering, Settings/file panel layering, Quick Search, and two-display pointer-following behavior. ## Folder Contents +- `APP_STORE_ASSET_INVENTORY.md`: complete submission asset checklist and missing-item tracker. - `FIRST_TIME_MAC_APP_STORE_TODO.md`: step-by-step checklist for a first Mac App Store submission. - `APP_STORE_CONNECT_METADATA.md`: draft metadata, review notes, privacy answers, screenshot plan. - `BUILD_SIGN_UPLOAD.md`: exact build/sign/upload path and current signing blockers. - `QA_RELEASE_EVIDENCE.md`: local QA evidence and artifact hashes. +- `Screenshots/`: screenshot shot list, raw screenshot staging, and App Store-ready screenshot folder. +- `Legal/`: privacy policy drafts. +- `Support/`: support page draft and GitHub Pages publication guide. +- `Review/`: App Review notes draft. +- `Assets/`: app icon copy and other static submission assets. +- `Archive/`: local QA artifact archive. +- `Upload/`: placeholder for App Store-signed upload artifacts. +- `Submitted/`: placeholder for final submitted App Store Connect build records. ## Archived Old Release Pack diff --git a/Release/AppStore-7.6.0-20260525.0016/Review/APP_REVIEW_NOTES.md b/Release/AppStore-7.6.0-20260525.0016/Review/APP_REVIEW_NOTES.md new file mode 100644 index 0000000..3d8cb84 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Review/APP_REVIEW_NOTES.md @@ -0,0 +1,34 @@ +# App Review Notes + +Use this text as the starting point for App Review notes in App Store Connect. + +## Review Notes Draft + +TagLauncher is a macOS utility for organizing installed applications into visual tag groups and launching them from a keyboard-accessible app grid. + +Primary review flow: + +1. Launch TagLauncher. +2. Press `Option-Shift-Space` to show the app grid. +3. Press `Space` while the app grid is visible to open Quick Search. +4. Press `Escape` once to close Quick Search. +5. Press `Escape` again to close the app grid. +6. Open Settings from the menu bar or with `Command-Comma`. + +Expected behavior: + +- The app grid intentionally appears above normal and fullscreen app windows. +- In fullscreen and Split View Spaces, AppGrid, Quick Search, and Settings should remain in the current Space instead of switching to another Space. +- While the app grid is visible, TagLauncher hides the Dock and shows TagLauncher's menu bar. +- The system Force Quit window remains above TagLauncher. +- Import/export uses standard macOS file panels. +- In sandboxed App Store builds, login-at-launch may be disabled if the LaunchAgent approach is unavailable. + +No demo account is required. + +## Local QA Evidence + +- QA evidence file: `QA_RELEASE_EVIDENCE.md` +- Final result: `ALL WINDOW LOGIC QA PASSED` +- Frozen local build: `20260525.0016` +- Frozen source commit: `0258b3e` diff --git a/Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore/.gitkeep b/Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore/.gitkeep new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore/.gitkeep diff --git a/Release/AppStore-7.6.0-20260525.0016/Screenshots/SCREENSHOT_SHOT_LIST.md b/Release/AppStore-7.6.0-20260525.0016/Screenshots/SCREENSHOT_SHOT_LIST.md new file mode 100644 index 0000000..7d2c675 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Screenshots/SCREENSHOT_SHOT_LIST.md @@ -0,0 +1,63 @@ +# Screenshot Shot List + +Apple allows one to ten Mac screenshots. Use 16:10 PNG or JPG images. Recommended final size: `2880 x 1800`. Other accepted Mac sizes include `2560 x 1600`, `1440 x 900`, and `1280 x 800`. + +Put original captures in `Screenshots/raw/`. Put final App Store-ready files in `Screenshots/AppStore/`. + +## Recommended Final Set + +Use five screenshots if possible. + +1. `01-app-grid.png` + - Show the main TagLauncher app grid. + - Make sure several tag groups are visible. + - Avoid private app names if needed. + - This is the hero screenshot. + +2. `02-quick-search.png` + - Open AppGrid, press Space, and show Quick Search with a sample query. + - Prefer a query that returns clean, recognizable results. + - Keep AppGrid visible behind Quick Search. + +3. `03-settings-appearance.png` + - Show Settings with appearance/layout controls. + - This demonstrates customization. + +4. `04-hotkeys-or-search-settings.png` + - Show the hotkey or Quick Search settings area. + - This demonstrates the global launcher workflow. + +5. `05-import-export-or-tag-editing.png` + - Show import/export, tag editing, or a clean organized multi-tag grid. + - This demonstrates data portability or organization depth. + +## Optional Extra Shots + +6. Split View / fullscreen Space behavior + - Only include this if it looks visually clear. + - AppGrid should appear above a fullscreen or Split View workspace. + +7. Help/About page + - Use only if you want to emphasize the built-in help link. + +## Capture Notes + +- Hide unrelated desktop clutter and notifications. +- Use the same language for all screenshots unless intentionally localizing. +- Avoid showing sensitive installed apps, private folders, account names, or messages. +- Do not add marketing text into the screenshots unless you later decide to create designed promotional frames. +- If taking full-screen captures on a Retina Mac, the raw image may be larger than accepted App Store sizes. Export or resize final files to `2880 x 1800`. + +## Quick Resize Command + +After placing raw screenshots in `Screenshots/raw/`, run this from the repo root to create `2880 x 1800` copies: + +```bash +mkdir -p Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore +for file in Release/AppStore-7.6.0-20260525.0016/Screenshots/raw/*.png; do + name="$(basename "$file")" + sips -z 1800 2880 "$file" --out "Release/AppStore-7.6.0-20260525.0016/Screenshots/AppStore/$name" +done +``` + +Review each resized file before uploading. If a screenshot looks stretched or cropped poorly, recapture at a cleaner 16:10 screen size instead of forcing it. diff --git a/Release/AppStore-7.6.0-20260525.0016/Screenshots/raw/.gitkeep b/Release/AppStore-7.6.0-20260525.0016/Screenshots/raw/.gitkeep new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Screenshots/raw/.gitkeep diff --git a/Release/AppStore-7.6.0-20260525.0016/Submitted/.gitkeep b/Release/AppStore-7.6.0-20260525.0016/Submitted/.gitkeep new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Submitted/.gitkeep diff --git a/Release/AppStore-7.6.0-20260525.0016/Support/GITHUB_PAGES_PUBLICATION_GUIDE.md b/Release/AppStore-7.6.0-20260525.0016/Support/GITHUB_PAGES_PUBLICATION_GUIDE.md new file mode 100644 index 0000000..dfd7943 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Support/GITHUB_PAGES_PUBLICATION_GUIDE.md @@ -0,0 +1,79 @@ +# Publishing Privacy And Support Pages On GitHub + +App Store Connect needs public URLs for privacy policy and support. The simplest path is GitHub Pages. + +## Recommended URL Shape + +If you publish from this repository with GitHub Pages, use URLs like: + +- Privacy Policy: `https://[GITHUB_USER_OR_ORG].github.io/[REPO_NAME]/privacy/` +- Support: `https://[GITHUB_USER_OR_ORG].github.io/[REPO_NAME]/support/` + +Exact URLs depend on the GitHub owner, repository name, and Pages settings. + +## Files To Publish + +Copy these release-pack files into a public `docs/` folder in the GitHub repository: + +```text +docs/privacy.md +docs/privacy.zh-Hans.md +docs/support.md +``` + +Suggested source mapping: + +```text +Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.md -> docs/privacy.md +Release/AppStore-7.6.0-20260525.0016/Legal/PRIVACY_POLICY.zh-Hans.md -> docs/privacy.zh-Hans.md +Release/AppStore-7.6.0-20260525.0016/Support/SUPPORT.md -> docs/support.md +``` + +Replace all placeholders before publishing: + +- `[YOUR NAME OR COMPANY NAME]` +- `[PRIVACY OR SUPPORT EMAIL]` +- `[SUPPORT EMAIL]` +- `[PUBLIC PRIVACY POLICY URL]` + +## GitHub Pages Setup + +1. Push the repository to GitHub. +2. Open the repository on GitHub. +3. Go to `Settings` -> `Pages`. +4. Under `Build and deployment`, choose: + - Source: `Deploy from a branch` + - Branch: `main` + - Folder: `/docs` +5. Save. +6. Wait for GitHub Pages to publish. +7. Open the generated URLs in a private browser window and confirm they are public. +8. Paste the public privacy and support URLs into App Store Connect. + +## Alternative: Dedicated Website Repository + +If you prefer a clean URL, create a separate public repository named `[GITHUB_USER_OR_ORG].github.io`. + +Then publish: + +```text +privacy.md +privacy.zh-Hans.md +support.md +``` + +The URLs become: + +```text +https://[GITHUB_USER_OR_ORG].github.io/privacy/ +https://[GITHUB_USER_OR_ORG].github.io/support/ +``` + +## App Store Connect Fields + +Use: + +- Privacy Policy URL: the public privacy page. +- Support URL: the public support page. + +If you localize App Store metadata later, you can also provide localized privacy policy URLs per locale. diff --git a/Release/AppStore-7.6.0-20260525.0016/Support/SUPPORT.md b/Release/AppStore-7.6.0-20260525.0016/Support/SUPPORT.md new file mode 100644 index 0000000..12eb115 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Support/SUPPORT.md @@ -0,0 +1,52 @@ +# TagLauncher Support + +For support, contact: + +`[SUPPORT EMAIL]` + +## Basic Usage + +- Press `Option-Shift-Space` to show the TagLauncher app grid. +- Press `Space` while the app grid is visible to open Quick Search. +- Press `Escape` once to close Quick Search. +- Press `Escape` again to close the app grid. +- Open Settings from the menu bar or with `Command-Comma`. + +## Common Questions + +### TagLauncher does not open with the shortcut + +Another app, input method, or macOS shortcut may already be using the same key combination. Open TagLauncher settings and check the shortcut status. + +### Quick Search does not appear + +Open the app grid first, then press `Space`. If a modal dialog or editing state is active, close it and try again. + +### The app grid appears on the wrong display + +TagLauncher is designed to follow the current pointer display. Move the pointer to the target display and open the app grid again. + +### Import or export cannot access a file + +Use the macOS file panel shown by TagLauncher. App Store builds use sandboxed, user-selected file access. + +### Login at launch is unavailable + +In App Store sandboxed builds, login-at-launch support may be unavailable if the old LaunchAgent approach is disabled. This is expected until an App Store-safe login item implementation is added. + +## Privacy + +TagLauncher stores app organization data locally on your Mac and does not include analytics, advertising SDKs, tracking SDKs, or telemetry. + +Privacy Policy: + +`[PUBLIC PRIVACY POLICY URL]` + +## App Version + +When contacting support, include: + +- TagLauncher version. +- macOS version. +- A short description of what you expected and what happened. +- Screenshots or screen recordings if they help explain the issue. diff --git a/Release/AppStore-7.6.0-20260525.0016/Upload/.gitkeep b/Release/AppStore-7.6.0-20260525.0016/Upload/.gitkeep new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Release/AppStore-7.6.0-20260525.0016/Upload/.gitkeep -- Gitblit v1.9.3