edit | blame | history | raw

2026-06-14 ASC 多语种资料

用户目标

  • 用户已登录 App Store Connect，并要求协助提交 TagLauncher 新版。
  • 当前关注点变更为：App 支持 29 种语言，希望评估是否能把 App Store Connect 下拉语种里对应的商店资料全部维护上。

已完成事项

  • 在 App Store Connect 中确认当前版本页为 macOS App 版本 7.9.1，状态为准备提交。
  • 确认已选构建版本：7.9.1 (20260613.2020)，上传时间为 2026 年 6 月 13 日 20:48。
  • 已填写并保存简体中文“此版本的新增内容”。
  • 已切换到英语（美国），填写并保存英文“此版本的新增内容”。
  • 已检查本地发布资料：
  • src/Release/AppStore-7.9.1-20260613.2020/APP_STORE_CONNECT_METADATA.md
  • src/Release/AppStore-7.9.1-20260613.2020/APP_REVIEW_NOTES.md
  • src/Release/AppStore-7.9.1-20260613.2020/QA_RELEASE_EVIDENCE.md
  • 已确认 App 内部语言资源位于 src/Apptag/Localization/，共 29 个语言文件：
  • ar-Najdi, ar, cs, da, de, en, es, fr, id, it, ja, ko, ms, nb, nl, nn, no, pl, pt-BR, ro, ru, sr-Cyrl, sv, th, tr, uk, vi, zh-Hans, zh-Hant

关键判断

  • App Store Connect 当前版本页已本地化：简体中文、英语（美国）。
  • App Store Connect 当前可添加语种中，与 App 29 个语言资源能直接或近似对应的商店本地化页约为 25 个，而不是 29 个。
  • 差异原因：
  • ar-Najdi 没有独立 ASC 商店语言，可合并到标准阿拉伯语。
  • nb、nn、no 三个挪威语变体在 ASC 下拉中只能对应一个“挪威语”。
  • sr-Cyrl 当前下拉中没有可见的塞尔维亚语/塞尔维亚西里尔文商店语言。

待处理事项

  • 用户需确认是否按“ASC 支持的对应语种全部维护”执行，即新增约 23 个本地化页，加上已有中文和英语共约 25 个。
  • 需要决定非中文语种的技术支持网址和营销网址是否统一使用英文官网：
  • https://shanghai3168.github.io/taglauncher/support-en.html
  • https://shanghai3168.github.io/taglauncher/index-en.html
  • 需要更新 App 审核备注：当前英文备注仍残留 7.9.0 内容，应替换为 APP_REVIEW_NOTES.md 中 7.9.1 的英文审核说明。

后续建议

  • 不建议为了“29”硬凑 ASC 不支持的语言变体。
  • 建议先生成 25 个 ASC 本地化文案草稿并做长度检查，再批量填入 App Store Connect。
  • 填完后逐项保存，最后再执行“添加以供审核/提交审核”。

多语种官网与截图追加范围

用户进一步确认：

  • ASC 能对应的 25 个语种全部维护。
  • 官网需要制作对应语种页面。
  • App Store 营销截图也需要制作对应语种版本，位置为 /Users/ar/Projects/Taglauncher/Docs/X-Op资料/Screenshots/AppStore-Marketing。

只读盘点结果：

  • 官网现状只有：
  • docs/index.html
  • docs/index-en.html
  • docs/support.html
  • docs/support-en.html
  • docs/privacy-zh.html
  • docs/privacy.html
  • 营销截图现状只有：
  • Docs/X-Op资料/Screenshots/AppStore-Marketing/zh-Hans
  • Docs/X-Op资料/Screenshots/AppStore-Marketing/en
  • 当前截图脚本 Docs/X-Op资料/Screenshots/render_marketing_screenshots.py 硬编码输出到旧 release 目录 src/Release/AppStore-7.8.15-20260605.2337/...，且只支持中文和英文。
  • Pillow 当前 raqm=False，不适合直接用 PIL 绘制阿拉伯语等 RTL/复杂脚本文案。
  • Codex bundled runtime 中存在 Playwright 和 Chrome for Testing，可改用 HTML/CSS 渲染 2880x1800 截图，适合多语种文本、RTL 和自动换行。

