Manifest name 与 short_name

一句话： name 是安装提示和启动画面中显示的完整可读标签；short_name 是空间有限时使用的简短标签——主屏幕图标、应用切换器与任务栏条目。将 short_name 控制在 12 个字符以内，可避免在大多数平台上被截断。

各字段的作用

字段	典型展示位置	长度建议
name	安装对话框、关于页面、启动画面	大多数浏览器最多 45 个字符，超出后换行
short_name	主屏幕图标标签、应用切换器、任务栏	12 个字符以内；绝对上限 15

当 short_name 缺失时，浏览器会回退使用 name，再由平台自行截断或缩写。建议始终同时提供两者。

语法

{
  "name": "Acme 发票跟踪",
  "short_name": "Acme"
}

两个值均为纯字符串。避免使用标记语言、emoji 或不可打印字符——各操作系统对其渲染不一致。

W3C 规范说明

• 在大多数浏览器实现中，name 是安装条件的必要字段，但规范将其标记为可选。
• short_name 在规范中为可选，但实践中必须提供以获得良好的主屏幕标签效果。
• 两个字段均不接受 HTML；浏览器直接显示原始字符串。

平台特定行为

• Android（Chrome/Edge）： 主屏幕图标标签使用 short_name；安装底部弹窗中使用 name。
• iOS（Safari）： 添加到主屏幕弹窗中使用 name；图标标签取 short_name（若缺失则取 name）的首个单词，最多约 10 个可见字符。
• Windows（Edge/PWABuilder）： 开始菜单与任务栏提示中使用 name；固定到任务栏时按钮显示 short_name。
• macOS（Chrome/Edge）： Dock 提示与 Spotlight 中使用 name；Dock 图标标签使用 short_name。
• Linux： 行为因桌面环境而异；大多数在应用菜单中使用 name。

如何选择合适的值

• name 应与产品公开品牌名称一致——与应用商店列表使用相同的字符串。
• short_name 应是可识别的缩写，而非通用词汇。“Tracker” 不如 “Acme” 或 “Invoice”。
• 两个字段均避免添加“PWA”或“App”——这些标签对用户没有额外意义，只会增加噪音。
• 若应用面向多语言用户，请通过 lang 字段与独立清单或快捷方式本地化方案对两个字段分别做本地化处理。

实践清单

• name 已存在且与品牌一致。
• short_name 不超过 12 个字符。
• 两个字段均为纯文本——无 HTML 标签或 emoji。
• 已在 Android 与 iOS 上测试主屏幕图标标签的显示效果。
• 若应用为多语言，已制定 name 与 short_name 的本地化方案。