Bower中文API

Posted on   |   In   |     |  

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.json中dependencies所列出的依赖项，并且后续万一你丢失了依赖项，那么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>将会创建一个link在components文件夹当中并且指向先前创建的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.json中dependencies移除该项
-D, –save-dev: 也将会从项目的bower.json中devDependencies移除该项

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