HOW TO：封裝元件以使用 Visual Studio 內容安裝程式

發行項
08/12/2011

Visual Studio 內容安裝程式提供了一種部署巨集、增益集和程式碼片段的方式來擴充 Visual Studio。如需其他部署策略的詳細資訊，請參閱Visual Studio Extension Deployment。

若要使用 Visual Studio 內容安裝程式以便於安裝擴充功能，請將擴充功能封裝在 .vsi 檔案中，這個檔案通常稱為社群元件。 Visual Studio 內容安裝程式會自動將社群元件中的項目複製到開發人員電腦上的正確目錄，因而項目便會出現在 Visual Studio 的正確對話方塊中。

若要使用 Visual Studio 內容安裝程式安裝您的社群元件，您必須為元件建立 .vscontent 檔案。建立 .vscontent 檔案之後，就可以將元件檔案和 .vscontent 檔案壓縮成 .zip 檔案，並將副檔名 .zip 變更為 .vsi。接著，您可以使用任何想要使用的方法將 .vsi 檔案發佈給其他開發人員，例如將檔案放在網路上供人下載、以電子郵件附件的方式傳送檔案，或者將檔案張貼在網路共用區。

.Vscontent 檔案

.Vscontent 檔案使用 XML，根據 Visual Studio 內容安裝程式結構描述參考來描述您所建立並打算分享的元件。 .vscontent 檔案至少可識別元件的種類，以及該元件應搭配哪個版本的 Visual Studio 使用。撰寫了 .vscontent 檔案後，您就可以建立 .vsi 檔案，Visual Studio 內容安裝程式將會使用這個檔案將元件安裝在開發人員的電腦上。

若要建立基本的 .vscontent 檔案

在 [檔案] 功能表上，指向 [新增]，然後按一下 [檔案]。
選取 [一般] 分類中的 [XML 檔]，然後按一下 [開啟]。
使用 Visual Studio 內容安裝程式結構描述參考建立有效的 .vscontent 檔案。

注意事項

您可以在本主題的「範例」一節找到 .vscontent 檔案的 XML 範例。
將 .vscontent 檔案儲存在與其他和社群元件相關檔案所在的相同目錄中。

注意事項
您可以在本主題的「範例」一節找到 .vscontent 檔案的 XML 範例。

.VSI 檔案

Visual Studio 內容安裝程式 (.vsi) 檔案可以用來在開發人員社群中交換 Visual Studio 內容。 .vsi 檔案是一個已重新命名的 .zip 檔案，其中包含下列元件：

描述此社群元件的 XML .vscontent 檔案。
元件的檔案。

Visual Studio 內容安裝程式會使用 .vsi 檔案，將共用內容安裝到正確的位置。如需如何安裝 .vsi 檔案的詳細資訊，請參閱 HOW TO：尋找和安裝社群元件。

Visual Studio 內容安裝程式的部分功能需要其他工具或服務才能實作。

若要在 Visual Studio 內容安裝程式中顯示社群元件的發行者資訊，您必須簽署 .vsi 檔案。如需詳細資訊，請參閱密碼編譯服務。
若要在 Visual Studio 內容安裝程式中顯示使用者授權合約，您必須將這個資訊嵌入 .zip 檔中。 WinZip 可透過 [註解] 功能，支援加入內嵌的資訊。如需 WinZip 的詳細資訊，請參閱 http://www.winzip.com。如需 [註解] 功能的詳細資訊，請參閱 WinZip 說明檔。

若要建立基本 .vsi 檔案

如果尚未這麼做，請為元件建立一個有效的 .vscontent 檔案。如需詳細資訊，請參閱本主題前面的＜.VSCONTENT 檔案＞一節。
在 [Windows 檔案總管] 中，選取元件所需的檔案，包括 .vscontent 檔案。
在選取的檔案上按一下滑鼠右鍵，指向 [傳送到]，然後按一下 [壓縮的資料夾]。

選取的檔案會壓縮至單一的 .zip 檔案中。
將 .zip 檔案的副檔名重新命名為 .vsi。

範例

下列範例示範包含增益集之 .vsi 檔案中的 .vscontent 檔案。 <ContentVersion> 項目會設定為 2.0，表示此增益集只能與 Visual Studio 9.0 及 10.0 版相容。

下列檔案應該包含在此內容的 .vsi 檔案中：

本範例所示範的包含了 XML 的 .vscontent 檔案
增益集登錄檔案 MyAddin.Addin
已編譯的增益集 .dll 檔案 MyAddin.dll

增益集檔案是安裝在下列目錄中：

n:\... \My Documents\Visual Studio <版本>\Addins\

如需其他範例，請參閱 HOW TO：發行專案範本和 HOW TO：發行程式碼片段。

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

下列範例示範 .vsi 檔案的 .vscontent 檔案，其中包含了可搭配 Visual Studio versions 8.0、9.0 及 10.0 版使用的巨集專案。下列檔案應該包含在此內容的 .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>