建议执行方案：

  1. 建立 25 个 ASC 对应语种映射：
  • zh-Hans, en-US, ar, cs, da, de, es-ES, fr-FR, id, it, ja, ko, ms, no, nl, pl, pt-BR, ro, ru, sv, th, tr, uk, vi, zh-Hant
  1. 不单独创建：
  • ar-Najdi：并入 ar
  • nb / nn：并入 ASC 的 no
  • sr-Cyrl：当前 ASC 下拉无可见对应项
  1. 官网新增对应语种的 index-*.html 和 support-*.html，现有中文/英文页面保持兼容。
  2. 营销截图生成脚本改为数据驱动，用 HTML/CSS + Playwright 批量渲染，每个语种输出 6 张图和 contact sheet。
  3. 先本地 QA：
  • 页面文件存在性。
  • 所有图片尺寸符合 2880x1800。
  • HTML 无明显缺失文本。
  • 随机抽查中文、英文、德文、日文、阿拉伯文截图。
  1. 再进入 ASC 维护。截图批量上传可能需要 ASC API / fastlane / 手工网页上传辅助，因为网页文件选择批量自动化稳定性不确定。

本轮执行结果

  • 已新增统一内容源脚本：
  • docs/scripts/localized-content.mjs
  • docs/scripts/generate-localized-site.mjs
  • 已把营销截图生成链路改为运营资料目录输出：
  • 主脚本：Docs/X-Op资料/Screenshots/render_marketing_screenshots.mjs
  • 兼容入口：Docs/X-Op资料/Screenshots/render_marketing_screenshots.py
  • 唯一输出目录：Docs/X-Op资料/Screenshots/AppStore-Marketing/<locale>/
  • 已生成 25 个 ASC 对应语种的官网首页和支持页，共 50 个页面。
  • 已生成 25 个语种的 App Store 营销图，每个语种 6 张主图和 1 张 contact sheet，共 175 张 PNG。
  • 已生成 ASC 填表草稿：
  • Docs/X-Op资料/AppStoreConnect/ASC_LOCALIZED_METADATA.md
  • Docs/X-Op资料/AppStoreConnect/localized-metadata.json

本轮 QA 结论

  • 本地脚本检查通过：PASS localized asset QA: 25 locales, 50 pages, 175 png files checked.
  • 抽查中文、英文、阿拉伯语、日语营销图，图片素材已正常加载。
  • 首图背景已保持纯白，避免官网首屏和营销图里截图外侧出现白框/涂层感。

仍未完成

  • 尚未把 25 个语种资料逐项维护到 App Store Connect 线上后台。
  • 尚未把 25 个语种截图上传到 App Store Connect。
  • App Store Connect 英文审核备注此前仍可能残留 7.9.0 内容，提交前需要替换为 7.9.1 审核说明。

官网发布与 ASC 范围调整

  • 已将官网和运营资料发布到 GitHub Pages 发布源：
  • 远端分支：main
  • 发布目录：/docs
  • 提交：568a92e Add localized website and ASC marketing assets
  • 提交：8cc2133 Make localized site generator source optional
  • GitHub Pages 状态已确认：built。
  • 抽查线上页面均为 200，且语言切换已经从原来的中文/英文双链接改为 25 语种下拉选择：
  • https://shanghai3168.github.io/taglauncher/index.html
  • https://shanghai3168.github.io/taglauncher/index-en.html
  • https://shanghai3168.github.io/taglauncher/index-ja.html
  • https://shanghai3168.github.io/taglauncher/index-ar.html
  • https://shanghai3168.github.io/taglauncher/support-de.html
  • 用户明确调整发布范围：本次 App Store 审核只保留中文和英文资料，且已手动提交。
  • 不再继续维护本轮 ASC 多语种后台；其他 23 个语种的官网页面、ASC 文案草稿和营销图先作为下次提交审核时的资料储备。
  • 已清理临时发布 worktree：/tmp/taglauncher-pages-main。