HelloX專案github協同開發指南

2022-09-17 22:48:16 字數 3043 閱讀 7541

為了提高協同開發效率,hellox專案已託管到github站點上。

依據眼下的開發進展,建立了下列幾個子專案:

hellox作業系統核心專案:

hellox作業系統gui模組專案:

面向stm32的移植版:

興許依據須要,再新增其他相關子專案,全部這些子專案都是hellox專案的一部分。

本文件對怎樣協同開發進行描寫敘述,旨在幫助開源開發者順利搭建起github協作開發環境,共同開發hellox專案。

嚴格來說,github是乙個站點的名稱,真正的版本號管理功能是由git實現的。為了簡便,籠統的覺得github就是乙個版本號管理系統就ok了。

事實上,github的工作原理非常easy,借用我們日常開發時使用的策略模擬,會非常easy理解。比方,如今有乙個開發專案,這個開發專案經過長時間積累。已經有了數萬行**。並由乙個組織或個人唯一管理(假設多個人同一時候管理。就亂套了)。

你希望對這個專案進行改動或者優化。

這時候,謹慎起見,你不可能直接在原專案上進行改動,而是把原來的專案複製乙份,在這個複製專案上進行改動。

改動完畢後,會總結出改動了哪些內容(改動了哪些檔案。加入了哪些檔案,刪除了哪些檔案等),然後把改動的內容提交給管理者審核。審核通過後,管理者會逐一合併到原有專案中。

github自己主動化的實現了這個過程。

原始專案存放在乙個固定的位置,並由乙個作者允許管理。比方對於hellox專案的hellox作業系統核心原始碼。其固定存放位置是github.com/hellox-project/hellox_kernel,當前的管理者是我本人。

假設你希望參與開發,對核心進行改動。那麼就須要首先複製乙份(github上叫做fork),到你自己的位於github站點的個人空間內。

注意,這時候你的改動還是停留在本地**庫中,尚未傳遞到你自己的網上空間內。

假設要把改動內容上傳到你自己的github空間,須要執行乙個叫做push的操作,把本地commit的改動,推送到你自己的github空間內。

一旦push完畢,改動才同步到你自己的github空間中。

為了把你的改動合併到原始**中,你必須發起乙個pull request,告訴專案管理者,你做了哪些改動,為什麼做這些改動。申請專案管理者合併到主流版本號中。

fork,clone,commit。push,merge

首先,你必須了解hellox專案的背景及目標。推斷是否與您的背景或者意圖能夠匹配。以決定是否要投入開發。

這個過程要謹慎細緻,一旦決定要投入。那麼就須要遵循開源精神,有始有終,當然,您的貢獻會被盡量精確的記錄下來(hellox專案的每乙個子專案下,都有authors.txt檔案,記錄了貢獻者的主要貢獻及個人資訊)。

在決定投入開發之後,剩下的事情就非常easy了。以下一步一步的介紹。

在github上註冊一下,建立自己的user space。

這個過程不細說。直接登入github.com,點選sign up就可以。

建議選擇註冊的username、郵箱、password等資訊。萬一您成為github上的大牛,乙個非常酷的名字會非常重要。

在github上註冊成功之後,會一直保持登入。

這時候。建議fork一下您希望參與開發的專案,比方您希望參與hellox專案中的hellox作業系統stm32版子專案,那麼在瀏覽器位址列中輸入就可以連線到hellox專案的主頁下,頁面上會列出全部子專案。選擇當中的乙個。進去之後,點選頁面上的forkbutton,就可以複製乙份到您自己的空間。

再回到您自己的個人頁面。就可以看到fork過來的專案。

這個過程會比較長,網路情況不好的話,可能會失敗。請多試幾次。

在安裝過程中。會提示您輸入第一步建立的github賬戶資訊。

最新的github版本號。提供圖形介面和命令列介面。

儘管圖形介面做得非常簡潔非常好看,但用起來還是感覺不太方便,我個人仍然傾向於github命令列client。

依照預設安裝,github會在桌面上生成乙個git shell的圖示。雙擊就可以進入命令列介面。這個命令列介面整合了github的相關命令和windows相關命令,比原來的unix命令列風格好用了非常多。

建立乙個本地工作資料夾,比方d:\hellox。然後使用cd等命令,定位到工作資料夾,執行下列命令:

d:\hellox>git clone

/hellox_stm32.git

第五步改動完畢之後,您所做的改動僅僅是停留在原始碼檔案裡,尚未被github接納到它自己的資料庫中。

這時候。必須在命令列下執行commit操作。

步驟例如以下:

1.      執行git status命令。會列做了改動的檔案,包含新增的原始碼檔案、刪除的原始碼檔案;

2.      執行git add . 命令(注意命令後面的點號),把改動新增到github管理的資料庫中;

3.      執行git commit –m 「改動描寫敘述」 命令,把改動提交到github本地庫中。注意,引號中的描寫敘述,是對本次改動的簡要介紹,會呈如今原始碼檔案的改動歷史中。

完畢上述步驟之後。您所做的改動就記錄到github本地庫中了。

假設做進一步的原始碼改動,改動完畢後,反覆上述操作,提交到本地庫中。

在本地**庫上完畢提交之後,改動還是侷限在本地庫,尚未上傳到github的個人空間內。這時候執行下列命令,把改動的**同步到您自己的github空間中:

d:\hellox>git push –u origin master

當中的origin,代表**的原始版本號,即是您自己在github上fork的版本號(注意不是專案的最原始版本號)。master則是本地版本號。

push到個人github空間之後,假設希望合併到專案的主版本號中。必須發起pull request。讓專案管理員來審核您所做的改動。並決定是否合併到專案主版本號中。詳細操作是。在您自己的github專案頁面上。點選pull request,會顯示出建立pull request的頁面。假設感覺頁面內容非常複雜,不要緊,直接點選create pull request就可以,大部分內容。github已幫助您填好了。

到此。您的大部分工作就完畢了,接下來就是專案管理員審核pull request,並討論是否終於合併到版本號中。

假設確定要合併,那麼您的contribution會被記錄下來。

GitHub專案跟進

2016 05 09 15 30 43人閱讀收藏 舉報 android開發筆記 14 要做的事情太多,看見喜歡的想學的專案就做吧。1 a md project with mvp architecture 可以學到 android design庫的使用 自定義你的基類activity 應用mvp模式到...

Github專案管理

git的安裝就不說了。上傳專案 步驟總結 其實只需要進行下面幾步就能把本地專案上傳到github 1 在本地建立乙個版本庫 即資料夾 通過git init把它變成git倉庫 這步還有乙個簡便的方法 首先在github新建乙個倉庫,然後git cllone 要將你的庫轉殖下來到本地電腦中,方便以後進行...

github上傳專案

echo office automation script readme.md git init 在專案根目錄執行init git add readme.md git commit m first commit git remote add origin git push u origin mast...