跳到正文

Web 应用清单

Web App Manifest

中级网页

Web 应用清单(Web App Manifest)是网站提供给浏览器的一份 JSON 配置,说明名称、图标和启动方式。它解决网站添加到设备主屏幕或安装为应用时,浏览器该怎样展示和打开的问题。

你可能会说:「我想让用户把我们的网页工具加到手机主屏幕,点图标后显示产品名,并像独立应用那样打开。」

读之前建议先了解

动手看看

manifest.webmanifest
name: "慢思笔记"
icons: [{…}]src: /icons/note.png sizes: 192x192 · type: image/png
display: "standalone"
start_url: "/today"
主屏幕上的入口
慢思笔记
设备预览
已添加到主屏幕名称和图标来自清单。将设备状态切到「从主屏幕启动」,查看打开后的窗口。
mindset.example/today
慢思笔记
今日工作台从 /today 开始,而不是上次浏览的网页。
整理本周读书记录今天 16:00 · 个人空间
打开工作台
清单中的应用名称
清单中的图标资源
启动显示模式
模拟设备状态

切换名称、图标和显示模式,看看主屏幕入口与启动窗口怎么变。图标可悬停、按下或用 Tab 聚焦;启动过程由设备状态参数模拟。

独立模式通常不显示浏览器地址栏,看起来更像应用,但内容仍是网页。start_url 指定从主屏幕启动时首先打开哪个地址。

清单要由网页通过 link rel="manifest" 引用。它不保证网站一定能安装,也不自动提供离线能力;安装条件和显示模式支持还取决于浏览器。

要点

  1. 1

    它是给浏览器看的配置

    你可以把清单理解成网站的应用名片:它通常是一份 JSON 文件,写明名称、图标等信息。浏览器读取后,才有依据决定安装入口和设备上的展示内容。

  2. 2

    网页需要指向这份清单

    把文件放到服务器上还不够,网页也要声明清单的位置。这样浏览器访问你的 AI 工具时,才能找到配置;只改文件名或只上传文件,不会自动建立这层关联。

  3. 3

    启动地址决定打开哪里

    清单可以指定用户从设备图标打开应用时进入哪个页面,以及采用怎样的显示方式。比如你的产品有官网和工作台,就可以让图标直接打开工作台,而不是宣传首页。

  4. 4

    它不包办离线和安装

    清单描述的是应用如何呈现,不会让页面自动支持离线。浏览器是否提供安装入口也受自身规则和网站条件影响,所以测试时要分别检查清单内容、安装表现和离线能力。

容易混淆的地方

它和网站图标不是一回事:网站图标主要出现在浏览器标签页等位置,清单中的图标则可用于添加到设备后的展示。它也不是离线缓存方案;如果你想让用户断网后继续使用,需要另行设计缓存等能力,而不是只补一份清单。

什么时候用

适合用

  • 你做了一个常用的网页记账工具,希望用户从手机主屏幕直接打开,并看到产品名称和图标。
  • 你的后台有独立工作台,希望用户安装后从设备图标进入工作台,而不是每次先看到官网首页。
  • 你在验收 AI Agent 做的可安装网页,需要核对名称、图标、启动地址和实际打开效果。

不适合用

  • 你只想修改浏览器标签页上的小图标,没有添加到设备的需求;处理网站图标就够了。
  • 你只想让产品页面在搜索结果或社交分享中显示合适的标题与摘要;改页面元数据更对题。
  • 你要开发通过原生应用包发布的手机应用,而不是网站;应配置对应平台的应用信息。

练一练

你做了一个在线白板,希望用户从手机主屏幕点图标后直接进入白板,并以接近独立应用的窗口打开。AI Agent 还说加上清单就能离线编辑。你会怎么判断?

让 AI 帮你做

请为现有在线白板添加 Web 应用清单,并让网页正确引用它。配置产品名称、适合设备展示的图标、指向白板的启动地址和独立窗口显示方式;完成后检查实际效果。离线编辑不在本次需求内。

接下来学什么