閱讀1008 返回首頁    go 阿裏雲 go 技術社區[雲棲]


《JavaScript開發框架權威指南》——1.7 創建Bower包

本節書摘來自異步社區《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的設計初衷是作為庫和組件的集中式注冊中心,供開發者在項目中使用,而非一種應用分發機製。

最後更新:2017-06-05 14:32:12

  上一篇:go  《JavaScript開發框架權威指南》——1.8 小結
  下一篇:go  協同辦公協同的到底是什麼?