223
《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
最後更新：2017-06-05 14:01:50