Wdrażanie pakietów MSI i VSIX języka DSL

Język specyficzny dla domeny można zainstalować na własnym komputerze lub na innych komputerach. Program Visual Studio musi być już zainstalowany na komputerze docelowym.

Wybieranie między wdrożeniami VSIX i MSI

Istnieją dwie metody wdrażania języka specyficznego dla domeny:

Metoda	Świadczenia
VSX (rozszerzenie programu Visual Studio)	Bardzo łatwe do wdrożenia: kopiowanie i wykonywanie pliku vsix z projektu DslPackage. Aby uzyskać więcej informacji, zobacz Instalowanie i odinstalowywanie rozszerzenia DSL przy użyciu programu VSX.
MSI (plik instalatora)	— Umożliwia użytkownikowi otwarcie programu Visual Studio przez dwukrotne kliknięcie pliku DSL. — Kojarzy ikonę z typem pliku DSL na komputerze docelowym. — Kojarzy XSD (schemat XML) z typem pliku DSL. Zapobiega to ostrzeżeniom podczas ładowania pliku do programu Visual Studio. Aby utworzyć tożsamość usługi zarządzanej, musisz dodać projekt instalacyjny do rozwiązania. Aby uzyskać więcej informacji, zobacz Wdrażanie rozszerzenia DSL przy użyciu pliku MSI.

Instalowanie i odinstalowywanie rozszerzenia DSL przy użyciu programu VSX

Po zainstalowaniu rozszerzenia DSL za pomocą tej metody użytkownik może otworzyć plik DSL z poziomu programu Visual Studio, ale nie można otworzyć go z Poziomu Eksploratora Windows.

Aby zainstalować rozszerzenie DSL przy użyciu programu VSX

1. Znajdź plik vsix, który został skompilowany przez projekt pakietu DSL:

   1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt DslPackage, a następnie kliknij polecenie Otwórz folder w Eksplorator plików.

   2. Znajdź plik bin\*\YourProject. DslPackage.vsix

2. Skopiuj plik vsix na komputer docelowy, na którym chcesz zainstalować rozszerzenie DSL. Może to być twój własny komputer lub inny.

   • Komputer docelowy musi mieć jedną z edycji programu Visual Studio, która obsługuje listy DSL w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Obsługiwane wersje programu Visual Studio dla zestawu SDK wizualizacji i modelowania.

   • Komputer docelowy musi mieć jedną z edycji programu Visual Studio określonych w pliku DslPackage\source.extensions.manifest.

3. Na komputerze docelowym kliknij dwukrotnie plik vsix .

   Instalator rozszerzenia programu Visual Studio otwiera i instaluje rozszerzenie.

4. Uruchom lub uruchom ponownie program Visual Studio.

5. Aby przetestować rozszerzenie DSL, użyj programu Visual Studio, aby utworzyć nowy plik z rozszerzeniem zdefiniowanym dla rozszerzenia DSL.

Aby odinstalować rozszerzenie DSL zainstalowane przy użyciu programu VSX

1. W menu Narzędzia wybierz pozycję Rozszerzenia i Aktualizacje.

2. Rozwiń węzeł Zainstalowane rozszerzenia.

3. Wybierz rozszerzenie, w którym zdefiniowano rozszerzenie DSL, a następnie kliknij przycisk Odinstaluj.

   Rzadko nie można załadować wadliwego rozszerzenia i utworzyć raport w oknie błędu, ale nie jest wyświetlany w Menedżerze rozszerzeń. W takim przypadku można usunąć rozszerzenie, usuwając plik z:

   LocalAppData\Microsoft\VisualStudio\10.0\Extensions

Wdrażanie rozszerzenia DSL w tożsamości usługi zarządzanej

Definiując plik MSI (Instalator Windows) dla rozszerzenia DSL, można zezwolić użytkownikom na otwieranie plików DSL z Poziomu Eksploratora Windows. Możesz również skojarzyć ikonę i krótki opis z rozszerzeniem nazwy pliku. Ponadto tożsamość usługi zarządzanej może instalować XSD, który może służyć do weryfikowania plików DSL. Jeśli chcesz, możesz dodać inne składniki do tożsamości usługi zarządzanej, która zostanie zainstalowana w tym samym czasie.

