2019年10月31日 星期四

Github 快速上手 2 : 建立新的 Repository 與 同步

Github 快速上手 2 : 建立新的 Repository 與 同步

在 Github 建立一個新的 Repository

請打開 Github 網頁,於登入認證之後,點選右上方的 + 加號 圖片
當 [Create a new repository] 頁面出現之後,請在 [Repository name] 這個欄位中,輸入想要建立的 Repository 的名稱,這裡會輸入 MyFirstRepository
使用滑鼠捲動網頁到最下方,將會看到 [Create respository] 這個按鈕,請點選這個按鈕,完成這個 Repository 的建立。

複製 Github 的 Repository 到本機電腦上

現在完成了這個 MyFirstRepository 這個 Repository 的建立,現在,請在 [Quick setup — if you’ve done this kind of thing before] 標題的下方,將會看到一個 HTTS URL,請將這個 URL 複製到系統剪貼簿內。
請打開檔案總管,切換到想要儲存這個 Repository 的目錄內,這裡是切換到這台電腦的 [C:\Xamarin] 目錄內;接著,在檔案總管空白地方,使用滑鼠右擊,現在將會看到彈出功能表中有個 [Git Clone...] 這個選項,請點選這個選項。
現在, [TortoiseGit] 將會使用系統剪貼簿內儲存的 URL,複製一份遠端 Github 上的 Repository 到這台電腦上的這個目錄內。
當出現了 [Git clone] 對話窗的時候,可以直接使用預設值 ( 因為,對於 URL 欄位的內容,將會從剪貼簿取得 ),接著請點選 [OK] 按鈕

設定 Repository 簽入 Commit 要排出的檔案類型

現在請切換到這個 Repository 的目錄下,也就是 [C:\Xamarin\MyFirstRepository] 這個目錄,並且建立一個 [.gitignore] 文字檔案。
該 [.gitignore] 的檔案內容,可以從 https://raw.githubusercontent.com/vulcanlee/CSharp2019/master/.gitignore 取得
上面螢幕截圖為建立 [.gitignore] 文字檔案 與 加入該檔案內容的操作結果。
現在可以進行第一次的 簽入 Commit,請在這個 Repository 目錄內的空白地方,點選滑鼠右鍵,從彈出功能表中選擇 [Git Commit -> "master"] 這個選項
當 [C:\Xamarin\MyFirstRepository - Commit - TortoiseGit] 對話窗出現之後,請在 [Message] 欄位中輸入 Init (或者任何代表此次簽入的文字內容)。
在下方的 [Changes made (double-click on file for diff)] 標題下方,點選 [All] 文字,代表要選擇所有當前所有的檔案。
最後,找到下方的 [Commit] 按鈕,請先點選該按鈕右方的 向下黑色三角形 ,此時會出現一個彈出選單,請在該選單內選擇 [Commit & Push] ,表示,按下這個按鈕之後,將會進行簽入與推入到遠端的 Github 主機內。
當進行第一次操作的時候,將會如上面螢幕截圖,要求第一次要先進行 Github 身分驗證,在這裡,請輸入剛剛申請 Github 的帳號(或者Email)和密碼之後,點選 [Github Login] 對話窗下方的 [Login] 按鈕。
當看到如上面螢幕截圖,這就表示這次的簽入與推入到遠端 Github Repository 的工作已經完成了。
從網頁中將會看到剛剛增加的 [.gitignore] 檔案已經成功地簽入到 Github Repository 內了。

將 Xamarin.Forms 的方案內所有專案,簽入到 Github Repository 內

