將檔案加入至伺服器

發行項
06/10/2015

當您使用 [方案總管] 且您的專案受到版本控制時，將檔案加入至版本控制通常是自動進行的。不過在某些情況下，您必須另外採取其他步驟將專案加入至版本控制。

提示

在您將檔案加入至版本控制之前，您應該先在開發電腦上設定工作區。

您想要怎麼做？

建立受版本控制的新程式碼專案及方案
將現有方案和程式碼專案放到版本控制下
將一個或多個檔案加入至版本控制
運用您的程式碼未建置的協力廠商二進位檔
自訂版本控制要忽略哪些檔案
從命令提示字元工作

建立受版本控制的新程式碼專案及方案

您可以同時建立新的 Team 專案並將它加入至版本控制，讓您和小組可以立即從您撰寫程式碼的第一行享受版本控制的所有優點。

新增專案對話方塊

在 Visual Studio 中，連接到 Team 專案 (如果尚未連接的話)。
依序選擇 [檔案]、[新增] 和 [專案] (鍵盤：Ctrl + Shift + N)。

[新增專案] 對話方塊隨即出現。
選取您想要建立的程式碼專案類型。
在 [名稱] 方塊中，指定程式碼專案的名稱。
如果 [方案] 清單出現，請確定已選取 [建立新方案]。
在 [位置] 清單中，將路徑指定為適合的本機工作資料夾，例如 c:\code\SiteApp\Main\ (在您設定您的開發機器時所建立的工作區中)。

確定已選取 [為方案建立目錄] 和 [加入至原始檔控制] 核取方塊。
選擇 [確定] 建立程式碼專案，您可以在 [方案總管] (鍵盤：Ctrl + Alt + L) 中檢視。
在 [方案總管]，開啟您建立或修改之方案的內容功能表，並選擇 [簽入] 以送出您的暫止變更。

將現有方案和程式碼專案放到版本控制下

若要將現有的方案加入至版本控制，請將所有方案檔案移至您的工作區，然後加入它們。

注意事項
避免使用 [將方案加入至原始檔控制] 對話方塊來上傳您的方案到版本控制。請改用下列的程序。

在 Visual Studio 中，連接到 Team 專案 (如果尚未連接的話)。
選擇 [檢視]、[其他視窗]、[原始檔控制總管]。
在 [原始檔控制總管] 中，巡覽至您方案的邏輯上層資料夾，例如 $/SiteApp/Main，其中 SiteApp 是 Team 專案的名稱。為什麼這是個好的上層資料夾？
選擇 [本機路徑] 旁邊的連結，在 [Windows 檔案總管] (Windows 8 中的 [檔案總管]) 中開啟上層資料夾。

如果連結文字是「未對應」，我要怎麼做？
將包含方案的資料夾移至上層資料夾。
在 Visual Studio 中，依序選擇 [檔案]、[開啟]、[專案/方案]，然後使用 [開啟專案] 對話方塊來開啟方案。
在 [方案總管] 中 (鍵盤：Ctrl + Alt + L) 選取方案，開啟內容功能表，然後選擇 [將方案加入至原始檔控制]。
在 [方案總管] 中，選取方案，開啟其內容功能表，然後選取 [簽入]。
在 [Team Explorer] 中，[暫止的變更] 頁面隨即出現。
是否有任何 [偵測到的變更] 出現在 [排除的變更] 區段中？
- **否：**跳至下一個步驟。
- **是：**選取 [偵測到的變更] 連結。 [升級候選變更] 對話方塊隨即出現。在這個對話方塊中列出的檔案不會由您方案中的任何程式碼專案參考。如果您的小組將需要這些檔案，請確定它們已被選取，然後選取 [升級]，將它們移入 [暫止的變更] 頁面的 [包含的變更] 區段。如需詳細資訊，請參閱將工作成果簽入小組的程式碼庫。
當您準備好，送出您的暫止變更。

將一個或多個檔案加入至版本控制

當您使用 [方案總管] 將檔案加入至您的程式碼專案時，系統會自動將其加入至版本控制。不過，您也可以加入不由您程式碼專案所參考的檔案。

提示

如果要建立自動化處理序或偏好使用命令提示字元，您可以使用Add 命令取代下列程序。

自動將一個或多個檔案加入至版本控制

如果您使用本機工作區，則 [暫止的變更] 頁面會自動偵測新的檔案。

在 Visual Studio 中，連接到 Team 專案 (如果尚未連接的話)。
選擇 [檢視]、[其他視窗]、[原始檔控制總管]。
在 [原始檔控制總管] 中，巡覽至您要將檔案或資料夾加入其中的資料夾。
選擇 [本機路徑] 旁邊的連結，在 [Windows 檔案總管] (Windows 8 中的 [檔案總管]) 中開啟目標資料夾。

將您的檔案和資料夾移入這個資料夾中。

如果連結文字是「未對應」，我要怎麼做？
在 Visual Studio 中，在 Team Explorer 中選擇 [暫止的變更]。
在 [暫止的變更] 頁面的 [排除的變更] 區段中，選取 [偵測到的變更]。
在 [升級候選變更] 對話方塊中，確定只有選取您要簽入的檔案，然後選擇 [升級]。
送出暫止的變更。

手動將檔案加入至版本控制

您也可以手動將檔案加入至版本控制。

選擇 [檢視]、[其他視窗]、[原始檔控制總管]。
在 [原始檔控制總管] 中，巡覽至您要放置檔案的資料夾。

