Windows 上 GitHub Desktop 的操作

未經(jīng)博主允許不得轉(zhuǎn)載。

目 錄

第1章 上傳開源代碼至GitHub    1

1.1 git Windows 客戶端    1

1.2 注冊GitHub賬戶    2

1.3 登錄    2

1.4 創(chuàng)建本地代碼倉庫    2

1.5 創(chuàng)建遠(yuǎn)程代碼倉庫    3

1.6 行結(jié)束符    5

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

1.8 同步代碼倉庫    7

1.9 添加文件至本地代碼倉庫    8

1.10 刪除本地代碼倉庫    9

1.11 增加本地代碼倉庫    9

1.12 刪除遠(yuǎn)程代碼倉庫    10

第2章 上傳開源代碼至oschina    11

2.1 創(chuàng)建遠(yuǎn)程代碼倉庫    11

2.2 SSH KEY    13

2.3 克隆遠(yuǎn)程代碼倉庫至本地    14

2.4 其它操作    16

2.5 README.md    16

第1章 上傳開源代碼至GitHub

1.1 Git Windows 客戶端

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

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

1、git for windows

git 原產(chǎn)于 Linux，要在 Windows 上運行，需要移植。git for windows就是一個這樣的移植項目。它移植的不僅僅是一個程序，而是在 Windows 上模擬出了一個 linux 環(huán)境。

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

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

2、TortoiseGit

TortoiseGit只是一個圖形界面程序，它內(nèi)部調(diào)用的還是git for windows。所以，使用TortoiseGit之前需要安裝git for windows。

TortoiseGit最大的優(yōu)勢在于與TortoiseSVN的操作比較相同，熟悉SVN的用戶可快速上手。

3、GitHub Desktop

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

GitHub Desktop的下載網(wǎng)址為：https://desktop.github.com/。下載下來的文件GitHubSetup.exe是一個在線安裝程序，有可能無法正常安裝。為此，可下載離線安裝包，其網(wǎng)址為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，需要在該網(wǎng)站上注冊一個賬戶。請瀏覽網(wǎng)站https://github.com/，單擊"Sign up"按鈕注冊賬戶。操作比較簡單，就不再贅述了。

1.3 登錄

安裝好GitHub Desktop后，第一次運行時需要輸入GitHub.com的用戶名和密碼，如下圖所示：

圖1.1

上圖中，輸入用戶名和密碼后，單擊"Log in"按鈕完成登錄。

1.4 創(chuàng)建本地代碼倉庫

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

圖1.2

單擊"Create"按鈕，輸入"Name"和"Local path"后單擊"Create repository"按鈕，完成本地代碼倉庫的創(chuàng)建。

如下圖所示，創(chuàng)建本地代碼倉庫的實質(zhì)就是：1）根據(jù)上圖的設(shè)置，創(chuàng)建目錄W:\(yhf)\git\GitHub\test；2）在該目錄下生成兩個文件.gitattributes和.gitignore；3）在該目錄下執(zhí)行 git init命令，生成.git目錄（該目錄是隱藏目錄）。

圖1.3

1.5 創(chuàng)建遠(yuǎn)程代碼倉庫

如下圖所示。GitHub Desktop里首先選中上一節(jié)創(chuàng)建的本地代碼倉庫test，然后單擊右上角的"Publish"按鈕。

圖1.4

顯示如下界面

圖1.5

"Name"是遠(yuǎn)程代碼倉庫的名稱；"Description"是對該項目的描述。單擊"Publish test"按鈕，將完成遠(yuǎn)程代碼倉庫的創(chuàng)建，并把本地代碼倉庫里的內(nèi)容上傳給遠(yuǎn)程代碼倉庫。

這個遠(yuǎn)程代碼倉庫在github.com上，如下圖所示：

圖1.6

1.6 行結(jié)束符

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

在 Windows 7 上，修改文件C:\Users\Administrator\.gitconfig（Administrator是登錄Windows時的用戶名）。增加配置項 autocrlf 和 safecrlf。如下所示：

圖1.7

注意：

1、該文件的行結(jié)束符為\n，即0AH。所以，筆者使用UltraEdit編輯它，而不是Windows系統(tǒng)自帶的記事本；

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

3、這個文件只用修改一次即可。

修改本地代碼倉庫里的文件.gitattributes，可使用記事本，如下圖所示：

圖1.8

上圖中，請將text=auto中的auto刪除，然后保存。

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

上一節(jié)，修改了本地代碼倉庫里的文件.gitattributes。這個改動應(yīng)該提交給本地代碼倉庫（其實就是修改本地代碼倉庫.git目錄內(nèi)的文件）。具體操作如下：

