Freigeben über


Gewusst wie: Migrieren einer domänenspezifischen Sprache zu einer neuen Version

Sie können Projekte, die domänenspezifische Sprache definieren und verwenden, auf Visual Studio 2010 von der Version von Domänenspezifische Sprachtools migrieren, die mit Visual Studio 2008 verteilt wurde. 

Ein Migrationstool wird als Teil von Visual Studio SDK bereitgestellt.Das Tool konvertiert Visual Studio-Projekte und Projektmappen, die DSL-Tools verwenden oder definieren.

Sie müssen das Migrations-Tool explizit ausführen: Es wird nicht automatisch gestartet, wenn Sie eine Projektmappe in Visual Studio öffnen.Das Dokument für Tools und ausführliche Anweisungen kann unter diesem Pfad gefunden wurden:

%Program Files%\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe

Bevor Sie Ihre DSL-Projekte migrieren

Das Migrationstool ändert Visual Studio-Projektdateien (.csproj und Projektmappendateien (.sln).

So bereiten Sie Projekte für die Migration vor.

  • Stellen Sie sicher, dass die .csproj- und .sln-Dateien geschrieben werden können.Wenn sie in die Quellcodeverwaltung einbezogen sind, stellen Sie sicher, dass sie ausgecheckt werden.

  • Erstellen Sie eine Kopie von Ordnern, die Sie migrieren möchten.

Migration einer Auflistung von Projekten

So migrieren Sie DSL-Projekte und -Projektmappen nach Visual Studio 2010

  1. Starten Sie das DSL-Migrations-Tool.

    • Sie können auf das Tool in Windows Explorer (oder im Datei-Explorer) doppelklicken, oder erstellen Sie das Tool von einer Eingabeaufforderung an.Das Tool ist an diesem Speicherort zu finden:

      %ProgramFiles%\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\DSLTools\DslProjectsMigrationTool.exe

  2. Wählen Sie einen Ordner aus, der Projekte und Projektmappen enthält, die Sie konvertieren möchten.

    • Geben Sie den Pfad im Feld am oberen Rand des Tools ein, oder klicken Sie auf Durchsuchen.

    Das Migrationstool zeigt die Projekte an, die DSLs definieren oder verwenden.Die Struktur enthält jedes Projekt, das die Microsoft.VisualStudio.Modeling.Sdk oder TextTemplating-Assemblys verwendet.

  3. Überprüfen Sie die Projektstruktur, und deaktivieren Sie Projekte, die Sie nicht konvertieren möchten.

    • Wählen Sie ein Projekt oder eine Projektmappe aus, um eine Liste von Änderungen anzuzeigen, die das Tool vornimmt.

      HinweisHinweis

      Die Kontrollkästchen neben den Ordnernamen haben keine Auswirkungen.Sie müssen die Ordner erweitern, um die Projekte und Projektmappen zu überprüfen.

  4. Konvertiert das Projekt

    1. Klicken Sie auf Konvertieren.

      Bevor jede Projektdatei konvertiert wird, wird eine Kopie von project**.csproj** als project**.vs2008.csproj** gespeichert.

      Eine Kopie von jeder Projektmappe**.sln** wird als Projektmappe**.vs2008.sln** gespeichert

    2. Untersuchen Sie alle fehlgeschlagenen Konvertierungen, die gemeldet werden.

      Fehler werden im Textfenster gemeldet.Außerdem zeigt die Strukturansicht eine rote Fahne auf jedem Knoten an, bei dessen Konvertierung ein Fehler aufgetreten ist.Sie können auf den Knoten klicken, um weitere Informationen zu diesem Fehler zu erhalten.

  5. Alle Vorlagen transformieren in Projektmappen, die erfolgreich konvertierte Projekte enthalten.

    1. Öffnen Sie die Projektmappe.

    2. Klicken Sie auf die Schaltfläche Alle Vorlagen transformieren im Header des Projektmappen-Explorers .

      HinweisHinweis

      Sie können diesen Schritt überflüssig machen.Weitere Informationen finden Sie unter So automatisieren Sie die Transformation aller Vorlagen.

  6. Aktualisieren Sie den benutzerdefinierten Code in den konvertierten Projekten.

    • Versuchen Sie, die Projekte zu erstellen, und untersuchen Sie alle Fehler.

    • Testen Sie den Designer.

Siehe auch

Konzepte

Neues im Visualisierungs- und Modellierungs-SDK