什么是 Broccoli-Manifest？
Broccoli-Manifest 是一个npm包，可以生成在 HTML 中使用的 Web 应用程序清单（Web Application Manifest），以实现使用 Web App 技术构建原生应用程序。在使用 Web App 技术构建原生应用程序时，你可以使用 Web 应用程序清单来使应用程序被添加到主屏幕上、提供应用程序图标、定义应用程序启动界面等等。
如何安装 Broccoli-Manifest？
安装 Broccoli-Manifest 很简单，运行以下命令即可：
npm install broccoli-manifest --save-dev
如何使用 Broccoli-Manifest？
在 Broccoli 中搭建程，你应该在你的项目根目录内添加一个名为 Brocfile.js 的文件，并输入以下代码：
const BroccoliManifest = require('broccoli-manifest');
const someTree = ...
module.exports = new BroccoliManifest(someTree, options);其中的 someTree 是什么呢？someTree 应该是一个 Broccoli 树的实例，在这里你可以使用 Broccoli 提供的任何插件函数，来对你的构建树进行转换。例如，你可以使用 broccoli-concat 插件来合并你的 JavaScript 文件，再将其传递给 BroccoliManifest。
一旦你正确地配置了 someTree，你应该传递一些选项对象来定制你的 Web 应用程序清单。具体内容可以在下面的 “选项” 部分中找到。
选项
下面是用于配置 Broccoli-Manifest 的选项：
basePath (String)
设置 Web 应用程序清单的根路径。默认为 /。
cache (Boolean)
控制是否生成缓存清单。默认为 false。
excludePaths (Array)
在生成清单时，应该排除选中的路径。默认为 [ '**/.*' ]。
includePaths (Array)
在生成清单时，应该包括选定的路径。默认为 [ '**/*' ]。
fingerPrint (Boolean)
设置是否使用指纹进行资源缓存。默认为 false。
manifestFile (String)
Web 应用程序清单的文件名。默认为 manifest.json。
network (Array)
设置清单中的可离线缓存项。默认为 [ '*' ]。
preferOnline (Boolean)
指定是否是首选在联机时从网络服务（而不是缓存）加载页面。默认为 false。
prefix (String)
设置清单中其他路由的前缀。默认为空字符串。
scope (String)
设置这个应用的 URL 前缀（也称为 "app scope"）。默认为 /。
shortName (String)
Web 应用程序的短名称。
startUrl (String)
设置应用程序在安装后打开时加载的 URL。默认为 /。
themeColor (String)
设置应用程序主题色。默认为空字符串。
示例代码
-- -------------------- ---- ------- -- -- ----------------- ----- ---------------- - ----------------------------- -- -- -------- ----- ----- -------------- - --------------------------- -- ---- ----- ------- ---------- -- ----- --- - ------ -- -- -------- ---------- ------ --- ------ -- ----- ---- - --- -------------------- -- -- --- ---- -------------- - --- ---------------------- - ------------- ----------------------- ----------- --------- ---
总结
本文介绍了 npm 包 Broccoli-Manifest 的使用教程，其中包括了安装 Broccoli-Manifest、使用 Broccoli-Manifest，以及配置 Broccoli-Manifest 中的选项等。同时，文章也提供了示例代码来帮助读者更好地理解使用方法。希望这篇文章能够帮助读者更好地应用 Broccoli-Manifest 来优化 Web App 的制作。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066c87ccdc64669dde5038