MSI- und VSIX-Bereitstellung einer DSL

Sie können eine domänenspezifische Sprache auf Ihrem eigenen Computer oder auf anderen Computern installieren. Visual Studio muss bereits auf dem Zielcomputer installiert sein.

Auswählen zwischen VSIX- und MSI-Bereitstellung

Es gibt zwei Methoden zum Bereitstellen einer domänenspezifischen Sprache:

Installieren und Deinstallieren einer DSL mithilfe von VSX

Wenn Ihre DSL mit dieser Methode installiert wird, kann der Benutzer eine DSL-Datei in Visual Studio öffnen, aber die Datei kann nicht im Windows-Explorer geöffnet werden.

So installieren Sie eine DSL mithilfe von VSX

1. Suchen Sie die VSIX-Datei, die von Ihrem DSL-Paketprojekt erstellt wurde:

   1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das DslPackage-Projekt, und klicken Sie dann auf Ordner im Datei-Explorer öffnen.

   2. Suchen Sie die Datei bin\*\IhrProjekt.DslPackage.vsix

2. Kopieren Sie die VSIX-Datei auf den Zielcomputer, auf dem Sie die DSL installieren möchten. Dies kann Ihr eigener Computer oder ein anderer Computer sein.

   • Der Zielcomputer muss über eine der Editionen von Visual Studio verfügen, die DSLs zur Laufzeit unterstützt. Weitere Informationen finden Sie unter Unterstützte Visual Studio-Editionen für das SDK für Visualisierung und Modellierung.

   • Der Zielcomputer muss über eine der Editionen von Visual Studio verfügen, die in DslPackage\source.extensions.manifest angegeben werden.

3. Doppelklicken Sie auf dem Zielcomputer auf die VSIX-Datei.

   Installer für Visual Studio-Erweiterungen wird geöffnet, und die Erweiterung wird installiert.

4. Starten Sie Visual Studio.

5. Um die DSL zu testen, verwenden Sie Visual Studio, um eine neue Datei mit der Erweiterung zu erstellen, die Sie für Ihre DSL definiert haben.

So deinstallieren Sie eine DSL, die mithilfe von VSX installiert wurde

1. Wählen Sie im Menü ToolsErweiterungen und Updatesaus.

2. Erweitern Sie Installierte Erweiterungen.

3. Wählen Sie die Erweiterung aus, in der die DSL definiert ist, und klicken Sie dann auf Deinstallieren.

   In seltenen Fällen kann es vorkommen, dass eine fehlerhafte Erweiterung nicht geladen und ein Bericht im Fehlerfenster erstellt wird, aber im Erweiterungs-Manager keine Informationen angezeigt werden. Sie haben die Möglichkeit, die Erweiterung zu entfernen, indem Sie die Datei aus dem folgenden Ordner löschen:

   LocalAppData \Microsoft\VisualStudio\10.0\Extensions

Bereitstellen einer DSL in einer MSI-Datei

Indem Sie eine MSI-Datei (Windows Installer-Datei) für Ihre DSL definieren, können Sie Benutzern das Öffnen von DSL-Dateien mit Windows Explorer ermöglichen. Sie können Ihrer Erweiterung auch ein Symbol und eine kurze Beschreibung zuordnen. Darüber hinaus kann die MSI-Datei eine XSD installieren, die zum Überprüfen von DSL-Dateien verwendet werden kann. Wenn Sie möchten, können Sie der MSI-Datei andere Komponenten hinzufügen, die gleichzeitig installiert werden.

Weitere Informationen zu MSI-Dateien und anderen Bereitstellungsoptionen finden Sie unter Bereitstellen von Anwendungen, Diensten und Komponenten.

Um eine MSI-Datei zu erstellen, fügen Sie ihrer Visual Studio-Projektmappe ein Setupprojekt hinzu. Die einfachste Methode zum Erstellen eines Setupprojekts besteht darin, die CreateMsiSetupProject.tt-Vorlage zu verwenden, die Sie von der VMSDK-Website herunterladen können.