重要

在您繼續前，請確定這個資料夾已簽入。如果您正建立此資料夾，開啟內容功能表並選取 [簽入]，簽入新資料夾後再繼續。
將資料夾或檔案從 [Windows 檔案總管] (或 [檔案總管]) 拖曳到 [原始檔控制總管] 中的資料夾。
當 [加入至原始檔控制] 對話方塊出現時，請確定您要加入的所有檔案都已選取，然後選取 [包含項目]。
選擇 [完成]。
在 [Team Explorer] 中，當 [暫止的變更] 頁面出現時，請確定您要加入的二進位檔出現在 [包含的變更] 區段。選擇 [簽入]。

運用您的程式碼未建置的協力廠商二進位檔

許多小組開發的程式碼所依賴的二進位檔，並不是由管理程式碼所在的方案所建置。通常這些二進位檔是經協力廠商授權小組使用之程式庫的一部分。

有時候這些二進位檔來自同一公司的另一個小組。例如，A 小組相依於 B 小組作業產生的二進位檔，而由於某種原因，每個小組必須使用不同的 Team 專案集合工作。因此，B 小組傳遞二進位檔給 A 小組，而由後者簽入至版本控制。

提示

如果您的開發電腦和組建伺服器可以存取網際網路，則 NuGet 可讓您的小組更輕鬆管理相依性並保持您的二進位檔更新。即使您決定使用 NuGet，您或許仍需將二進位檔案加入至版本控制，以便重現及建置程式碼歷史版本。

您應該用來儲存協力廠商二進位檔的資料夾和工作區結構，取決於您的方案依賴這些程式庫的方式。

在資料夾或分支結構中加入二進位檔

如果您將協力廠商的二進位檔放入包含方案資料夾的相同父資料夾中，則在所有方案的所有程式碼專案可以參考具有相同的相對路徑的程式庫。

例如，小組會使用這個資料夾結構：

主要父資料夾中的程式庫資料夾

每個程式碼專案可以參考使用下列相對路徑的程式庫資料夾：../../Lib

如果之後在您的專案中，您的小組必須隔離需要二進位碼檔案的不同版本的個別工作，您可以將程式庫資料夾和您的方案資料夾分支處理。

例如，第 1 版本的應用程式會利用程式庫的第 1 版。當資料存取小組的部分開發人員在處理下一個版本時，他們會利用第 2 版。但是其他小組尚未準備好升級。您可以使用分支管理這種情況。

分支結構中的程式庫資料夾

使用工作區來對應二進位檔

某些公司必須在協力廠商程式庫上管理更複雜的相依性。例如，多個 Team 專案的方案對一組通用程式庫有不同的相依性。在這種情況下，您可以將協力廠商程式庫儲存在專屬的 Team 專案中。不同 Team 專案的參與者會對應包含其所需程式庫的資料夾。

例如，FabrikamFiber 已將下列 Team 專案、分支和資料夾結構安排妥當：

儲存於專用 Team 專案中的程式庫

Raisa 在其開發電腦上設定了兩個工作區來提供兩種不同的用途，各工作區對應需要的程式庫：

程式庫中的工作區對應

自訂版本控制要忽略哪些檔案

根據預設，版本控制會忽略某些檔案類型 (例如，.dll 檔案)。因此：

當您將忽略的檔案加入至本機工作區中對應的資料夾時，這些檔案並不會出現在 Team Explorer 的 [暫止的變更] 頁面中。
在您嘗試使用新增至原始檔控制對話方塊新增忽略的檔案 (例如將檔案拖曳到原始檔控制總管) 時，這些檔案會自動出現在 [排除的項目] 索引標籤。

您可以在要套用規則的資料夾中放入名為 .tfignore 的文字檔，以設定要忽略的檔案類型。 .tfignore 檔的作用是遞迴。不過，您可以在子資料夾中建立 .tfignore 檔案，以覆寫父資料夾中 .tfignore 檔案的效果。

.tfignore 檔案規則

下列規則可套用至 .tfignore 檔案：

# 開始註解行
支援 * 和 ? 萬用字元。
除非在前面加上 \ 字元，否則檔案規格是遞迴的。
! 取消檔案規格的作用 (不忽略符合模式的檔案)

.tfignore 檔案範例

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# Ignore .txt files in this folder 
\*.txt
# Ignore .xml files in this folder and all its sub-folders
*.xml
# Ignore all files in the Temp sub-folder
\Temp
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

建立並使用 .tfignore 檔

您可以使用上述規則手動建立 .tfignore 文字檔，也可以在 [暫止的變更] 頁面偵測到變更時自動產生該文字檔。

若要自動產生 .tfignore 檔

在 [暫止的變更] 頁面的 [排除的變更] 區段中，選取 [偵測到的變更] 連結。

[升級候選變更] 對話方塊隨即出現。
選取檔案，開啟其內容功能表，並選擇 [忽略這個本機項目]、[依副檔名忽略]、[依檔名忽略] 或 [依資料夾忽略]。
選擇 [確定] 或 [取消] 以關閉 [升級候選變更] 對話方塊。
.tfignore 檔案會出現在 [暫止的變更] 頁面的 [包含的變更] 區段中。您可以開啟這個檔案並加以修改以符合您的需求。

.tfignore 檔案會自動加入為包含的暫止變更，讓您所建立的規則會套用至會取得檔案的每個小組成員。

Share via