Bereitstellen einer Ebenenmodellierungserweiterung

Benutzer von Visual Studio 2010 Premium und Visual Studio 2010 Ultimate können Ebenenmodellierungserweiterungen installieren, die Sie mit Visual Studio 2010 Ultimate und Visual Studio 2010 Visualization and Modeling Feature Pack oder Visual Studio 2010 Feature Pack 2 erstellen. Sie müssen die Erweiterung einrichten, damit das Installationsprogramm nach den richtigen Anforderungen sucht. Weitere Informationen finden Sie unter Visual Studio Feature Packs.

Festlegen der Bereitstellungsoptionen

Damit die Erweiterung auf anderen Computern installiert werden kann, müssen Sie die folgenden Optionen in source.vsix.manifest im VSIX-Projekt festlegen.

Tipp

Wenn Sie das Projekt mit einer Ebenenerweiterungsprojektvorlage erstellt haben, sollten diese Optionen bereits festgelegt sein. Wenn Sie ein separates VSIX-Projekt erstellt haben, müssen Sie die folgenden Änderungen vornehmen.

  • Supported VS Editions (Unterstützte VS-Editionen) sollte auf Folgendes festgelegt werden: Visual Studio 2010 Premium und/oder Visual Studio 2010 Ultimate

  • VSIX References (VSIX-Verweise) muss die Visual Studio 2010 Visualization and Modeling Feature Pack Runtime einschließen, die in Visualization and Modeling Feature Pack und Feature Pack 2 enthalten ist.

Die Liste der VSIX-Verweise veranlasst das Installationsprogramm zu einer Überprüfung, ob die von Ihnen angegebenen Erweiterungen auf dem Zielcomputer installiert sind. Es gibt zwei alternative Möglichkeiten, den Verweis einzuschließen:

  • Als Verweislink. Wenn ein Benutzer versucht, die Erweiterung zu installieren, überprüft das Installationsprogramm, ob die Laufzeit bereits installiert ist. Wenn sie nicht installiert ist, wird dem Benutzer eine Meldung mit einem Link zur Installationsseite für die Laufzeit angezeigt.

  • Als Nutzlast. Wenn ein Benutzer die Erweiterung installiert, wird vom Installationsprogramm zuerst die Laufzeit installiert, sofern sie noch nicht installiert ist.

  1. Klicken Sie in source.vsix.manifest auf Add Reference (Verweis hinzufügen).

  2. Klicken Sie auf Select Installed Extension (Installierte Erweiterung auswählen).

  3. Wählen Sie die Laufzeit für dieses Feature Pack aus.

So schließen Sie die Laufzeit als Nutzlast in das Erweiterungsinstallationsprogramm ein

  1. Klicken Sie in source.vsix.manifest auf Add Reference (Verweis hinzufügen).

  2. Klicken Sie auf Add Payload to VSIX (Nutzlast zu VSIX hinzufügen).

  3. Klicken Sie auf die Schaltfläche mit dem Auslassungszeichen [...]. Wechseln Sie im Dialogfeld zum folgenden Speicherort:

    • Wenn Sie Visual Studio 2010 Visualization and Modeling Feature Pack installiert haben:

      %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

      Tipp

      %LocalAppData% ist in der Regel DriveName:\Users\UserName\AppData\Local. Verwenden Sie unter Windows XP oder Windows 2003 %APPDATA% statt %LocalAppData%.

      – oder –

    • Wenn Sie Visual Studio 2010 Feature Pack 2 installiert haben:

      …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

Installieren der Erweiterung

Die Erweiterung wird zu einer VSIX-Datei kompiliert, die Sie auf anderen Computern installieren können. Sie können sie auch auf dem Entwicklungscomputer installieren, um die Erweiterung in der Hauptinstanz von Visual Studio verfügbar zu machen.

So installieren Sie die Erweiterung

  1. Öffnen Sie im Projekt, das source.vsix.manifest enthält, bin\* in Windows-Explorer.

  2. Kopieren Sie die *.vsix-Datei auf den Computer, auf dem Sie die Erweiterung installieren möchten.

  3. Doppelklicken Sie auf dem Zielcomputer auf die VSIX-Datei in Windows-Explorer.

    Das VSIX-Installationsprogramm wird geöffnet.

So deinstallieren Sie die Erweiterung

  1. Klicken Sie in Visual Studio im Menü Extras auf Erweiterungs-Manager.

  2. Klicken Sie auf den Namen der Erweiterung, und klicken Sie dann auf Deinstallieren.

Installieren einer Erweiterung auf einem Team Foundation Build-Server

Auf Team Foundation Build-Servern ist Visual Studio normalerweise nicht installiert, deshalb können Sie das VSIX nicht installieren, indem Sie darauf doppelklicken. Die Installation von Team Foundation Build schließt einige Komponenten ein, die das Ausführen einer VSIX-Erweiterung ermöglichen, Sie müssen die Erweiterung jedoch manuell installieren.

So installieren Sie die Ebenenerweiterung auf einem Team Foundation Build-Server

  1. Kopieren Sie die folgenden VSIX-Dateien vom Entwicklungscomputer auf den Computer mit Team Foundation Build:

    • Wenn Sie Visual Studio 2010 Visualization and Modeling Feature Pack installiert haben:

      Kopieren Sie die Feature Pack-Laufzeit vom folgenden Speicherort: %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

      Tipp

      %LocalAppData% ist in der Regel DriveName:\Users\UserName\AppData\Local. Verwenden Sie unter Windows XP oder Windows 2003 %APPDATA% statt %LocalAppData%.

      – oder –

      Wenn Sie Visual Studio 2010 Feature Pack 2 installiert haben:

      Kopieren Sie die Feature Pack-Laufzeit vom folgenden Speicherort: …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

    • Das kompilierte VSIX vom folgenden Speicherort:

      IhrVSIXProjektName\bin\*\*.vsix

  2. Fügen Sie die VSIX-Dateien auf dem Computer mit Team Foundation Build in einem der folgenden Speicherorte ein:

    • So führen Sie die Installation für alle Benutzer und Dienste aus:

      %ProgramFiles%\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft

    • So führen Sie die Installation nur für den Netzwerkdienst aus, der Team Foundation Build ausführt:

      %WinDir%\ServiceProfiles\NetworkService\AppData\Local\Microsoft\VisualStudio\10.0\Extensions\Microsoft

    • Wenn Sie Team Foundation Build zur Ausführung im interaktiven Modus für einen bestimmten Benutzer konfiguriert haben, können Sie die Installation nur für diesen Benutzer ausführen:

      %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft

      Tipp

      %LocalAppData% ist in der Regel DriveName:\Users\UserName\AppData\Local. Verwenden Sie unter Windows XP oder Windows 2003 %APPDATA% statt %LocalAppData%.

  3. Erweitern Sie jede VSIX-Datei in einen Ordner am gleichen Speicherort:

    1. Ändern Sie den Dateinamen von .vsix in .zip.

    2. Extrahieren Sie den Inhalt der ZIP-Datei in einen Ordner.

    3. Löschen Sie die ZIP-Datei.

  4. Starten Sie Team Foundation Build neu.

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Juni 2010

Klarstellung zu AppData und LocalAppData

Kundenfeedback.

Dezember 2010

Aktualisiert für Visual Studio 2010 Feature Pack 2.

Informationsergänzung.