プラットフォーム間のコマンドラインクライアントビギナーズガイド

[アーティクル]
02/21/2013

共通の UNIX プラットフォームでアプリケーションを開発する場合は、プラットフォーム間のコマンドラインクライアントを使用して Team Foundation Server にアクセスし、バージョン管理操作を実行することができます。

次にコマンドラインクライアントの使用を開始する方法について説明します。

プラットフォーム間のコマンドラインクライアントのインストール
1. クライアントが含まれているアーカイブ (.zip ファイル) を解凍します。
2. 解凍されたファイルがアーカイブされているフォルダーを含めるように、シェルまたはシステムパスを構成します。Java ランタイム環境や Java 開発キットがパスに含まれていること、または JAVA_HOME 環境変数を設定していることを確認します。
3. クライアントが機能していることを確認するには、コマンドプロンプトで、「tf」と入力し、Enter キーを押します。
  
  クライアントが正しくインストールされると、Team Explorer Everywhere で始まる出力が表示されます。
  
  コマンドの詳細については、「tf help Command」と入力します。ここで Command は情報が必要なコマンドの名前です。たとえば、「tf help checkin」と入力します。
プラットフォーム間のコマンドラインクライアントのマイクロソフトソフトウェアライセンス条項を表示して、同意します。バージョン管理操作を実行する前に、EULA コマンドを実行する必要があります。
```
tf eula
```
マイクロソフトソフトウェアライセンス条項が表示されます。ライセンス条項に同意するには「yes」または「y」と入力する必要があります。
workspace コマンドを実行してローカルワークスペースを作成します。ワークスペースにはローカルディスク上のクライアント側フォルダーが含まれ、このクライアント側フォルダーは Team Foundation Server 上のバージョン管理されているフォルダーにマップされます。

次の例では、TFS コレクションの 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 のコマンドライン認証」を参照してください。

これで、コマンドラインクライアントを使用した基本的なバージョン管理操作が完了しました。これ以外に必要になる可能性がある追加の操作を次に示します。

ファイルまたはフォルダーの名前やパスを変更するには、rename コマンドを実行します。

次の例では、test1.txt という名前を NewTest.txt に変更します。
```
tf rename test1.txt NewTest.txt
```
ファイルまたはフォルダーを Team Foundation Server から削除し、それらをディスクからも削除するには delete コマンドを実行します。このコマンドの結果は、チェックイン操作を実行するまでは他のワークスペースに表示されません。次に例を示します。
```
tf delete Test-new.txt
```
[!メモ]

ワークスペース内の項目を削除しても変更をチェックインしなかった場合、undo コマンドを使用して項目をワークスペースに復元し、保留中の変更の一覧から "削除" を消去できます。

別の保留中の変更が存在する項目は削除できません。たとえば、チェックアウトされたファイルは削除できません。そのような項目を削除するには、現在の保留中の変更を元に戻す必要があります。