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