Windows 上 GitHub Desktop 的操作

標籤：名稱   oschina   移植   操作   列表   license   添加   ges   hang   

第1章 上傳開原始碼至GitHub

1.1 Git Windows 用戶端

具有git功能的Windows用戶端軟體有很多，如：git for windows（以前的msysGit）、TortoiseGit、GitHub Desktop（以前的GitHub for Windows）……

筆者對這些用戶端的理解：

1、git for windows

git 原產於 Linux，要在 Windows 上運行，需要移植。git for windows就是一個這樣的移植項目。它移植的不僅僅是一個程式，而是在 Windows 上類比出了一個 linux 環境。

git for windows 的下載網址為https://git-for-windows.github.io/，最新版本為2.10.2。它有兩種運行方式：命令列方式（專家使用）、圖形介面方式（菜鳥使用）。不過，它的圖形介面方式操作起來還是比較麻煩，所以筆者沒有選用它。

git for windows是一個開源項目，瀏覽https://github.com/msysgit/msysgit可下載原始碼。

2、TortoiseGit

TortoiseGit只是一個圖形介面程式，它內部調用的還是git for windows。所以，使用TortoiseGit之前需要安裝git for windows。

TortoiseGit最大的優勢在於與TortoiseSVN的操作比較相同，熟悉SVN的使用者可快速上手。

3、GitHub Desktop

GitHub Desktop 跟TortoiseGit一樣，內部也會調用git for windows。不過筆者認為它的操作是這三款軟體中最簡單的，安裝之後無需配置就可使用，非常適合菜鳥。

GitHub Desktop的下載網址為：https://desktop.github.com/。下載下來的檔案GitHubSetup.exe是一個線上安裝程式，有可能無法正常安裝。為此，可下載離線安裝包，其網址為http://pan.baidu.com/s/1Hkewm。下載GitHub_3_0_5_2.zip，解壓後運行GitHub.application即可安裝。

注意：如果離線安裝程式無法運行，就需要先安裝.NET Framework 4.5。可先運行線上安裝程式GitHubSetup.exe，安裝.NET Framework 4.5。然後再運行離線安裝程式。

1.2 註冊GitHub賬戶

要上傳開原始碼至GitHub.com，需要在該網站上註冊一個賬戶。請瀏覽網站https://github.com/，單擊"Sign up"按鈕註冊賬戶。操作比較簡單，就不再贅述了。

1.3 登入

安裝好GitHub Desktop後，第一次運行時需要輸入GitHub.com的使用者名稱和密碼，如所示：

圖1.1

中，輸入使用者名稱和密碼後，單擊"Log in"按鈕完成登入。

1.4 建立本地代碼倉庫

單擊GitHub Desktop主介面左上方的按鈕"+"，將顯示如下介面：

圖1.2

單擊"Create"按鈕，輸入"Name"和"Local path"後單擊"Create repository"按鈕，完成本地代碼倉庫的建立。

如所示，建立本地代碼倉庫的實質就是：1）根據的設定，建立目錄W:\(yhf)\git\GitHub\test；2）在該目錄下產生兩個檔案.gitattributes和.gitignore；3）在該目錄下執行 git init 命令，產生.git目錄（該目錄是隱藏目錄）。

圖1.3

1.5 建立遠程代碼倉庫

如所示。GitHub Desktop裡首先選中上一節建立的本地代碼倉庫test，然後單擊右上方的"Publish"按鈕。

圖1.4

顯示如下介面

圖1.5

"Name"是遠程代碼倉庫的名稱；"Description"是對該項目的描述。單擊"Publish test"按鈕，將完成遠程代碼倉庫的建立，並把本地代碼倉庫裡的內容上傳給遠程代碼倉庫。

這個遠程代碼倉庫在github.com上，如所示：

圖1.6

1.6 行結束符

將本地代碼倉庫裡的檔案上傳給遠程代碼倉庫時，git非常智能：會自動把Windows的行結束符\r\n（即0DH、0AH）替換為\n。關於這一點，VC++.NET表示無所謂，VC++6.0很受傷（無法解析.dsp和.dsw檔案）。為了防止git對行結束符的自動改動，需要修改兩個檔案。

在 Windows 7 上，修改檔案C:\Users\Administrator\.gitconfig（Administrator是登入Windows時的使用者名稱）。增加配置項 autocrlf 和 safecrlf。如下所示：

圖1.7

注意：

1、該檔案的行結束符為\n，即0AH。所以，筆者使用UltraEdit編輯它，而不是Windows系統內建的記事本；

2、autocrlf和safecrlf前面的空格其實是一個TAB（09H）字元；

3、這個檔案只用修改一次即可。

修改本地代碼倉庫裡的檔案.gitattributes，可使用記事本，如所示：

圖1.8

中，請將text=auto中的auto刪除，然後儲存。

1.7 提交改動至本地代碼倉庫

上一節，修改了本地代碼倉庫裡的檔案.gitattributes。這個改動應該提交給本地代碼倉庫（其實就是修改本地代碼倉庫.git目錄內的檔案）。具體操作如下：

如所示。GitHub Desktop裡首先選中代碼倉庫test，然後進入"? uncommitted changes"頁面。輸入提交資訊後，單擊"Commit to master"按鈕。

圖1.9

GitHub Desktop主介面下方出現所示提示時，說明提交完成。

