次の方法で共有


方法: 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 ファイルを作成するには

  1. [ファイル] メニューの [新規作成] をポイントし、[ファイル] をクリックします。

  2. [全般] カテゴリで、[XML ファイル] を選択し、[開く] をクリックします。

  3. Visual Studio コンテンツ インストーラーのスキーマ リファレンスを使用して .vscontent ファイルを作成します。

    注意

    .vscontent ファイル用のサンプル XML は、このトピックの「使用例」にあります。

  4. .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 ファイルを作成するには

  1. 未作成の場合は、コンポーネント用の有効な .vscontent ファイルを作成します。 詳細については、このトピックで前述した「.VSCONTENT ファイル」を参照してください。

  2. Windows エクスプローラーで、.vscontent ファイルを含むコンポーネントで必要となるファイルを選択します。

  3. 選択したファイルを右クリックし、[送る] をポイントして、[圧縮 (zip 形式) フォルダー] をクリックします。

    選択したファイルが 1 つの .zip ファイルに圧縮されます。

  4. .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>

参照

処理手順

方法 : プロジェクト テンプレートを公開する

方法 : コード スニペットを公開する

その他の技術情報

Interacting with Other Developers