Logo
Section 1 / 4

开始使用 Web 应用清单

通过创建一个Web App Manifest文件来开始构建PWA。

导入

开始使用 Web 应用清单

通过创建一个Web App Manifest文件来开始构建PWA。

什么是网页应用清单文件?

网页清单(Web Manifest)是一个 JSON 格式的文件,用于描述我们的渐进式网页应用(PWA)。浏览器会使用该清单文件中的属性信息,将 PWA 安装到用户的设备上。

为了让网页应用能够被安装到用户设备上,它必须满足浏览器设定的安装条件。一个网页应用需要在所有 HTML 页面中关联一个有效的清单文件,才能满足这一要求。

...
浏览器在将网页应用安装到用户设备前检查安装条件

将清单文件链接到网页应用

要将清单文件与你的 HTML 页面关联,请按以下两个步骤操作:

  • 在项目根目录下创建一个名为 manifest.json 的文件。
  • 在项目的每个 HTML 页面的 <head> 标签中添加对 manifest.json 文件的引用。
1<head> 2 3 <link rel="manifest" href="/manifest.json"> 4 5</head>

下面的应用程序中已添加了一个空的 manifest.json 文件。按照以下步骤,可以测试浏览器是否成功获取了该清单文件:

  • 运行下方的应用程序代码。
  • 服务器启动后,点击“Your app can be found at:”后面的 URL 打开应用。
  • 打开开发者工具,查看“Application”选项卡,应能显示我们的 manifest.json 文件。

No configuration found for ID: d45abc2ded0b3c0a7ba583803463fb3057b50cb0b5f5a94fd91d0e3177dcbd21

以下是开发者工具中显示 manifest.json 文件的截图:

...
Chrome DevTools 中的 manifest.json 文件示意图

注意: DevTools 是浏览器内置的一套供网页开发者使用的工具,有助于开发 PWA。不同浏览器打开开发者工具的方式可能不同。例如,在 Chrome 中,可以使用快捷键 “Control + Shift + J”(Windows 系统)或 “Control + Option + J”(Mac 系统)来打开 Chrome DevTools。

我们可以以这种方式链接 manifest.json 文件,这与为网页页面引入样式表的方式类似。

简介

了解应用清单属性