DSL 的 MSI 和 VSIX 部署

您可以在自己的電腦上或其他電腦上安裝特定領域語言。 Visual Studio 必須已安裝在目標電腦上。

在 VSIX 和 MSI 部署之間選擇

部署特定領域語言的方法有兩種：

方法	優點
VSX (Visual Studio 延伸模組)	非常容易部署：從 DslPackage 專案複製並執行 .vsix 檔案。 如需詳細資訊，請參閱使用 VSX 安裝和解除安裝 DSL。
MSI (安裝程式檔案)	- 允許使用者按兩下 DSL 檔案來開啟 Visual Studio。 - 將圖示與目標電腦中的 DSL 檔案類型產生關聯。 - 將 XSD (XML 結構描述) 與 DSL 檔案類型產生關聯。 這可避免在檔案載入 Visual Studio 時發出警告。 您必須將安裝專案新增至您的解決方案，才能建立 MSI。 如需詳細資訊，請參閱使用 MSI 檔案部署 DSL。

使用 VSX 安裝和解除安裝 DSL

當您的 DSL 是使用此方法安裝時，使用者可以從 Visual Studio 內開啟 DSL 檔案，但是無法從 Windows 檔案總管開啟檔案。

使用 VSX 安裝 DSL

1. 找出 DSL 套件專案所建置的 .vsix 檔案：

   1. 在 [方案總管] 中，以滑鼠右鍵按一下 [DslPackage] 專案，然後按一下 [在檔案總管中開啟資料夾]。

   2. 找到檔案 bin\*\YourProject.DslPackage.vsix

2. 將 .vsix 檔案複製到要安裝 DSL 的目標電腦。 這可以是您自己的電腦或其他電腦。

   • 目標電腦必須有其中一個在執行階段支援 DSL 的 Visual Studio 版本。 如需詳細資訊，請參閱支援 Visualization & Modeling SDK 的 Visual Studio 版本。

   • 目標電腦必須有其中一個在 DslPackage\source.extensions.manifest 中指定的 Visual Studio 版本。

3. 在目標電腦上，按兩下 .vsix 檔案。

   [Visual Studio 擴充功能安裝程式] 隨即開啟並安裝擴充功能。

4. 啟動或重新啟動 Visual Studio。

5. 若要測試 DSL，請使用 Visual Studio 建立新檔案，具有您為 DSL 定義的副檔名。

解除安裝使用 VSX 安裝的 DSL

1. 在 [工具] 功能表中選擇 [擴充功能和更新] 。

2. 展開 [已安裝的擴充功能] 。

3. 選取定義 DSL 的延伸模組，然後按一下 [解除安裝]。

   在很少見的情況下，錯誤的擴充功能會無法載入，並且在錯誤視窗中建立報表，但不會顯示在擴充管理員中。 在此情況下，您可以藉由從下列位置刪除檔案來移除擴充功能：

   LocalAppData \Microsoft\VisualStudio\10.0\Extensions

在 MSI 中部署 DSL

藉由定義 DSL 的 MSI (Windows Installer) 檔案，您可以允許使用者從 Windows 檔案總管開啟 DSL 檔案。 您也可以將圖示和簡短描述與您的副檔名產生關聯。 此外，MSI 可以安裝可用來驗證 DSL 檔案的 XSD。 如果您想要的話，可以將其他元件新增至同時安裝的 MSI。

如需 MSI 檔案和其他部署選項的詳細資訊，請參閱部署應用程式、服務和元件。

若要建置 MSI，請將安裝專案新增至 Visual Studio 解決方案。 建立安裝專案最簡單的方法是使用 CreateMsiSetupProject.tt 範本，您可以從 VMSDK 網站下載。

在 MSI 中部署 DSL

1. 在延伸模組資訊清單中設定 InstalledByMsi。 這可防止 VSX 安裝和解除安裝，但是 MSI 除外。 如果您將會在 MSI 中包含其他元件，這很重要。

   1. 開啟 DslPackage\source.extension.tt

   2. 在 <SupportedProducts> 前面插入下列程式碼行：

      <InstalledByMsi>true</InstalledByMsi>
      

2. 建立或編輯在 Windows 檔案總管中代表 DSL 的圖示。 例如，編輯 DslPackage\Resources\File.ico

3. 請確定 DSL 的下列屬性正確：

   • 在 [DSL 總管] 中，按一下根節點，然後在 [屬性] 視窗中檢閱：

     • 描述

     • 版本

   • 按一下 [編輯器] 節點，然後在 [屬性] 視窗中，按一下 [圖示]。 設定值以參考 DslPackage\Resources 中的圖示檔案，例如 File.ico

   • 在 [建置] 功能表上，開啟 [Configuration Manager]，然後選取您想要建置的組態，例如 [發行] 或 [偵錯]。

4. 移至 Visualization and Modeling SDK 首頁，然後從 [下載] 索引標籤下載 CreateMsiSetupProject.tt。

5. 將 CreateMsiSetupProject.tt 新增至您的 DSL 專案。

   Visual Studio 會建立名為 CreateMsiSetupProject.vdproj 的檔案。

6. 在 Windows 檔案總管中，將 Dsl\*.vdproj 複製到名為 Setup 的新資料夾。

   (如果您想要的話，現在可以從 DSL 專案排除 CreateMsiSetupProject.tt。)

7. 在 [方案總管] 中，將 Setup\*.vdproj 新增為現有專案。

8. 在 [專案] 功能表上，按一下 [專案相依性]。

   在 [專案相依性] 對話方塊中，選取安裝專案。

   選取 DslPackage 旁的方塊。

9. 重建方案。

10. 在 Windows 檔案總管中，找到安裝專案中的內建 MSI 檔案。

    將 MSI 檔案複製到您要安裝 DSL 的電腦。 按兩下 MSI 檔案。 安裝程式隨即執行。

11. 在目標電腦中，建立具有 DSL 副檔名的新檔案。 請確認：

    • 在 Windows 檔案總管清單檢視中，檔案出現，其中包含您定義的圖示和描述。

    • 當您按兩下檔案時，Visual Studio 會啟動，然後在 DSL 編輯器中開啟 DSL 檔案。

    如果您想要的話，可以手動建立安裝專案，而不是使用文字範本。 如需包含此程序的逐步解說，請參閱 Visualization and Modeling SDK 實驗室的第 5 章。

解除安裝從 MSI 安裝的 DSL

1. 在 Windows 中，開啟 [程式和功能] 控制台。

2. 解除安裝 DSL。

3. 重新啟動 Visual Studio。