Manifest 本地化让一个 PWA 说多种语言

为什么 manifest 本地化重要

多年来，PWA 只能提供单一语言的 manifest。如果你想触达日本用户、法国用户和中国用户，只能：

• 在不同 origin 构建三个独立 PWA
• 用 JavaScript 动态提供语言特定的图标和文本，但安装提示不会使用
• 忽略问题，全球统一显示英文应用名

Chrome 148 改变了这一点。由 Microsoft Edge 团队与 Chrome 合作实现的 manifest 本地化功能，让你的 PWA 能够根据用户的浏览器语言适配应用名、描述、图标和快捷方式。这降低了全球分发的摩擦，也让应用在本地搜索结果中更容易被发现。

根据 Chrome 148 发布说明，该功能"支持 manifest 成员的本地化，使应用能够适应用户的语言和区域，调整其名称、描述、图标和快捷方式"。

实施清单

在 manifest.json 中添加本地化成员：

{
  "name": "My App",
  "name_ja": "マイアプリ",
  "name_zh": "我的应用",
  "description": "A progressive web app",
  "description_ja": "プログレッシブ Web アプリ",
  "description_zh": "渐进式网页应用",
  "icons": [{ "src": "icon.png", "sizes": "512x512" }],
  "icons_ja": [{ "src": "icon-jp.png", "sizes": "512x512" }],
  "icons_zh": [{ "src": "icon-zh.png", "sizes": "512x512" }],
  "shortcuts": [
    {
      "name": "Create new",
      "url": "/create"
    }
  ],
  "shortcuts_ja": [
    {
      "name": "新規作成",
      "url": "/create"
    }
  ]
}

本地化就绪评估表

发布多语言 manifest 前，验证：

• [ ] 每个语言变体都有完整翻译（名称、描述、快捷方式）
• [ ] 图标符合当地文化（避免冒犯性元素，使用区域性品牌元素）
• [ ] 快捷方式指向该语言的有效页面
• [ ] 构建流程在部署前验证本地化成员
• [ ] 在 Chrome 148+ 上测试 Windows、macOS 和 Android 的安装提示，使用不同浏览器语言

是否需要本地化？

| 场景 | 建议 | |------|------| | 单一国家发布 | 跳过本地化，专注该市场优化 | | 多区域且有区域品牌 | 使用本地化适配名称和图标 | | 全球产品且品牌统一 | 本地化描述，保持名称一致 | | 深度本地化应用且功能有区域差异 | 考虑按主要市场构建独立 PWA |

开发者立即行动

1. 按地区审核 PWA 的安装漏斗。如果非英语用户的流失率很高，本地化是高优先级修复项。

- 翻译的应用名称（保持在桌面平台显示的合理长度） - 文化上合适的图标（颜色、符号、文字） - 与 UI 匹配的翻译快捷方式

1. 准备本地化资源。不需要新二进制，但需要：

1. 在 Chrome 148+ 上测试。安装提示遵循浏览器语言，而非系统语言。将 Chrome 语言设置为日语或中文，验证安装提示显示本地化名称。

1. 不要破坏现有安装。如果本地化缺失或格式错误，Chrome 会回退到英文。逐步发布，监控各地区跳出率。

1. 观察平台采用情况。Safari、Firefox 和基于 Chrome 的 Edge 可能会在不同时间实现该功能。在将关键 UI 依赖本地化之前，进行特性检测。

对分发的影响

使用 manifest 元数据的各类应用市场和目录将开始看到本地化的名称和描述。应用在非英语搜索表面的可发现性取决于：

• 完整的本地化描述（不只是名称）
• 与区域搜索意图匹配的关键词
• 反映本地化体验的截图

如果你在应用市场或 PWA 目录中列出自己的 PWA，更新列表项以匹配本地化的 manifest。安装提示和市场标题之间的一致性能够建立信任。

下一步

Manifest 本地化是全球 PWA 的必备基础。下一个前沿是运行时本地化——无需整页重载就能根据用户语言适配应用内容、错误消息和帮助文本。navigator.languages API 和 service worker 本地化模式可以提供帮助，但需要仔细设计离线体验。

不要把本地化当作事后工作。从 manifest 元数据开始，在多种语言测试安装漏斗，迭代构建真正的全球 PWA。