跨平台命令列用戶端 - 初級開發人員指南

如果您再在一般 UNIX 平台上開發應用程式，您可以使用跨平台命令列用戶端，存取 Team Foundation Server 並執行版本控制作業。

以下說明如何開始使用命令列用戶端：

安裝跨平台命令列用戶端：
1. 解壓縮包含用戶端的封存 (.zip 檔)。
2. 設定 Shell 或系統路徑以包含封存解壓縮檔案的資料夾。確定您的 Java Runtime Environment 或 Java Development Kit 在路徑中，或是您已設定 JAVA_HOME 環境變數。
3. 若要確認用戶端可運作，請在命令提示字元中輸入 tf，然後選擇 Enter 鍵。
  
  如果用戶端安裝正確，以 Team Explorer Everywhere 開頭的輸出就會出現。
  
  如需任何命令的詳細資訊，請輸入 tf help Command，其中 Command 是所需資訊的命令名稱。例如，輸入 tf help checkin。
檢視和接受跨平台命令列用戶端的 Microsoft 軟體授權條款。您必須先執行下列 EULA 命令，才能執行任何版本控制作業。
```
tf eula
```
Microsoft 軟體授權條款隨即顯示。您必須輸入「yes」或「y」表示接受條款。

執行 workspace 命令，建立本機工作區。工作區中包含本機磁碟上的用戶端資料夾，這些用戶端資料夾與 Team Foundation Server 上受到版本控制的資料夾相對應。

下列範例會在 TFS 集合「http://myserver:8080/tfs/DefaultCollection」建立名為 Beta1 的新工作區。

tf workspace -new Beta1 -collection:http://myserver:8080/tfs/DefaultCollection

注意事項
當您建立或編輯工作區時，可以指定其位置為本機或伺服器。預設設定為本機。即使在您離線時，也能讓您快速執行核心版本控制作業。

執行 workfold 命令，建立本機資料夾和伺服器資料夾之間的工作區對應。根據預設，工作區對應會以遞迴方式套用。將本機資料夾對應到伺服器資料夾時，系統會以隱含方式，在所有目前和未來的子資料夾之間建立對應。

下列範例會將本 Beta1 工作區的資料夾/Users/Example 對應到 Team Foundation 版本控制伺服器資料夾 $/ScrumProject/JavaSample。
```
tf workfold -map $/ScrumProject/JavaSample -workspace:Beta1 /Users/Example
```
將目錄變更為您已對應之本機工作資料夾的路徑。例如：
```
cd /Users/Example
```
執行 get 命令從 Team Foundation Server 擷取檔案的複本，或是同步處理工作區與伺服器上最近簽入的變更。例如：
```
tf get
```
編輯檔案在本機工作區中，變更會被標記為暫止的變更。
建立新檔案，並讓它可執行。例如：
```
$ chmod u+x HelloWorld.sh
```
執行 add 命令，將新的檔案加入至 Team Foundation Server。例如：
```
tf add Helloworld.sh
```
執行 status 命令，檢視工作區內項目之暫存變更的相關資訊。
```
tf status 
```
執行 checkin 命令，將目前工作區中的暫止變更簽入至 Team Foundation Server。

下列範例將目前工作區中與第 11 個工作項目關聯的暫止變更與指定註解送出至 Team Foundation 版本控制伺服器以建立新的變更集。
```
tf checkin -comment:"Fixed a bug” -associate:11 
```

注意事項
如需命令語法和連接到 Team Foundation Server 的詳細資訊，請參閱命令列語法 (Team Explorer Everywhere)和Team Explorer Everywhere 命令列驗證。

現在您已使用命令列用戶端，完成大部分基本的版本控制作業。以下是一些您可能還需要進行的其他作業：

執行 delete 命令，將檔案或資料夾從 Team Foundation Server 移除，並從磁碟中刪除。在執行簽入作業後，這個命令的結果才會顯示在其他工作區中。例如：

tf delete Test-new.txt

注意事項
如果已從工作區中刪除某項目，但尚未簽入該項變更，可以將項目還原到工作區，然後使用 undo 命令從暫止變更清單移除該項刪除。您無法刪除有其他暫止變更存在的項目。例如，簽出的檔案就無法刪除。若要刪除此類項目，必須復原目前的暫止變更。

如果已從工作區中刪除某項目，但尚未簽入該項變更，可以將項目還原到工作區，然後使用 undo 命令從暫止變更清單移除該項刪除。

您無法刪除有其他暫止變更存在的項目。例如，簽出的檔案就無法刪除。若要刪除此類項目，必須復原目前的暫止變更。

注意事項
如果您不要逐行輸入命令，您可以撰寫指令碼來自動化上述所有工作。請參閱在 Team Foundation Server 的跨平台命令列用戶端中撰寫指令碼。

請參閱