So stellen Sie eine DSL in einer MSI-Datei bereit

1. Legen Sie InstalledByMsi im Erweiterungsmanifest fest. Dadurch wird verhindert, dass VSX installiert und deinstalliert werden kann, ausgenommen durch die MSI-Datei. Dies ist wichtig, wenn Sie andere Komponenten in die MSI-Datei einschließen.

   1. Öffnen Sie „DslPackage\source.extension.tt“.

   2. Fügen Sie die folgende Zeile vor <SupportedProducts> ein.

      <InstalledByMsi>true</InstalledByMsi>
      

2. Erstellen oder bearbeiten Sie ein Symbol, das Ihre DSL im Windows-Explorer darstellt. Bearbeiten Sie beispielsweise DslPackage\Resources\File.ico.

3. Stellen Sie sicher, dass die folgenden Attribute Ihrer DSL richtig sind:

   • Klicken Sie im DSL-Explorer auf den Stammknoten, und überprüfen Sie im Eigenschaftenfenster Folgendes:

     • BESCHREIBUNG

     • Version

   • Klicken Sie auf den Knoten Editor, und klicken Sie im Eigenschaftenfenster auf Symbol. Legen Sie den Wert fest, um auf eine Symboldatei in DslPackage\Resources zu verweisen, z. B. auf File.ico.

   • Öffnen Sie im Menü Erstellen den Konfigurations-Manager, und wählen Sie die Konfiguration aus, die Sie erstellen möchten, z. B. Release oder Debug.

4. Navigieren Sie zur Startseite des SDK fürVisualisierungs und Modellierung, und laden Sie auf der Registerkarte Downloads die Datei CreateMsiSetupProject.tt herunter.

5. Fügen Sie Ihrem Dsl-Projekt CreateMsiSetupProject.tt hinzu.

   Visual Studio erstellt eine Datei namens CreateMsiSetupProject.vdproj.

6. Kopieren Sie im Windows-Explorer „Dsl\*.vdproj“ in einen neuen Ordner namens „Setup“.

   (Wenn Sie möchten, können Sie jetzt „CreateMsiSetupProject.tt“ aus Ihrem Dsl-Projekt ausschließen.)

7. Fügen Sie Setup\*.vdproj im Projektmappen-Explorer als vorhandenes Projekt hinzu.

8. Klicken Sie im Menü Projekt auf Projektabhängigkeiten.

   Wählen Sie im Dialogfeld Projektabhängigkeiten das Setupprojekt aus.

   Aktivieren Sie das Kontrollkästchen neben DslPackage.

9. Generieren Sie die Projektmappe neu.

10. Suchen Sie im Windows-Explorer nach der erstellten MSI-Datei in Ihrem Setupprojekt.

    Kopieren Sie die MSI-Datei auf einen Computer, auf dem Sie Ihre DSL installieren möchten. Doppelklicken Sie auf die MSI-Datei. Das Installationsprogramm wird ausgeführt.

11. Erstellen Sie auf dem Zielcomputer eine neue Datei mit der Dateierweiterung Ihrer DSL. Verifizieren Sie Folgendes:

    • In der Listenansicht von Windows-Explorer wird die Datei mit dem von Ihnen definierten Symbol und der Beschreibung angezeigt.

    • Wenn Sie auf die Datei doppelklicken, wird Visual Studio gestartet und die DSL-Datei in Ihrem DSL-Editor geöffnet.

    Wenn Sie möchten, können Sie das Setupprojekt manuell erstellen, anstatt die Textvorlage zu verwenden. Eine exemplarische Vorgehensweise, die dieses Verfahren erläutert, finden Sie in Kapitel 5 des Labs für das SDK für Visualisierung und Modellierung.

So deinstallieren Sie eine DSL, die mithilfe einer MSI-Datei installiert wurde

1. Öffnen Sie in Windows die Systemsteuerung Programme und Features.

2. Deinstallieren Sie die DSL.

3. Starten Sie Visual Studio neu.