Bower中文API

1. cache

    管理你已经缓存的包,最后的参数可传可不传,不传默认操作的是所有包,如果传了就是对指定的包进行操作,格式如下,

1
$ bower cache <command> [<args>]
  • cache clean
    清除你所缓存的包,一共有三种形式的操作,代码如下
1
2
3
4
5
6
7
8
# 清理所有缓存的包
$ bower cache clean

# 清理指定名字的包的缓存,也可指定多个,中间加上空格即可
$ bower cache clean <name> [<name> ...]

# 清理指定名字和版本的包的缓存,也可指定多个,中间加上空格即可,跟第二种类似,只是多加了指定版本
$ bower cache clean <name>#<version> [<name>#<version> ..]
  • cache list
    列出你所缓存的包,也就是缓存包的列表,包含每个包的名字以及这个包对应的github地址
1
2
3
4
# 列出了所有你所缓存包的列表
$ bower cache list
# 列出你所缓存的指定名字的包,可以多个,后面加空格即可
$ bower cache list <name> [<name> ...]

例如我电脑上列出的:

1
2
3
4
C:\Users\92816>bower cache list
bootstrap=https://github.com/twbs/bootstrap.git#3.2.6
jquery=https://github.com/jquery/jquery-dist.git#1.7.2
jquery=https://github.com/jquery/jquery-dist.git#1.8.3

2. help

显示关于bower的帮助信息,后面可以加上具体的帮助类型名称,比如可以$ bower help search则会显示出对应search的一些说明和操作信息,如果不加则会显示出所有的类型的说明和操作信息

1
$ bower help <command>

例:输入$ bower help search,将会显示如下帮助信息,包括用法和描述

1
2
3
4
5
6
7
8
9
10
11
12
  Usage:

bower search <name> [<options>]

Options:

-h, --help Show this help message
Additionally all global options listed in 'bower help' are available

Description:

Finds all packages or a specific package.

只输入 $ bower help,将会显示出所有的用法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
  Usage:

bower <command> [<args>] [<options>]
Commands:

cache Manage bower cache # 管理你缓存的包
help Display help information about Bower # 显示关于Bower的帮助信息
home Opens a package homepage into your favorite browser # 在你默认浏览器中打开一个包的主页
info Info of a particular package # 一个包的详细信息说明
init Interactively create a bower.json file # 初始化一个bower.json文件
install Install a package locally # 在本地安装一个包
link Symlink a package folder # 建立一个包文件夹的链接
list List local packages - and possible updates 列出本地所有的包以及可以更新的包
login Authenticate with GitHub and store credentials # 用github账号登陆
lookup Look up a package URL by name # 打开一个指定名字的包的官网
prune Removes local extraneous packages # 移除本地没有用的包
register Register a package # 注册一个包
search Search for a package by name # 根据名字搜索一个包
update Update a local package # 更新一个本地的宝
uninstall Remove a local package # 卸载一个本地的包
unregister Remove a package from the registry # 从注册表中移除一个包
version Bump a package version # 显示一个包的版本
Options:

-f, --force Makes various commands more forceful # 是各种命令行工具更加强大
-j, --json Output consumable JSON # 将帮助信息以JSON格式的输出
-l, --loglevel What level of logs to report # 生成日志级别
-o, --offline Do not hit the network # 离线模式
-q, --quiet Only output important information # 只输出重要信息
-s, --silent Do not output anything, besides errors # 除了错误,不要输出任何信息
-V, --verbose Makes output more verbose # 让输入信息更加详细
--allow-root Allows running commands as root # 允许以管理员权限在命令行运行
-v, --version Output Bower version # 输出bower的版本
--no-color Disable colors # 颜色不可用
See 'bower help <command>' for more information on a specific command.

3. home

1
2
3
$ bower home
$ bower home <package>
$ bower home <package>#<version>

在你的默认浏览器中打开一个包,或者指定版本的包的官方地址,一般都是github地址。
如果没有包通过,那么将会打开你本地包的主页。

4. info

1
2
3
$ bower info <package>
$ bower info <package> [<property>]
$ bower info <package>#<version> [<property>]

显示一个包(或者指定版本的包)的整体详细信息,也可指定属性查看

5. init

1
$ bower init

一步一步提示你初始化一个bower.json文件

6. install

1
2
$ bower install [<options>]
$ bower install <endpoint> [<endpoint> ..] [<options>]

安装一个项目的依赖项(dependencies)中列出的包
一个项目的依赖项有以下这些部分组成:

  1. 在项目中的bower.json中指定的dependencies
  2. 所有外部的依赖项,虽然没有在bower.json当中指定,但是出现在bower_components
  3. 任何在命令行终端作为参数增加的项
    当使用--save标识符的时候,所有增加的包的名字将会添加到bower.json中的dependencies中。
    Bower建议经常使用--save标识符去实现两个用户之间能够复用安装,也就是以后如果你将你的项目需要跟同事一起开发,那么无需将你所有依赖项的实体包都拷给同事,Bower会自动帮你安装bower.jsondependencies所列出的依赖项,并且后续万一你丢失了依赖项,那么bower也会自动按照dependencies帮你安装好丢失的依赖项,这一点无疑会很大程度的提高你的工作效率。
    终端可以有多种形式的输入:
  • <package>
  • <package>#<version>
  • <name>=<package>#<version>
    在上面
  • <package>是一个包的URL路径,实际位置或者注册的名字
  • <version>是一个可用的版本和分支等。
  • <name>是一个本地应该有的名字

