Ariver
2026-05-11 6d65d48389375f80a8cec8c284e753ebed07ace1
Update App Store submission notes for 5.5.0
1 files added
268 ■■■■■ changed files
AppStore_Submission.md 268 ●●●●● patch | view | raw | blame | history
AppStore_Submission.md
New file
@@ -0,0 +1,268 @@
# Apptag — Mac App Store 提审资料
> 版本: 5.5.0 | Bundle ID: com.apptag.launcher | 更新日期: 2026-05-11
---
## 1. App 基本信息
| 字段 | 内容 |
|---|---|
| **App 名称** | Apptag |
| **副标题** | Tag-Based App Launcher |
| **Bundle ID** | com.apptag.launcher |
| **版本号** | 5.5.0 |
| **Build 号** | 550 |
| **SKU** | apptag-mac-001 |
| **主要类别** | Utilities (工具) |
| **次要类别** | Productivity (效率) |
| **售价** | 免费 |
| **最低系统** | macOS 15.0 |
> 当前 `Info.plist` 的 `LSMinimumSystemVersion` 为 `15.0`,与本次提审目标一致。
---
## 2. App 描述 (App Store Description)
### 英文 (Primary)
**Apptag** is a blazing-fast, tag-based app launcher for macOS. Press a hotkey, type a tag, and launch any app instantly — no mouse, no Dock, no hunting through folders.
**Why Apptag?**
- **Tag your way** — Group apps by project, workflow, or mood. "Design", "Coding", "Writing", "Games" — you decide.
- **Instant overlay** — Press Shift+Option+Space, and a full-screen overlay appears with all your tagged apps. Click or type to launch. Press Escape to dismiss.
- **Beautiful layout** — Flat list or waterfall card containers. Drag to reorder tags. Adjustable icon size, font size, and tag position (left/right/top).
- **Container mode** — Each tag group in its own rounded card with material background. Hover to highlight, click tag pills to jump.
- **Zero Finder dependency** — Tags are stored in a local JSON database. No xattr pollution. No SIP permission issues. Export/import your tag setup as a portable JSON file.
- **Privacy-first** — No network access. No analytics. No data collection. Everything stays on your Mac.
- **9 languages** — English, 简体中文, 繁體中文, 日本語, 한국어, Русский, Français, Italiano, Español.
- **Hover to reveal** — Hide app names for a clean icon-only grid. Hover to see the name.
**Perfect for:**
- Power users who launch dozens of apps daily
- Designers organizing tools by project
- Developers managing dev tool sets
- Anyone tired of scrolling through the Dock or Launchpad
Apptag lives in your menu bar. Zero clutter, always one hotkey away.
### 简体中文
**Apptag** 是一款极速标签式应用启动器。按下快捷键呼出全屏浮层,按标签找到 App,一键启动——无需鼠标、无需 Dock、无需翻文件夹。
**为什么选 Apptag?**
- **标签分类** — 按项目、工作流或心情分组。"设计"、"编程"、"写作"、"游戏"——随你定义。
- **极速呼出** — Shift+Option+Space 弹出全屏浮层,所有已标签 App 一览无余。点击/键入即启动,Esc 关闭。
- **美观布局** — 扁平列表或瀑布流卡片容器。拖拽排序标签。可调图标大小、字体大小、标签位置(左/右/上)。
- **容器模式** — 每个标签组独立圆角卡片,毛玻璃背景。悬停高亮,点击标签胶囊跳转。
- **零 Finder 依赖** — 标签存储在本地 JSON 数据库。不污染 xattr。不受 SIP 限制。支持 JSON 文件导入/导出备份。
- **隐私优先** — 无网络访问、无分析统计、无数据收集。一切只留在你的 Mac 上。
- **9 种语言** — 简繁中、英、日、韩、俄、法、意、西。
- **悬停显示** — 可隐藏 App 名称获得纯粹图标网格。鼠标悬停时显示名称。
**适合:** 重度 App 用户、设计师、开发者、以及厌倦翻 Dock/Launchpad 的所有人。
Apptag 常驻菜单栏。零干扰,一键直达。
---
## 3. 关键词 (Keywords)
英文市场:
```
app launcher, tag organizer, productivity tool, spotlight alternative, menu bar, hotkey, keyboard launcher, app catalog, workflow, quick launch
```
---
## 4. 隐私政策 & App Privacy 标签
### 隐私策略 URL
如无独立网站,可直接在 App Store Connect 填写简短隐私说明,或托管一个纯文本 URL。建议内容如下:
```
Apptag Privacy Policy
Apptag does not collect, store, transmit, or share any personal data.
All tag data is stored locally on your Mac at:
~/Library/Application Support/Apptag/tags.json
Preferences are stored locally via macOS UserDefaults.
The app has no network access and never communicates with any server.
No analytics, no tracking, no third-party SDKs.
If you have questions, contact: [your-email]
```
### App Privacy 标签 (Nutrition Labels)
> Apptag **不收集任何数据**。所有选项选 "No"。
| 数据类型 | 用于追踪? | 关联到用户? | 用于何种目的? |
|---|---|---|---|
| **All types** | No | No | Not collected |
具体逐项确认:
- **Contact Info**: Not collected
- **Health & Fitness**: Not collected
- **Financial Info**: Not collected
- **Location**: Not collected
- **Sensitive Info**: Not collected
- **Contacts**: Not collected
- **User Content**: Not collected
- **Browsing History**: Not collected
- **Search History**: Not collected
- **Identifiers**: Not collected
- **Purchases**: Not collected
- **Usage Data**: Not collected
- **Diagnostics**: Not collected
- **Other Data**: Not collected
---
## 5. 年龄分级
| 问题 | 回答 |
|---|---|
| 无限制网络访问 | No |
| 用户生成内容 | No |
| 内购 | No |
| 广告 | No |
| 社交媒体 | No |
| 赌博/竞赛 | No |
| 酒精/烟草/药物引用 | No |
| 医疗/治疗信息 | No |
| 色情/成人内容 | No |
| 暴力内容 | No |
| 恐怖/惊悚主题 | No |
| 卡通/幻想暴力 | None |
| 亵渎/粗俗幽默 | None |
| 真人暴力 | None |
| 模拟赌博 | No |
| 性暗示或裸体 | None |
| 不受限网络访问 | No |
**最终评分: 4+**
---
## 6. 截图要求
Mac App Store 要求至少 1 张截图(最多 10 张)。推荐尺寸:
| 显示分辨率 | 截图尺寸 |
|---|---|
| MacBook Pro 16" (默认) | 3456 × 2234 |
| MacBook Pro 14" | 3024 × 1964 |
| iMac 5K | 5120 × 2880 |
**建议截取场景(6张):**
1. 全屏浮层 Flat 模式 — 展示 app 网格
2. 全屏浮层 Container 模式 — 展示瀑布流卡片
3. 标签编辑面板 — 展示拖拽排序/颜色选择
4. Preferences 面板 — 展示自定义选项
5. 容器 hover 高亮 — 展示交互效果
6. 菜单栏 + 叠加浮层 — 展示整体工作流
截图规范: `.png` 格式, 72 DPI, 不要包含窗口边框/阴影。
---
## 7. App 图标
已有自定义图标文件: `~/Projects/Apptag/icon-icns.icns`
App Store 额外要求:
- **1024×1024 PNG** (用于 App Store 列表展示)
- 无透明背景、无圆角(Apple 自动加圆角)
- 放在 `AppIcon.icns` 中作为 `icon_512x512@2x.png`
---
## 8. What's New (本次版本更新说明)
```
Apptag 5.5.0
- Added a dedicated Language tab in Preferences with live language switching
- Preferences now opens centered above the active TagLauncher overlay, including multi-display setups
- Improved tag reordering in edit mode with live visual feedback and synchronized group layout updates
- Renamed backup actions to Export/Import Categories & Layout across all 9 languages
- Added Mac App Store sandbox entitlements and App Store build validation
- Hid Launch at Login controls in sandboxed App Store builds
- Removed deprecated app launch API usage
- Version updated to 5.5.0 (Build 550)
```
---
## 9. App Review 信息
| 字段 | 内容 |
|---|---|
| **联系人** | [你需要填写] |
| **电话** | [你需要填写] |
| **邮箱** | [你需要填写] |
| **备注** | 该 App 使用 Carbon `RegisterEventHotKey` API 注册全局快捷键(Shift+Option+Space),**不**需要辅助功能权限。所有数据本地存储,无网络请求。 |
| **登录信息** | 不需要(无账户系统) |
---
## 10. ⚠️ Mac App Store 合规风险提示(已处理)
### 🟢 已处理: App Sandbox 与全局快捷键
**已完成配置**:
1. **Entitlements 文件**: `Apptag/TagLauncher.entitlements` 已创建,包含:
   - `com.apple.security.app-sandbox`
