Udostępnij za pośrednictwem

MSI i VSIX wdrażanie DSL

  • Artykuł

Język specyficzne dla domen można zainstalować na własnym komputerze lub na innych komputerach.Visual Studiomuszą być już zainstalowane na komputerze docelowym.

Wybieranie między VSIX i wdrażania MSI

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

Metoda

Korzyści

VSX (Visual Studio rozszerzenia)

Bardzo łatwo wdrożyć: kopii i wykonywanie .vsix pliku z projektu DslPackage.

Aby uzyskać więcej informacji, zobacz instalowania i odinstalowywania DSL za pomocą VSX.

MSI (plik Instalatora)

  • Zezwala użytkownikowi na otwarcie Visual Studio przez dwukrotne kliknięcie pliku DSL.

  • Kojarzy ikona z typem pliku DSL w komputerze docelowym.

  • Kojarzy XSD (XML schemat) z typem pliku DSL.Pozwala to uniknąć ostrzeżenia, gdy plik jest ładowany do Visual Studio.

Projekt instalacji należy dodać do roztworu, aby utworzyć MSI.

Aby uzyskać więcej informacji, zobacz Wdrażanie DSL przy użyciu pliku MSI.

Instalowanie i odinstalowywanie DSL za pomocą VSX

Kiedy modem DSL jest instalowany przez tę metodę, użytkownik może otwierać plik DSL z poziomu Visual Studio, ale nie można otworzyć plik z Eksploratora Windows.

Aby zainstalować modem DSL za pomocą VSX

  1. W komputerze, należy znaleźć .vsix pliku, który został zbudowany w danym projekcie pakiet DSL.

    1. W Solution Explorer, kliknij prawym przyciskiem myszy DslPackage projektu, a następnie kliknij przycisk Otwórz Folder w Eksploratorze Windows.

    2. Zlokalizuj plik bin\*\YourProject.DslPackage.vsix

  2. Kopia .vsix plik do komputera docelowego, na którym chcesz zainstalować modem DSL.Może to być własnego komputera lub innego certyfikatu.

  3. Na komputerze docelowym, kliknij dwukrotnie .vsix pliku.

    Visual Studio rozszerzenie Instalator otwiera i instaluje rozszerzenia.

  4. Uruchom lub uruchom ponownie Visual Studio.

  5. Aby przetestować modem DSL, Visual Studio , aby utworzyć nowy plik z rozszerzeniem zdefiniowane dla linii DSL.

Aby odinstalować DSL, który został zainstalowany przy użyciu VSX

  1. Na Narzędzia menu, kliknij przycisk Extension Manager.

  2. Rozwiń węzeł zainstalowanych rozszerzeń.

  3. Zaznacz rozszerzenie, w której zdefiniowane jest modem DSL, a następnie kliknij przycisk Odinstalowywanie.

Rzadko uszkodzone rozszerzenie nie można załadować i tworzy raport w oknie błędów, ale nie są wyświetlane w Menedżerze rozszerzeń.W takim przypadku można usunąć rozszerzenie przez usunięcie z pliku:

LocalAppData**\Microsoft\VisualStudio\10.0\Extensions**

Wdrażanie DSL w MSI

Definiując pliku MSI (Instalator Windows) dla linii DSL, można zezwolić użytkownikom otwieranie plików DSL z Eksploratora Windows.Można także skojarzyć ikonę i krótki opis rozszerzeniem nazwy pliku.Ponadto plik MSI można zainstalować pliku XSD, używany do sprawdzania poprawności plików DSL.Można dodać inne składniki do MSI, który zostanie zainstalowany w tym samym czasie.

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

Aby zbudować MSI, należy dodać projektu Instalatora, aby Twoje Visual Studio roztworu.Najłatwiejszą metodą tworzenia projektów instalacji jest użycie szablonu CreateMsiSetupProject.tt, którą można pobrać z witrynę VMSDK.

Aby wdrożyć DSL w MSI

  1. Ustaw InstalledByMsi w manifeście rozszerzenie.To zapobiega VSX zainstalowani i odinstalowani z wyjątkiem za pomocą pakietu MSI.Jest to ważne, jeśli plik MSI będzie zawierać inne składniki.

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

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

      <InstalledByMsi>true</InstalledByMsi>

  2. Utwórz lub Edytuj ikony reprezentujące modem DSL, w Eksploratorze Windows.Na przykład EdycjaDslPackage\Resources\File.ico

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

    • W Eksploratorze DSL kliknij główny węzeł i w oknie właściwości przeglądu:

      • Opis

      • Wersja

    • Kliknij przycisk edytora węzeł i w oknie dialogowym właściwości kliknij przycisk ikonę.Ustaw wartość na odwołać pliku ikony w DslPackage\Resources, takie jakFile.ico

    • Na budować menu, a następnie kliknij polecenie Otwórz Menedżer konfiguracjii wybierz konfigurację którą chcesz utworzyć, takie jak wersji lub debugowania.

  4. Przejdź do stronę główną wizualizacji i modelowania SDKi z pliki do pobrania tab, Pobierz CreateMsiSetupProject.tt.

  5. Dodaj CreateMsiSetupProject.tt do swojego projektu Dsl.

    Visual Studioutworzy plik o nazwie CreateMsiSetupProject.vdproj.

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

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

  7. W Solution Explorer, dodać Setup\*.vdproj jako istniejącego projektu.

  8. Na Projekt menu, kliknij przycisk Współzależności między projektami.

    W Współzależności między projektami okno dialogowe Wybierz projekt instalacji.

    Zaznacz pole obok DslPackage.

  9. Odbuduj roztworu.

  10. W Eksploratorze Windows zlokalizuj zbudowany plik MSI w projekcie Instalatora.

    Skopiuj plik MSI do komputera, na którym chcesz zainstalować modem DSL.Kliknij dwukrotnie plik MSI.Instalator jest uruchamiany.

  11. W komputerze docelowym należy utworzyć nowy plik, który ma rozszerzenie pliku z linii DSL.Sprawdź, czy:

    • W widoku listy programu Windows Explorer plik pojawi się ikona i opis, który zostanie zdefiniowany.

    • Po dwukrotnym kliknięciu pliku, Visual Studio uruchamia i otwiera plik DSL w edytorze DSL.

Jeśli wolisz, Projekt instalacji można utworzyć ręcznie, zamiast przy użyciu szablonu tekstu.Aby instruktażu, która zawiera tę procedurę, zobacz rozdział 5 wizualizacji i modelowania Lab SDK.

Aby odinstalować DSL, który został zainstalowany z MSI

  1. W systemie Windows, otwórz Programy i funkcje w Panelu sterowania.

  2. Odinstaluj DSL.

  3. Uruchom ponownie program Visual Studio.