如下圖所示。GitHub Desktop里首先選中代碼倉庫test，然后進(jìn)入"? uncommitted changes"頁面。輸入提交信息后，單擊"Commit to master"按鈕。

圖1.9

GitHub Desktop主界面下方出現(xiàn)下圖所示提示時，說明提交完成。

圖1.10

1.8 同步代碼倉庫

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

如下圖所示，單擊GitHub Desktop主界面右上角的"Sync"按鈕即可。

圖1.11

1.9 添加文件至本地代碼倉庫

把代碼文件復(fù)制到本地代碼倉庫所在文件夾內(nèi)，如下圖所示：

圖1.12

然后按照1.7、1.8節(jié)的操作，將這些文件提交給遠(yuǎn)程代碼倉庫。

1.10 刪除本地代碼倉庫

以刪除本地代碼倉庫test為例進(jìn)行說明。如下圖所示，鼠標(biāo)右鍵單擊"test"，彈出菜單中，單擊【Remove】菜單項，即可將test從GitHub Desktop倉庫列表中刪除。

圖1.13

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

1.11 增加本地代碼倉庫

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

圖1.14

經(jīng)此操作后，test將被增加至GitHub Desktop的倉庫列表中。

1.12 刪除遠(yuǎn)程代碼倉庫

瀏覽遠(yuǎn)程代碼倉庫的地址，如：https://github.com/hanford77/test，然后進(jìn)入設(shè)置頁面，單擊"Delete this repository"按鈕即可。

第2章 上傳開源代碼至oschina

GitHub Desktop管理GitHub.com上的遠(yuǎn)程代碼倉庫比較方便，換成其他的git服務(wù)器，操作起來會有所不同。如：GitHub Desktop無法在oschina上創(chuàng)建遠(yuǎn)程代碼倉庫。本章將重點說明如何將開源代碼上傳至oschina。

2.1 創(chuàng)建遠(yuǎn)程代碼倉庫

登錄網(wǎng)站http://git.oschina.NET，注冊賬戶后創(chuàng)建一個項目，頁面顯示如下：

圖2.1

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

圖2.2

單擊圖2.1中的"創(chuàng)建"按鈕，完成項目的創(chuàng)建。如下圖所示：

圖2.3

單擊上圖的"SSH"，然后單擊右端的復(fù)制按鈕，將項目的網(wǎng)址（git@git.oschina.net:hanford/test.git）復(fù)制到剪貼板內(nèi)。

注意：也可以單擊HTTPS，然后復(fù)制項目的https網(wǎng)址。這種網(wǎng)址的麻煩之處在于：本地代碼倉庫與遠(yuǎn)程代碼倉庫同步時，會要求輸入用戶名和密碼。

2.2 SSH KEY

上一節(jié)復(fù)制了項目的SSH地址：git@git.oschina.Net:hanford/test.git。使用SSH，本機與遠(yuǎn)程電腦通訊時同樣需要認(rèn)證（輸入用戶名和密碼），為了簡化認(rèn)證，可使用SSH KEY。

使用SSH KEY前，它是需要創(chuàng)建的。無需使用git命令行，GitHub Desktop已經(jīng)為你做好了這一切。進(jìn)入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服務(wù)器通訊時需要的私鑰、公鑰。

記事本打開id_rsa.pub復(fù)制公鑰，再將公鑰粘貼到oschina網(wǎng)站，如下所示：

圖2.5

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

經(jīng)過上面的配置，GitHub Desktop與oschina服務(wù)器通訊時將使用私鑰、公鑰，不再需要輸入用戶名和密碼了。

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

2.3 克隆遠(yuǎn)程代碼倉庫至本地

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

圖2.6

顯示如下命令窗口

圖2.7

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

注意：git@git.oschina.net:hanford/test.git就是圖2.3復(fù)制的項目地址。

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

圖2.8

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

圖2.9

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

2.4 其它操作

其它操作請參考1.6節(jié)（不用修改文件.gitattributes）、1.7節(jié)、1.8節(jié)、1.9節(jié)。

2.5 README.md

oschina上創(chuàng)建遠(yuǎn)程代碼倉庫時，默認(rèn)就會創(chuàng)建文件README.md。它是Markdown 格式的標(biāo)記語言文件。是對整個項目的說明。

關(guān)于.md文件的格式，需要注意：

1、行結(jié)束符為\n（0AH）；

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

3、GitHub.com會忽略行結(jié)束符。

Markdown 標(biāo)記語言的使用，請上網(wǎng)查閱相關(guān)資料。

本文出自http://blog.csdn.net/hanford/article/details/53065310