《JavaScript开发框架权威指南》——1.7 创建Bower包

  1. 云栖社区>
  2. 博客>
  3. 正文

《JavaScript开发框架权威指南》——1.7 创建Bower包

异步社区 2017-06-05 14:00:52 浏览1013
展开阅读全文

本节书摘来自异步社区《JavaScript开发框架权威指南》一书中的第1章,第1.7节,作者:【美】Tim Ambler , Nicholas Cloud著,更多章节内容可以访问云栖社区“异步社区”公众号查看

1.7 创建Bower包

截至目前,我们关注的焦点都在如何将Bower集成到项目中。我们先在项目中对Bower进行了初始化,然后探究了查找、添加以及移除软件包的方法。但是总有那么一天,你会希望将自己的软件包分享给其他人。要这么做的话,就必须遵守一些简单的规则,让我们从选择有效的包名开始。

1.7.1 选择有效的包名
你需要为自己的包选定一个名字,该名字必须在整个Bower开放注册中心(public registry)唯一。通过Bower的search命令来检查你想要的名字是否可用。其他需要遵守的规则有:

  • 包名应当使用slug格式,例如my-unique-project。
  • 包名中的所有字母应为小写。
  • 只允许出现字母、句点以及连字符(dash)。
  • 以字母起始并结束。
  • 不允许出现连续的句点和连字符。
  • 选好名字后,更新相应的bower.json文件的内容。

1.7.2 在Git标签中使用语义化版本号(Semver)
本章前面的部分对语义化版本控制(一种为软件项目指定有意义的版本号的通用规范)的概念进行了介绍。请务必遵守此规范,因为它使用户得以跟踪及整合软件包以后的改变。

如果你要共享的软件包刚刚起步,0.0.0会是比较合适的版本号。随着更新的提交以及新版本的发布,你可以根据改变程度相应地增加版本号。当确定该项目已经到达第一个“稳定的”里程碑的时候,再把版本号更新为1.0.0来反映此状态。

软件项目的每个版本号都应该在GitHub上有相应的标签(tag)。用户正是通过这种GitHub标签与包版本号之间的关系,在项目中引用特定版本的包的。

假设代码已经提交到GitHub上,那么接着可以按清单所示的方法来创建第一个GitHub标签。

清单1-10 创建第一个使用语义化版本号的Git标签

$ git tag -a 0.0.1 -m "First release."
$ git push origin 0.0.1

1.7.3 将软件包发布到注册中心
软件包的名字已经选好,也指定了版本号(以及相应的GitHub标签),现在是时候将软件包发布到Bower的注册中心了。

$ bower register my-package-name https://github.com/username/my-package-name.git

注意:
 

请记住,Bower的设计初衷是作为库和组件的集中式注册中心,供开发者在项目中使用,而非一种应用分发机制。

网友评论

登录后评论
0/500
评论
异步社区
+ 关注