$ npm install -g bower
基本用法
安裝程序包程序包安裝命令 bower install
,默認安裝目錄 bower_components/
。
$ bower install
package 可能是 GitHub Shorthand,或者是 Git 倉庫地址,或者 URL。
# registered package
$ bower install jquery
# GitHub shorthand
$ bower install desandro/masonry
# Git endpoint
$ bower install git://githu.com/user/package.git
# URL
$ bower install http://example.com/script.js
更改默認安裝目錄要更改默認安裝目錄,可在工作目錄根路徑下創(chuàng)建 .bowerrc
,添加以下內(nèi)容:
{
"directory": "my_components"
}
關(guān)于 bower.jsonBower 使用 bower.json
作為程序包清單。(早期版本使用 component.json
作為清單文件)。
你可以使用 $ bower init
命令來創(chuàng)建 bower.json
文件,以下是 bower.json 示例:
{
name: 'hello-world',
version: '0.1.0',
authors: [
'Yin Zhenhua '
],
description: 'the first package.',
main: 'hello.js',
keywords: [
'amd'
],
license: 'MIT',
ignore: [
'**/.*',
'node_modules',
'bower_components',
'test',
'tests'
]
}
name必填
注冊到 bower 倉庫的名字。
* 名字必須具有唯一性。
* 命名采取 slug style,例如 unicorn-cake。
* 名字包含小寫字母、數(shù)字、連字符或英文句號(后兩者不能位于開始和結(jié)束位置)。
* 不能連續(xù)使用連字符和句號。
* 不能多于 50 個字符。
暫時沒有使用,目前 bower 使用 Git tag 作為版本號。
description程序包簡略描述,最多不超過 140 個字符。
main為程序包建立一個入口文件是很有必要的,每一類型文件只能有一個入口文件。入口文件包含模塊的輸入物和導入物。
圖片和字體文件可以被 JS 或 Sass 文件使用,因此它們不能算作入口文件。
* 使用含有模塊輸入物和輸出物的文件作為入口文件。
* 不要使用壓縮后的文件。
* 不要使用圖片、字體、音頻或視頻文件作為入口文件。
* 文件名不要包含版本號。
* 不要使用 `js/*.js` 的這樣用法。
dependencies依賴包是一個鍵位包名,值為標識符或 URL 的哈希字典。
* 鍵必須是有效名字。
* 值必須是一個有效版本、Git URL 或 URL。
* Git URL 必須在結(jié)尾處添加 # 符號,并附注 revision SHA,branch 或 tag。
* 如果是 GitHub 項目,則使用 owner/package 這樣的簡寫方式。
* 本地調(diào)試時可以使用本地路徑作為值。
devDependencies調(diào)試依賴包和 dependencies 規(guī)則相同,但僅做本地開發(fā)時使用。
moduleType在 main
中定義模塊的類型。
* `globals`:表示模塊直接導入全局名字。
* `amd`:符合 AMD 規(guī)范,例如 RequireJS,使用 `define()` 語法。
* `node`:符合 node 和 CommonJS 規(guī)范,使用 `module.exports` 語法。
* `es6`:符合 ECMAScript 6 模塊規(guī)范,使用 `export` 和 `import` 語法。
* `yui`:符合 YUI 模塊規(guī)范,使用 `YUI.add()` 語法。
keywords與 name
字段規(guī)則相同。
作者名錄。
homepage主頁。
repository源文件所處倉庫。
liscense授權(quán)許可。
ignore安裝包的時候需要忽略的模塊。
resolutions如果兩包發(fā)生沖突,則自動根據(jù)該字段解析依賴包。
private如果設(shè)置為 true
,則不能發(fā)布該包。這樣做是為了避免意外發(fā)布。
使用 bower install
命令將
添加到 bower.json
的 dependencies
數(shù)組。
使用 bower install
命令將
添加到 bower.json
的 devDependencies
數(shù)組。
注冊后的程序包可以使用 bower install
命令進行安裝。
* 包名必須符合 bower.json 規(guī)范。
* 項目根目錄必須存在合法的 `bower.json` 文件。
* 包必須使用 [semver](http://semver.org/) Git tag。
* 你的包必須是公開的,其他人都可以訪問到你的 Git 倉庫,記住推送 Git tags。
* 對于私有包,使用私有的 [Bower Registry](https://github.com/bower/registry)。
使用 bower register
命令注冊包:
$ bower register
例如:
$ bower register example git://github.com/user/example.git
Bower 注冊現(xiàn)在還不支持身份驗證。
Bower 不支持 GitHub 風格的命名(org/repo),但你可以使用 -
符號來命名相關(guān)聯(lián)的包,例如 angular-
。
使用命令 bower unregister
注銷你的代碼包。你首先要使用 bower login
來驗證 GitHub 身份,確保你是代碼包的貢獻者。
bower login
# enter username and password
? Username:
? Password:
#unregister packages after successful login
bower unregister
你也可以手動請求注銷代碼包。
API cache$ bower cache clean
$ bower cache clean [ ...]
$ bower cache clean # [# ..]
清理緩存的程序包。
$ bower cache list
$ bower cache list [ ...]
顯示緩存的程序包。
help$ bower help
home$ bower home
$ bower home
$ bower home #
打開程序包主頁。
info$ bower info
$ bower info []
$ bower info # []
顯示程序包或某一個版本的程序包信息。
install$ bower install []
$ bower install [ ..] []
安裝項目依賴包,或者指定的終端地址集。
終端有三種形式:
*
* #
* =#
其中:
* 是 URL,物理路徑或注冊名。
* 是有效范圍、commit、分支等。
* 本地配置的名稱。
lookup$ bower lookup
查詢程序包 URL。
prune$ bower prune
卸載本地多余程序包。
register$ bower register
注冊程序包。
search$ bower search
$ bower search
查找程序包。
update$ bower update [ ..] []
根據(jù) bower.json 內(nèi)容安裝最新的程序包。
update options
* `-F`, `--force-latest`:強制安裝最新版本(無論沖突與否)
* `-p`, `--production`:不要安裝項目的 devDependencies。
uninstall$ bower uninstall [ ..] []
從本地 bower_components 目錄卸載程序包。
uninstall options
* `-S`, `--save`:從 bower.json dependencies 中移除卸載的程序包。
* `-D`, `--save-dev`:從 bower.json devDependencies 中移除卸載的程序包。
unregister$ bower unregister
卸載程序包。