Aby uzyskać więcej informacji na temat plików MSI i innych opcji wdrażania, zobacz Wdrażanie aplikacji, usług i składników.

Aby utworzyć tożsamość usługi zarządzanej, należy dodać projekt Instalacyjny do rozwiązania programu Visual Studio. Najprostszą metodą tworzenia projektu instalatora jest użycie szablonu CreateMsiSetupProject.tt, który można pobrać z witryny ZESTAWU VMSDK.

Aby wdrożyć rozszerzenie DSL w tożsamości usługi zarządzanej

1. Ustaw InstalledByMsi w manifeście rozszerzenia. Zapobiega to instalowaniu i odinstalowywaniu programu VSX z wyjątkiem pliku MSI. Jest to ważne, jeśli dołączysz inne składniki do tożsamości usługi zarządzanej.

   1. Otwórz pakiet DslPackage\source.extension.tt

   2. Wstaw następujący wiersz przed :<SupportedProducts>

      <InstalledByMsi>true</InstalledByMsi>
      

2. Utwórz lub edytuj ikonę, która będzie reprezentować rozszerzenie DSL w Eksploratorze Windows. Na przykład edytuj plik DslPackage\Resources\File.ico

3. Upewnij się, że następujące atrybuty rozszerzenia DSL są poprawne:

   • W Eksploratorze DSL kliknij węzeł główny, a w okno Właściwości przejrzyj:

     • opis

     • Wersja

   • Kliknij węzeł Edytor, a następnie w okno Właściwości kliknij pozycję Ikona. Ustaw wartość, aby odwołać się do pliku ikony w pliku DslPackage\Resources, na przykład File.ico

   • W menu Kompilacja otwórz program Configuration Manager i wybierz konfigurację, którą chcesz skompilować, na przykład Wydanie lub Debugowanie.

4. Przejdź do strony głównej Zestaw SDK wizualizacji i modelowania, a następnie na karcie Pobrane pobierz CreateMsiSetupProject.tt.

5. Dodaj CreateMsiSetupProject.tt do projektu Dsl.

   Program Visual Studio utworzy plik o nazwie CreateMsiSetupProject.vdproj.

6. W Eksploratorze Windows skopiuj plik Dsl\*.vdproj do nowego folderu o nazwie Setup.

   (Jeśli chcesz, możesz teraz wykluczyć CreateMsiSetupProject.tt z projektu Dsl).

7. W Eksplorator rozwiązań dodaj plik Setup\*.vdproj jako istniejący projekt.

8. W menu Project (Projekt) kliknij pozycję Project Dependencies (Zależności projektu).

   W oknie dialogowym Zależności projektu wybierz projekt instalacyjny.

   Zaznacz pole obok pozycji DslPackage.

9. Skompiluj ponownie rozwiązanie.

10. W Eksploratorze Windows znajdź skompilowany plik MSI w projekcie Instalatora.

    Skopiuj plik MSI na komputer, na którym chcesz zainstalować rozszerzenie DSL. Kliknij dwukrotnie plik MSI. Instalator jest uruchamiany.

11. Na komputerze docelowym utwórz nowy plik, który ma rozszerzenie pliku DSL. Sprawdź, czy:

    • W widoku listy Eksploratora Windows plik zostanie wyświetlony z zdefiniowaną ikoną i opisem.

    • Po dwukrotnym kliknięciu pliku program Visual Studio zostanie uruchomiony i otworzy plik DSL w edytorze DSL.

    Jeśli wolisz, możesz ręcznie utworzyć projekt Instalacyjny zamiast używać szablonu tekstowego. Aby zapoznać się z przewodnikiem obejmującym tę procedurę, zobacz Rozdział 5 laboratorium zestawu SDK wizualizacji i modelowania.

Aby odinstalować rozszerzenie DSL zainstalowane z tożsamości usługi zarządzanej

1. W systemie Windows otwórz panel sterowania Programy i funkcje .

2. Odinstaluj rozszerzenie DSL.

3. Uruchom ponownie program Visual Studio.