首頁 > 軟體

如何給 GNU 專案貢獻程式碼

2020-06-16 17:46:15

想為開源專案貢獻你的程式碼嗎？這裡告訴你該如何入手。

本文以 Emacs 專案為例。

 

1、訂閱郵寄清單

GNU 的專案都通過郵寄清單和全世界的貢獻者交流，所以你應該先去 https://lists.gnu.org/mailman/listinfo 找到相應專案的郵寄清單。一般建議加入 bug 和 devel 兩個郵寄清單。比如 Emacs，找到 Emacs-devel 和 bug-gnu-emacs 郵寄清單並訂閱，前者用於討論改進、提新的 feature 等，後者用於反饋 bug、提交 patch。

郵寄清單的郵件量一般都比較大，尤其是加入了多個專案的郵寄清單後，不僅資訊多，還很雜亂，所以建議：

 

1、 建立資料夾，如圖，QQ 郵箱：

 

2、 做收信規則，根據收件人規則把郵件移動到相應的資料夾中。如圖，QQ 郵箱：

 

2、修改程式碼

GNU 專案有自己的程式碼倉庫，在這裡：https://savannah.gnu.org/ 。

找到 Emacs 的 Git 倉庫：http://git.savannah.gnu.org/cgit/emacs.git

然後把程式碼拉回本地：

  1. $ gitclonegit://git.sv.gnu.org/emacs.git -b emacs-25

Emacs 有很多分支，目前的開發主要在 emacs-25 這個分支上進行，所以上面命令我是從 emacs-25 分支上拉取的程式碼。

一段時間後維護者會把程式碼合併到 master 分支中。

如果之前已經拉過程式碼了，在修改前記得 pull 一次來保持程式碼是最新的：

  1. $ git pull

不要在當前分支上修改程式碼，理由有很多，比如官方不一定接受你的 patch。而是對每修一個 bug 都新建一個分支：

  1. $ git checkout -b tramp-sh-add-doas --track emacs-25

這行命令我新建了一個叫“tramp-sh-add-doas”的分支，取名要有含義，尤其是你在要修復多個 bug 時好區分。這個名字的含義是為了在 tramp-sh 裡增加 doas 命令的支援。

接下來是漫長的編碼階段，主要注意兩點：

  1. 編碼風格統一，最簡單的方法就是看看同檔案裡別人是怎麼寫的，他的縮排、命名、花括號位置等等。
  2. 不要去修改無關的程式碼，比如去動了其他位置的縮排等等。不然維護者會很疑惑。

程式碼寫完後，commit 一下：

  1. $ git commit -a

