Visual Studio for Mac は Team Foundation バージョン管理をサポートしていますか?

[アーティクル]
07/20/2022

適用対象:Visual Studio for Mac Visual Studio

重要

Team Foundation バージョン管理ソリューションは、macOS でサポートされなくなりました。ここでお勧めすることは、もう機能しなくなった可能性があります。

Visual Studio for Mac の代替バージョンコントロールオプション

macOS 上での最善のバージョンコントロールエクスペリエンスのためには、Team Foundation バージョン管理 (TFVC) ではなく Git を使用することをお勧めします。

Visual Studio for Mac では Git がサポートされており、Team Foundation Server (TFS)/Azure DevOps にホストされているリポジトリでの既定のオプションです。 TFS/Azure DevOps での Git の使用の詳細については、「Setting up a Git Repository」(Git リポジトリのセットアップ) のガイドをご覧ください。

TFVC でサポートされていない回避策

Visual Studio for Mac は TFVC を正式にサポートしていませんが、このガイドの残りの部分では、macOS で TFVC を使用するための回避策について説明します。現在、バージョン管理に TFVC を使用している場合は、TFVC にホストされているソースコードにアクセスするための解決策を使用できます。

Team Explorer Everywhere Command Line Client (TEE-CLC) を使用して接続する

重要

Team Explorer Everywhere の README にあるように、このプロジェクトは管理されなくなりました。

macOS ターミナルを快適に使用している場合、Team Explorer Everywhere Command Line Client (TEE-CLC) では、TFVC 内のソースに接続するためのサポートされた方法を提供しています。

以下の手順に従って、TFVC への接続を設定し変更をコミットできます。

TEE-CLC のセットアップ

TEE CLC のセットアップを行うには、2 つの方法があります。

Homebrew を使用してクライアントをインストールする
クライアントをダウンロードして手動でインストールする

最も簡単なソリューションは、macOS 用のパッケージマネージャーである HomeBrew を使用することです。この方法を使用してインストールするには、次の手順を実行します。

macOS ターミナルのアプリケーションを起動します。
ターミナルと Homebrew ホームページ上の手順を使用して、Homebrew をインストールします。
Homebrew がインストールされたら、ご利用のターミナルから次のコマンドを実行します。brew install tee-clc

TEE-CLC を手動でセットアップするには:

Team Explorer Everywhere GitHub リポジトリのリリースページからの最新バージョンをダウンロードします (例えば、この記事の執筆時点では tee-clc-14.134.0.zip)。
.zip の内容をディスク上のフォルダーに抽出します。
macOS ターミナルのアプリを開き、cd コマンドを使用して前の手順で使用したフォルダーに切り替えます。
フォルダー内から、コマンド ./tf を実行して、コマンドラインクライアントが実行できることをテストします。Java またはその他の依存関係のインストールを求められる場合があります。

TEE-CLC がインストールされたら、コマンド tf eula を実行して、クライアント用のライセンス契約を表示して同意します。

最後に、お使いの TFS/Azure DevOps 環境による認証を行うために、サーバー上に個人用アクセストークンを作成する必要があります。詳しくは、「Authenticating with personal access tokens (個人用アクセストークンによる認証)」をご覧ください。 TFVC によって使用される個人用アクセストークンを作成する場合は、トークンの構成時に必ずフルアクセスを指定してください。

TEE CLC を使用してリポジトリに接続する

ソースコードに接続するには、最初に、tf workspace コマンドを使用してワークスペースを作成する必要があります。たとえば、次のコマンドでは、Azure DevOps Services にある "MyOrganization" という組織に接続します。

export TF_AUTO_SAVE_CREDENTIALS=1
tf workspace -new MyWorkspace -collection:https://dev.azure.com/MyOrganization

TF_AUTO_SAVE_CREDENTIALS 環境設定は、入力を複数回求められることがないように、資格情報を保存するために使用されます。ユーザー名の入力を求められたら、前のセクションで作成した個人用アクセストークンを使用し、空白のパスワードを使用します。

ローカルフォルダーへのソースファイルのマッピングを作成するには、tf workfold コマンドを使用します。次の例では、"MyRepository" TFVC プロジェクトから "WebApp.Services" というフォルダーをマップし、local ~/Projects/ フォルダー (つまり、現在のユーザーのホームフォルダーにある "Projects" フォルダー) にコピーされるように設定します。

tf workfold -map $/MyRepository/WebApp.Services -workspace:MyWorkspace ~/Projects/

最後に、次のコマンドを使用してサーバーからソースファイルを取得し、ローカルにコピーします。

tf get

TEE CLC を使用して変更をコミットする

Visual Studio for Mac 内のファイルに変更を加えた後は、ターミナルに戻って編集内容をチェックインできます。 tf add コマンドは、チェックインされる保留中の変更一覧にファイルを追加するために使用され、tf checkin コマンドはサーバーへの実際のチェックインを実行します。 checkin コマンドには、コメントを追加したり、関連する作業項目を結び付けたりするためのパラメーターが含まれます。次のコードスニペットでは、WebApp.Services フォルダーにあるすべてのファイルが、再帰的にチェックインに追加されます。次に、コードはコメントと共にチェックインされ、ID "42" の作業項目と結び付けられます。

cd WebApp.Services
tf add * /recursive
tf checkin -comment:"Replaced 'Northwand' typos with the correct word Northwind" -associate:42

ここで説明したコマンドなどについて詳細を確認するには、ターミナルから次のコマンドを使用できます。

tf help