[Github]教學適用於小型協作專案

KouWei.Lee
8 min readJun 21, 2021

--

前置作業成員請先申請github帳號

本次教學 CheckList

  1. Github上創建Organization
  2. 邀請協作成員
  3. 創建Repository
  4. 更改成員權限為write
  5. clone Repository測試push and pull

Step1 Github上創建Organization

  1. 帳戶- Organization
  2. New organization

為你的組織取名

2. 邀請協作成員

可以使用gmail,github帳號搜尋

被邀請者可以收到邀請加入該組織的mail如下圖

點選Join 就可以了

可以看到People已經出現2個人

點擊綠色

成員設定完成後接著我們進入到重點-大家的程式要放在哪邊->Repository

3.創建Repository

組織的owner(這邊是之前邀請別人的帳號)

可以創建Repository

點擊綠色create a new repo
Repository name 專案的名稱

README file記得打勾 可以讓人家知道你的專案是做什麼的

並且勾選將會自動替你產生主分支 master (預設好像是main)

關於git分支的概念不在本次教學內可以參考這裡

最後按下Create

成功產生程式倉庫

那們我們要如何協作使大家都能夠push程式到公用的倉庫->更改權限

4.更改成員權限為write

點選組織 mygroup20210621-setting

member_privileges

管理成員權限的地方

因為預設為read 我們將改成 write 使成員能夠對repo push & pull

權限設定完畢-進入測試

5.clone Repository測試push and pull

點擊Code 點擊複製

接著我們進到Eclipse

Eclipse使用Git/GitHub

Step 1: 設定Git Repositories

點選工具列 Window / Show View / Other

輸入Git / 點選Git repositories / Open

點選Clone a Git repository

將github上右圖的網址複製下來 點擊右邊按鈕可以自訂複製

貼上Git URI,其餘的內容就會自動填入,如果你的Repository需帳號密碼,請自行輸入,Next(下一步)。

選擇Branch(分支),Next(下一步)。

選擇資料夾位置,從Git Clone(複製/下載)下來的檔案要存放的位置,Finish(完成)

Eclipse就會開始Clone(複製/下載),等待進度至100%

Git Repositories就會出現剛剛新增的git位置,表示完成新增,接下來就可以開始push(上傳)專案。

(2) Commit & Push

上傳的專案,點選右鍵,選擇 Team / Share Project

選擇剛剛創建的Repository點選剛剛新增的.git,勾選欲上傳的專案,Finish(完成)。

完成可以看到專案後面多了 [MyFristProject master]

表示是在版本控制且位於master分支

COMMIT_替每次的更新標上記號

撰寫commit,撰寫此次交遞上傳的註解,建議填寫,方便之後做版本控制,不然長時間下來,更動多次後,會搞不清楚每次更動的內容。

Team / Commit

關於Git代碼狀態

未被Git跟踪的狀態為unstage狀態

已經被Git跟踪的狀態為stage狀態

因此我們需要把unstage->stage

點擊綠色+就可以將狀態做更動 (一個+單個改變

我們點擊右邊將全數列為stage

並打上Commit Message : 這是我第一次協作註解

點擊下方Commit

會將Staged Change資料清空 因為我們完成了一次版本紀錄

我們可以點擊Git Repositories 看看我們的git是否有紀錄新版本

可以看到在本地 出現了0b55280 版本 注解為 這是我第一次協作Commit測試

這邊我們可以確定Commit成功了

Push(上傳)

接著Push 推送到遠端的repo吧!

對著master分支右鍵 — Push Branch 將會推送本地的版本至遠端分支

確認是某上傳到master分支

再次確認

Push成功

可以看到Remote Tracking

跟本地的版本一致囉 代表我們上傳成功

也可以到Github上看

點擊Commit可以看到更動的紀錄

完成!!

最後來說一下小型團隊

小型團隊的注意事項 ,因為每個人將會頻繁的push,commit

很有可能會導致本地端的git版本與遠端上差距過大

因此你必須在你本地程式commit 之後 ,

pull(更新)遠端上的程式碼再去做更新,

以避免版本衝突

因此協作流程將是

Commit — Pull — Push

  1. 先對本地commit 版本
  2. pull更新遠程版本至本地
  3. 推送本地版本致遠程

在上傳前update你的版本極度重要

Team-Pull

以上為本次Github初學者教學

感謝你的觀看

希望這篇文章能夠幫助到你(妳)

如有錯誤指正

I hope you found this guide helpful. If not, then please let me know either in the comments below, I’m Albert

--

--