現在可以找出一個正在開發或者新建立的 Xamarin.Forms 專案,不過,最好這個專案是可以正常建置與執行的,因為,這裡需要這些專案內的 Bin Obj 目錄下的這些二進位元檔案。
在這裡已經複製一份 CustNaviService 之 Xamarin.Forms 的方案,根據檔案總管的統計,這個 CustNaviService 目錄下總共有 182MB 磁碟空間,可是,真正的原始碼並沒有這麼多,絕大多數是由二進位檔案所佔據。
在此之前,已經 簽入 Commit 這個 [.gitignore] 檔案,因此,當要繼續簽入這個專案檔案內容的時候,將會排除這些 二進位 型態的檔案,現在,來檢驗看看。
請在檔案總管確認是在 [C:\Xamarin\MyFirstRepository] 目錄下,使用滑鼠右鍵點選空白地方,當彈出功能表出現的時候,請選擇 [Git Commit -> "master"] 這個選項,準備簽入與推入到 Github Repository 內
在出現了 [C:\Xamarin\MyFirstRepository - Commit - TortoiseGit] 對話窗的時候,請在 [Message] 欄位內輸入 [加入 CustNaviService 方案所有檔案] 簽入備註訊息,並且在下方點選 [All] 文字,選擇所有的檔案內容。
若此時使用滑鼠捲動最下方的檔案清單內容,應該不會看到任何 二進位元 類型的檔案。
最後,請點選 [Commit & Push] 按鈕,進行簽入與推入到Github Repository。
當完成簽入與推入之後,將會看到如上圖的畫面。

確認推入的專案,將不包含二進位元的檔案

先打開 Github 網站中的 MyFirstRepository Repository,檢查剛剛推入的檔案是否已經推進去了。
打開 https://github.com/XamarinForms/MyFirstRepository 網頁,在下方就會看到 [CustNaviService] 目錄已經在 Github 的 Repository 內了。
請使用滑鼠來點選上面截圖的紅色箭頭指向的按鈕,也就是 [Clone or download] 按鈕
當彈出了 [Clone with HTTPS] 視窗的時候,請將該子視窗內的 URL 複製起來。這裡的 URL 將會是 : https://github.com/XamarinForms/MyFirstRepository.git
現在請使用檔案總管切換到 C:\Xamarin 這個目錄下
在該目錄的空白地方,使用滑鼠右鍵點選 [Git Clone...] 這個選項
當出現了 [Git clone - TortoiseGit] 這個對話窗,請將 [Directory] 這個欄位,輸入成為 C:\Xamarin\MyFirstRepository2
也就是要複製一份 Github 上的 Repository,不過,是要複製到 C:\Xamarin\MyFirstRepository2 這個目錄下 (原先剛剛的 Repository 是複製到 C:\Xamarin\MyFirstRepository 目錄下)
最後,請點選 [OK] 按鈕,開始進行複製
完成複製後,請在 [C:\Xamarin - Git Command Program - TortoiseGit] 對話窗內,點選 [Close] 按鈕
從上面操作螢幕截圖中,可以看到 [MyFirstRepository2] 這個目錄已經產生出來了。
請使用檔案總管,查看 [C:\Xamarin\MyFirstRepository2\CustNaviService] 目錄的內容,發現到 [CustNaviService] 這個目錄下,僅佔有 1.32 MB 大小,這與之前查詢 [C:\Xamarin\MyFirstRepository\CustNaviService] 目錄所站的空間為 182MB 有很大的落差,這是因為絕大部分的檔案都是二進位元的檔案,而且在簽入的時候都已經排出掉了,不會簽入到 Github Repository 內。

清除本機 Repository 內的二進位元檔案

現在,請使用檔案總管回到 [C:\Xamarin\MyFirstRepository] 目錄下,準備把這些二進位元的檔案清除掉,順便檢查清除後的專案所佔據的磁碟空間。
請在 [C:\Xamarin\MyFirstRepository] 目錄下,使用滑鼠右擊空白地方,當彈出選單出現之後,依據點選 [TortoiseGit] > [Clean up...] 選項
現在出現了 [C:\Xamarin\MyFirstRepository - Clean - TortoiseGit] 這個對話窗,相關的選項請使用預設值,直接點選 [OK] 按鈕
現在請使用檔案總管來查看 [C:\Xamarin\MyFirstRepository\CustNaviService] 目錄的內容,從上面螢幕截圖中,可以看到,這些二進位元檔案也都被移除了,整個 [C:\Xamarin\MyFirstRepository\CustNaviService] 目錄僅佔有 1.32 MB
請注意
在使用這個功能的時候,請記得這個 Repository 已經完成了 簽入 Commit 動作




沒有留言:

張貼留言