方法: Visual Studio コンテンツ インストーラーを使用するためにコンポーネントをパッケージ化する
Visual Studio コンテンツ インストーラーを使用すると、マクロ、アドイン、およびコード スニペットを配置して Visual Studio を拡張できます。 他の配置方法の詳細については、「Visual Studio Extension Deployment」を参照してください。
Visual Studio コンテンツ インストーラーを使用して拡張機能をインストールできるようにするには、.vsi ファイル (通常、コミュニティ コンポーネントと呼ばれる) として拡張機能をパッケージ化します。 Visual Studio コンテンツ インストーラーを使用すると、コミュニティのコンポーネントのアイテムが開発者のコンピューター上の適切なディレクトリに自動的にコピーされ、Visual Studio で、適切なダイアログ ボックスに表示されます。
Visual Studio コンテンツ インストーラーを使用してコミュニティのコンポーネントをインストールするには、コンポーネントの .vscontent ファイルを作成する必要があります。 .vscontent ファイルを作成したら、コンポーネント ファイルと .vscontent ファイルを .zip ファイルに圧縮し、ファイル名の拡張子を .zip から .vsi に変更します。 これで、ファイルを Web からダウンロードできるようにしたり、ファイルを電子メールに添付して送信したり、ネットワーク共有としてファイルをポストしたりするといった方法で .vsi ファイルを他の開発者に配布できます。
.Vscontent ファイル
.Vscontent ファイルでは、Visual Studio コンテンツ インストーラーのスキーマ リファレンスに基づいた XML を使用して、共有するために作成したコンポーネントを記述します。 少なくとも、.vscontent ファイルでは、コンポーネントの種類とコンポーネントが対象とする Visual Studio のバージョンを指定します。.vscontent ファイルを作成後、開発者のコンピューターで Visual Studio コンテンツ インストーラーを使用してコンポーネントのインストールを行う .vsi ファイルを作成できます。
基本的な .vscontent ファイルを作成するには
[ファイル] メニューの [新規作成] をポイントし、[ファイル] をクリックします。
[全般] カテゴリで、[XML ファイル] を選択し、[開く] をクリックします。
Visual Studio コンテンツ インストーラーのスキーマ リファレンスを使用して .vscontent ファイルを作成します。
注意
.vscontent ファイル用のサンプル XML は、このトピックの「使用例」にあります。
.vscontent ファイルをコミュニティのコンポーネントに関連する他のファイルと同じディレクトリに保存します。
.VSI ファイル
Visual Studio コンテンツ インストーラー (.vsi) ファイルは、開発者コミュニティ内で Visual Studio コンテンツをやり取りするために使用されます。 .vsi ファイルとは、次のコンポーネントを含む .zip ファイルの名前を変更したファイルです。
コミュニティのコンポーネントが記述されている XML .vscontent ファイル。
コンポーネント用のファイル。
Visual Studio コンテンツ インストーラーは .vsi ファイルを使用し、共有コンテンツを適切な場所にインストールします。 .vsi ファイルをインストールする方法の詳細については、「方法: コミュニティ コンポーネントを検索してインストールする」を参照してください。
Visual Studio コンテンツ インストーラーの機能によっては、追加のツールまたはサービスの実装が必要になる場合があります。
コミュニティのコンポーネントの発行者情報を Visual Studio コンテンツ インストーラーに表示するには、.vsi ファイルに署名する必要があります。 詳細については、「暗号サービス」を参照してください。
ライセンス条項 (EULA: End User License Agreement) を Visual Studio コンテンツ インストーラーに表示するには、この情報を .zip ファイルに埋め込む必要があります。 WinZip では、コメント機能を使って埋め込み情報を含めることがサポートされます。 WinZip の詳細については、http://www.winzip.com を参照してください。 コメント機能の詳細については、WinZip のヘルプ ファイルを参照してください。
基本的な .vsi ファイルを作成するには
未作成の場合は、コンポーネント用の有効な .vscontent ファイルを作成します。 詳細については、このトピックで前述した「.VSCONTENT ファイル」を参照してください。
Windows エクスプローラーで、.vscontent ファイルを含むコンポーネントで必要となるファイルを選択します。
選択したファイルを右クリックし、[送る] をポイントして、[圧縮 (zip 形式) フォルダー] をクリックします。
選択したファイルが 1 つの .zip ファイルに圧縮されます。
.zip ファイルの拡張子を .vsi に変更します。
使用例
アドインを含む .vsi ファイルの .vscontent ファイルの例を次に示します。 <ContentVersion> 要素は 2.0 に設定されています。つまり、アドインは Visual Studio Version 9.0 および 10.0 とだけ互換性があります。
.vsi ファイルには、このコンテンツに関する次のファイルが含まれます。
この例で示される XML を含む .vscontent ファイル。
アドイン登録ファイル MyAddin.Addin。
コンパイル済みのアドイン .dll ファイル MyAddin.dll。
アドイン ファイルは、次のディレクトリにインストールされます。
n:\... \My Documents\Visual Studio <バージョン>\Addins\
その他の例については、「方法 : プロジェクト テンプレートを公開する」と「方法 : コード スニペットを公開する」を参照してください。
<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
<Content>
<FileName>MyAddin.Addin</FileName>
<FileName>MyAddin.dll</FileName>
<DisplayName>Example Add-in</DisplayName>
<Description>An add-in created for this example.</Description>
<FileContentType>Addin</FileContentType>
<ContentVersion>2.0</ContentVersion>
</Content>
</VSContent>
Visual Studio Version 8.0、9.0、および 10.0 で使用できるマクロ プロジェクトを含む .vsi ファイルの .vscontent ファイルの例を次に示します。 .vsi ファイルには、このコンテンツに関する次のファイルが含まれます。
この例で示される XML を含む .vscontent ファイル。
マクロ ファイル MyMacroProject.vsmacros 。
マクロ ファイルは、次のディレクトリにインストールされます。
n:\... \My Documents\Visual Studio <バージョン>\Projects\VSMacros80\
<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
<Content>
<FileName>MyMacroProject.vsmacros</FileName>
<DisplayName>My Macro Project</DisplayName>
<Description> A macro project created for this example.</Description>
<FileContentType>Macro Project</FileContentType>
<ContentVersion>1.0</ContentVersion>
</Content>
</VSContent>