《JavaScript开发框架权威指南》——1.3 清单文件(Manifest)

本节书摘来自异步社区《JavaScript开发框架权威指南》一书中的第1章,第1.3节,作者:【美】Tim Ambler , Nicholas Cloud著,更多章节内容可以访问云栖社区“异步社区”公众号查看

1.3 清单文件(Manifest)

Bower为开发者查找、添加、升级以及删除第三方库提供了唯一入口。这些操作被执行后,Bower会用最新的项目依赖项列表更新一个被称作“配置清单”的JSON文件。本章示例项目中的配置清单如清单所示。在此示例项目中,Bower维护着一个唯一的依赖项,即Bootstrap的CSS框架。

清单1-3 本章示例项目的Bower清单文件

// example-bootstrap/bower.json

{
    "name": "example-bootstrap",
    "version": "1.0.0",
    "homepage": "https://github.com/username/project",
    "authors": [
        "John Doe <john.doe@gmail.com>"
    ],
    "dependencies": {
        "bootstrap": "3.2.0"
    }
}

如果不小心把/public/bower_components文件夹删除,以致弄丢项目所有的依赖项的话,只需一条命令(如下所示)就可以将项目恢复至原始状态。Bower会将项目当前的文件结构与清单文件进行比对,确定缺失了哪些依赖项,最终重建项目模式。

$ bower install
这种特性使得我们可以不对/public/bower_components文件夹进行版本管理。提交代码时只提交Bower清单文件,而不提交依赖项本身,项目的源代码模式得以保持整洁,仅包含项目本身所有的文件。

注意:
 

对于是否将项目中的依赖项移出版本管理存在分歧。一方面,这么做可以令项目仓库更加整洁;另一方面,这也为由网络连接引发的问题(比如不能访问Bower注册中心或者GitHub等)埋下了隐患。普遍共识是,如果你的项目是可部署的(亦即一个完整的应用,而非软件模块),那么最好将依赖项一起提交,否则最好将项目用到的依赖项移出版本管理。
创建新的清单文件
当在项目中初次使用Bower的时候,最好像下面一样,让Bower创建一个新的清单文件。此后,再根据需要进行修改。

$ bower init

上一篇:VMWare 14.1 15 Pro 安装 macOS Mojave 10.14.1系统 遇到的问题解决方案


下一篇:走进AngularJs(九)表单及表单验证