iT邦幫忙

第 11 屆 iT 邦幫忙鐵人賽

DAY 30
2
Modern Web

Angular 元件庫 NG-ZORRO 基礎入門系列 第 30

[Angular 元件庫 NG-ZORRO 基礎入門] Day 30 - 社群貢獻

前言回顧

經過之前的介紹,我們已經瞭解了 NG-ZORRO 很多內容,今天介紹該系列最後一篇文章:如何參與社群貢獻。在這篇文章中我們也會介紹如何進行 PR 提交CI 測試Merge 程式碼 等規範操作流程。

貢獻程式碼

fork 倉庫

點選 fork 會自動在自己的倉庫生成一個同名倉庫,這樣我們就可以開始在自己的倉庫新分支進行開發,然後建立 PR 即可。

https://img.alicdn.com/tfs/TB1xLyWhLb2gK0jSZK9XXaEgFXa-2264-724.jpg

本地開發

開發流程

$ git clone https://github.com/{username}/ng-zorro-antd.git
$ cd ng-zorro-antd
// 新增一個遠端分支用於同步
$ git remote add upstream https://github.com/NG-ZORRO/ng-zorro-antd.git
$ git checkout -b my-fix-branch master

這樣就可以在本地分支修復或實現具體功能,注意 相關程式碼規範,當你完成了相關的修改後,只需要將自己的 commit 推送到自己倉庫的分支即可:

$ git commit -m "fix(module: xxx): xxx"
$ git push origin my-fix-branch

如果開發時間較長,有其他人已經推送了新的 commit 到 NG-ZORRO 的 master 分支,別忘了同步最新的分支程式碼喔:

$ git fetch upstream
$ git rebase -i upstream/master

這樣,在 github 建立一個 Pull Request 到 ng-zorro-antd:master,官方機器人會自動幫助你打上 LabelsTravis CI 工具也會自動跑,一旦所有的測試均已成功,社群值班同學也會進行程式碼 Review,最終全部通過後完成合並。

https://img.alicdn.com/tfs/TB18sS5hQY2gK0jSZFgXXc5OFXa-2032-524.jpg

釋出

通常來說,NG-ZORRO 本週都會發一個小版本,用於修復社群使用者提出和發現的諸多問題,每個大版本內的釋出會保證程式碼相容,如 8.x 版本通常不會出現 break changes,而是會在開發模式時在 瀏覽器 console 欄輸出 warning 資訊,以提醒使用者始終保持最新穩定版本,防止迭代版本差距過多導致後續升級困難。

總結

至此,我們整個系列也告一段落了,當然,整個系列文章只涉及到了 NG-ZORRO 的一部分而已,更多的知識還是需要我們自己去使用嘗試發現。從專案第一個 commit 到現在,NG-ZORRO 已經有近百名參與者提供了 1100+ 個 commit,更多的開發者也在不斷地加入,希望大家也能共同參與社群維護,這也是這個系列文章的一個重要目標。

也希望大家通過這些文章能瞭解到一些新的知識,對於我們文章中涉及的專案,如果後續有時間我也會繼續完善,並將相關資料文件以 markdown 格式檔案同步至 github 倉庫。


上一篇
[Angular 元件庫 NG-ZORRO 基礎入門] Day 29 - 原始碼初窺: 測試
系列文
Angular 元件庫 NG-ZORRO 基礎入門30

2 則留言

0
阿展展展
iT邦好手 1 級 ‧ 2020-02-27 08:14:08

恭喜完賽!! 恭喜獲得優選!!

0
LewisLee000
iT邦新手 5 級 ‧ 2020-05-04 14:13:52

感謝分享!
藉由你這邊的介紹與分享程式片段,慢慢去了解Angular相關元件應用

謝謝

我要留言

立即登入留言