寫一段好的 commit 也很重要，最簡單的方法就是執行 git log，看別人怎麼寫的。一般 commit 的第一行寫清楚你本次修改是做了什麼，再空一行，逐行列出增加、修改的函數和變數等，讓開發者一目了然，比如：

  1. Author:XiLu<lx@shellcodes.org>
  2. Date:FriDec1110:52:082015+0200
  3. Initial support forRubyin'etags'
  4. * lib-src/etags.c <Ruby_suffixes>:New variable.
  5. (lang_names):Add an entry forRuby.
  6. (Ruby_functions):Newfunction.(Bug#22116)

提交 commit 後，執行以下命令生成一個 patch 檔案：

  1. $ git format-patch emacs-25

這行命令會把當前分支修改的內容和 emacs-25 分支做 diff，然後在當前目錄下生成一個 diff 檔案，如：0001-Add-support-for-doas-command.patch。

生成的 patch 檔案是需要發到郵寄清單裡，相關檔案的維護者會跟你溝通並合併到程式碼倉庫中的，和 Github 上直接發 Pull Request 來比，就沒那麼幸福了。

最後，把修補程式傳送到郵寄清單去（這裡或許你需要設定一下 Git 的傳送郵件，請自行找資料）：

  1. git send-email --to=bug-gnu-emacs@gnu.org 修補程式檔案1修補程式檔案2修補程式檔案..

之後 GNU 的 bug 跟蹤系統會確認你的 bug，並給你提交的 bug 分配一個 ID，然後自動回復一封郵件給你：

然後就等待相關維護者回復郵件與你溝通。在和開發者溝通時就事論事，不要說無關的廢話。另外一定要注意回復郵件的風格，社群一般使用的 Bottom-posting（下回復）風格，實際上很多開源軟體都是用的 Bottom-posting 風格的。如果這方面你不熟悉，請參考維基百科學習一下： https://zh.wikipedia.org/wiki/%E5%9B%9E%E5%B8%96%E9%A3%8E%E6%A0%BC 。QQ 郵箱網頁版是不支援下回復的，最好用郵件用戶端來回復，一般郵件用戶端是可以設定成 Bottom-posting 風格的，請 Google 自行查閱設定方法。

開發者和你進一步溝通，完畢之後會關閉這個 bug，並把程式碼合併到倉庫中去。

你的程式碼在合並到倉庫之前可能還會有一道障礙，直到清除障礙後程式碼才可以進入倉庫——簽協定。

 

3、簽署協定檔案

如果你貢獻的程式碼超過15行（見：https://www.gnu.org/prep/maintain/html_node/Legally-Significant.html），是需要和 FSF（自由軟體基金會）簽紙質協定的。

簽協定的主要目的是證明程式碼由你所寫，沒有侵犯到其他版權，並且版權歸給 FSF。

如果你提交的程式碼確實需要簽檔案，開發者會郵件回你一個申請表模板，讓你按模板內容填寫一封申請郵件給 FSF 來申請簽協定檔案的。

模板內容如下（註：“#”是我自行新增的註解）：

  1. ----------------------------------------------------------------------
  2. REQUEST: SEND FORM FOR PAST AND FUTURE CHANGES
  3. [Whatis the name of the program orpackage you're contributing to?]
  4. # 你貢獻的專案名稱，比如Emacs。
  5. # 注意一個專案只能簽一份協定，如果你這裡寫多個專案，就需要簽多份協定。
  6. [Did you copy any files or text written by someone else in these changes?
  7. Even if that material is free software, we need to know about it.]
  8. # 解釋你貢獻的程式碼裡是否用了其他專案程式碼，如果有就列一下。
  9. [Do you have an employer who might have a basis to claim to own
  10. your changes? Do you attend a school which might make such a claim?]
  11. # 是不是以你個人名義來提交程式碼的，是的話就寫no。
  12. # 如果是公司名義，好像需要公司和FSF再簽協定，這個流程我不熟悉。
  13. [For the copyright registration, what country are you a citizen of?]
  14. # 一般就寫China。
  15. [What year were you born?]
  16. # 你生日。
  17. [Please write your email address here.]
  18. # 你郵件地址。
  19. [Please write your postal address here.]
  20. # 通訊地址，需要寫詳細點。
  21. [Which files have you changed so far, and which new files have you written
  22. so far?]
  23. # 你改變了哪些檔案，列出來。

把這封郵件發給 copyright-clerk@fsf.org， 郵件標題是你真實的姓名 ，郵件內容就是上面模板填寫後的內容。

然後 FSF 會稽核你的申請，一般需要幾天。稽核通過後他們會給你發一封郵件，讓你將附件的 PDF 檔案列印下來，然後簽字，簽上你的名字（不要用中文），以及寫好日期（日期的月份需要用英文，不要用數位，如：2015 December 30）。

接下來，把簽完的紙質協定寄到美國去。你可以去淘寶找 DHL 快遞代收，DHL 大概3天就到了，費用大概是￥140～￥160之間。

他們收到你的紙質協定後也會簽字，需要等幾天，具體週期視他們處理情況而定，如果你等了兩週都還沒回你，那麼你可以回郵件問問怎麼回事，比如我的就正好遇到聖誕節放假。

最後，他們會把簽字後的掃描件以 PDF 格式傳送到你的郵箱，整個過程算是結束了。

如果你換了工作，也請告知他們，有可能會涉及到協定重簽，比如你到了新公司，給他們提交的程式碼不再是個人性質。

Happy Hacking。

 

4、感謝

Xue Fuqiao、Eli Zaretskii

本文永久更新連結地址：http://www.linuxidc.com/Linux/2016-02/128229.htm


相關文章
IT145.com E-mail:sddin#qq.com