2. **build.sh 已更新**:
   - `APP_STORE=1` 时强制检查 entitlements 文件存在
   - `APP_STORE=1 CODESIGN_IDENTITY="..." bash build.sh` 使用 entitlements 签名
3. **代码处理**:
   - 本地非沙盒版本保留 LaunchAgent 登录启动
   - App Store 沙盒环境下隐藏 Launch at Login 设置项,并跳过 LaunchAgent 写入
**仍需验证**: TestFlight 中确认沙盒下 Carbon `RegisterEventHotKey` 是否可正常工作。
### 🟢 已处理: Launch at Login 与 Sandbox
App Store 沙盒环境下不写入 `~/Library/LaunchAgents`,设置面板也不显示 Launch at Login 开关。本地非沙盒构建仍保留 LaunchAgent 登录启动。
### 🟢 低风险: LSMinimumSystemVersion = 15.0
当前最低系统为 macOS 15.0。这与构建目标 `arm64-apple-macosx15.0` 和 `Info.plist` 中的 `LSMinimumSystemVersion` 一致。
### 🟢 无风险: 隐私/数据安全
- 零网络访问 ✅
- 零数据收集 ✅
- 本地文件读写(sandbox 允许) ✅
- 无第三方 SDK ✅
---
## 11. 提审前 Checklist
- [ ] 生成 1024×1024 App Store 图标 PNG
- [ ] 截取 6 张 Mac 截图 (3456×2234 PNG)
- [ ] 准备隐私政策 URL(GitHub Pages / 独立页面 / Notion)
- [ ] 确认代码签名证书 (Mac App Distribution)
- [ ] 通过 TestFlight 测试 sandbox 下快捷键功能
- [ ] 使用 `APP_STORE=1 CODESIGN_IDENTITY="..." bash build.sh` 生成正式签名包
- [ ] 如有 sandbox 快捷键问题,准备 entitlement 申请理由
- [ ] 填写 App Store Connect 所有字段
- [ ] 上传构建并提交审核
---
## 12. 技术支持 & 营销 URL
如无独立网站,可使用:
- **隐私政策**: GitHub Gist / GitHub Pages / 或直接在 App Store Connect 文本框中填写
- **技术支持**: [你的邮箱]
- **营销 URL**: 可选(如有 GitHub README 可放)