圖1.10

1.8 同步代碼倉庫

上一節將改動提交給了本地代碼倉庫。通過"同步"操作，可以將這種改動提交給遠程代碼倉庫。

如所示，單擊GitHub Desktop主介面右上方的"Sync"按鈕即可。

圖1.11

1.9 添加檔案至本地代碼倉庫

把代碼檔案複製到本地代碼倉庫所在檔案夾內，如所示：

圖1.12

然後按照1.7、1.8節的操作，將這些檔案提交給遠程代碼倉庫。

1.10 刪除本地代碼倉庫

以刪除本地代碼倉庫test為例進行說明。如所示，滑鼠右鍵單擊"test"，快顯功能表中，單擊【Remove】功能表項目，即可將test從GitHub Desktop倉庫列表中刪除。

圖1.13

上面的刪除只是將test從GitHub Desktop倉庫列表中移除，物理刪除本地倉庫需要刪除圖1.3所示的檔案夾W:\(yhf)\git\GitHub\test。

1.11 增加本地代碼倉庫

上一節中將test從GitHub Desktop倉庫列表中移除，實際的本地倉庫並沒有刪除。此時，就可以增加本地倉庫。如所示：

圖1.14

經此操作後，test將被增加至GitHub Desktop的倉庫列表中。

1.12 刪除遠程代碼倉庫

瀏覽遠程代碼倉庫的地址，如：https://github.com/hanford77/test，然後進入設定頁面，單擊"Delete this repository"按鈕即可。

 

第2章 上傳開原始碼至oschina

GitHub Desktop管理GitHub.com上的遠程代碼倉庫比較方便，換成其他的git伺服器，操作起來會有所不同。如：GitHub Desktop無法在oschina上建立遠程代碼倉庫。本章將重點說明如何將開原始碼上傳至oschina。

2.1 建立遠程代碼倉庫

登入網站http://git.oschina.NET，註冊賬戶後建立一個項目，頁面顯示如下：

圖2.1

開源許可證的選擇請參考（來自部落格http://www.ruanyifeng.com/blog/2011/05/how_to_choose_free_software_licenses.html）。

圖2.2

單擊圖2.1中的"建立"按鈕，完成項目的建立。如所示：

圖2.3

單擊的"SSH"，然後單擊右端的複製按鈕，將項目的網址（[email protected].net:hanford/test.git）複製到剪貼簿內。

注意：也可以單擊HTTPS，然後複製項目的https網址。這種網址的麻煩之處在於：本地代碼倉庫與遠程代碼倉庫同步時，會要求輸入使用者名稱和密碼。

2.2 SSH KEY

上一節複製了項目的SSH地址：[email protected].Net:hanford/test.git。使用SSH，本機與遠程電腦通訊時同樣需要認證（輸入使用者名稱和密碼），為了簡化認證，可使用SSH KEY。

使用SSH KEY前，它是需要建立的。無需使用git命令列，GitHub Desktop已經為你做好了這一切。進入C:\Users\Administrator\.ssh（Administrator是登入Windows時的使用者名稱）如所示：

圖2.4

github_rsa、github_rsa.pub 是GitHub Desktop與GitHub.com通訊時需要的私密金鑰、公開金鑰。

id_rsa、id_rsa.pub 是GitHub Desktop與其它git伺服器通訊時需要的私密金鑰、公開金鑰。

記事本開啟id_rsa.pub複製公開金鑰，再將公開金鑰粘貼到oschina網站，如下所示：

圖2.5

中的第2項隨便填，第3項就是公開金鑰。單擊"確定"按鈕，完成一個公開金鑰的添加。

經過上面的配置，GitHub Desktop與oschina伺服器通訊時將使用私密金鑰、公開金鑰，不再需要輸入使用者名稱和密碼了。

注意：GitHub.com為什麼不需要設定SSH KEY？因為GitHub Desktop已自動把此項工作完成了。（所以，GitHub Desktop真的適合菜鳥）

2.3 複製遠程代碼倉庫至本地

單擊Windows開始菜單下的【GitHub,Inc】【Git Shell】功能表項目，如下所示：

圖2.6

顯示如下命令視窗

圖2.7

進入本地代碼倉庫目錄（W:\(yhf)\git\oschina），然後運行命令

git clone [email protected]:hanford/test.git

注意：[email protected]:hanford/test.git就是圖2.3複製的項目地址。

命令執行完畢後，可以看到W:\(yhf)\git\oschina下的本地代碼倉庫test。如所示：

圖2.8

使用1.11節的方法，將這個本地代碼倉庫增加到GitHub Desktop倉庫列表中。如所示：

圖2.9

注意：代碼倉庫test的遠程代碼倉庫不在GitHub.com上，所以test在Other下。

2.4 其它操作

其它操作請參考1.6節（不用修改檔案.gitattributes）、1.7節、1.8節、1.9節。

2.5 README.md

oschina上建立遠程代碼倉庫時，預設就會建立檔案README.md。它是Markdown 格式的標記語言檔案。是對整個項目的說明。

關於.md檔案的格式，需要注意：

1、行結束符為\n（0AH）；

2、編碼為UTF-8，不帶BOM；

3、GitHub.com會忽略行結束符。

Markdown 標記語言的使用，請上網查閱相關資料。

Windows 上 GitHub Desktop 的操作