安装选项

  • -F, –force-latest: Force latest version on conflict。强制更新到最新版本
  • -p, –production: Do not install project devDependencies。不要安装到开发依赖项当中,其实也就是生产环境环境当中
  • -S, –save: Save installed packages into the project’s bower.json dependencies。保存所安装包到项目中bower.json的dependencies中。
  • -D, –save-dev: Save installed packages into the project’s bower.json devDependencies。保存所安装包到项目中bower.json的devDependencies中,其实也就是开发环境当中
  • -E, –save-exact: Configure installed packages with an exact version rather than semver。明确安装一个指定版本的包,而不是依赖项当中的。
1
2
$ bower link
$ bower link <name> [<local name>]

这个link的功能可以让开发者们非常容易的测试他们的包,只需要两步。
使用bower link在项目文件夹目录当中将会创建一个全局link。在其他一些包中,bower link <name>将会创建一个linkcomponents文件夹当中并且指向先前创建的link. Using ‘bower link’ in a project folder will create a global link. Then, in some other package, bower link will create a link in the components folder pointing to the previously created link.
它将会允许你特别容易的测试因为它们将会很快地反应。当一个link不再需要的时候,你仅仅需要通过bower uninstall <name>就可以将其移除。

上述link是也可以理解为链接的意思,能够快速链接指定的包。

8. list

1
$ bower list [<options>]

列出本地的包以及可以更新的包;

list options(列表选项)

1
2
-p, --paths:  # 生成一个JSON格式的路径地图
-r, --relative: # 使路径相对于目录的`config`属性,默认为`bower components`

例:

1
2
3
4
5
6
7
8
9
10
11
12
13
C:\Users\92816\Desktop\testprogramming>bower list -p

jquery: 'bower_components/jquery/dist/jquery.js',
bootstrap: [
'bower_components/bootstrap/less/bootstrap.less',
'bower_components/bootstrap/dist/js/bootstrap.js'
]

C:\Users\92816\Desktop\testprogramming>bower list -r
bower check-new Checking for new versions of the project dependencies...
test C:\Users\92816\Desktop\testprogramming
└─┬ bootstrap#3.3.6 (latest is 4.0.0-alpha.2)
└── jquery#2.2.3 (latest is 3.0.0-beta1)

9. lookup

1
$ bower lookup <name>

通过一个包的名字查看其官方的github地址,然后你就可以复制下来去访问了
例:

1
2
C:\Users\92816\Desktop\testprogramming>bower lookup underscore
underscore https://github.com/jashkenas/underscore.git

10. login

1
$ bower login

用github账号登陆

login options

-t, –token: 通过现有的GitHub身份验证令牌登陆,不用再提示输入用户名和密码

11. prune

1
$ bower prune

卸载本地无用的包

12. register

1
$ bower register <name> <url>

注册一个包

1
2
$ bower search
$ bower search <name>

搜索你需要的包

14. update

1
$ bower update <name> [<name> ..] [<options>]

根据bower.json更新你所安装的包到最新版本

update options

1
2
3
4
-F, --force-latest: 强制更新
-p, --production: 生产环境
-S, --save: 更新`bower.json`中的`dependencies`列处的项
-D, --save-dev: 更新`bower.json`中的`devDependencies`列处的项,即更新开发版依赖的项。

15. uninstall

1
$ bower uninstall <name> [<name> ..] [<options>]

从你本地的bower_components文件目录下卸载指定的包
注意,默认情况下,会连所依赖的模块一起卸 载。比如,
如果卸载jquery-ui,会连jquery一起卸载,除非还有别的模块依赖jquery,这一点大家可以留意一下

uninstall options(卸载选项)

-S, –save: 也将会从项目的bower.jsondependencies移除该项
-D, –save-dev: 也将会从项目的bower.jsondevDependencies移除该项

16. version

1
$ bower version [<newversion> | major | minor | patch]

在这个包的目录下运行显示出它的版本并且在bower.json中写入一个新的数据。

17. Using local cache

当你没有网的时候,只要你以前安装过,就可以从本地缓存中安装所需要的包

1
$ bower install <package> --offline

你可以通过以下命令列出你所缓存的包的列表:
例:

1
2
3
C:\Users\92816\Desktop\testprogramming>bower cache list
bootstrap=https://github.com/twbs/bootstrap.git#3.3.6
jquery=https://github.com/jquery/jquery-dist.git#2.2.3

当然你也可以通过这个命令来将你所缓存包清除:

1
$ bower cache clean

这样之后你再输入bower cache list就没有内容了;
例:

1
C:\Users\92816\Desktop\testprogramming>bower cache list