Udostępnij za pośrednictwem


Tworzenie pliku vsct

Istnieje kilka sposobów tworzenia pliku konfiguracji tabeli poleceń programu Visual Studio opartego na xml (vsct).

  • Nowy pakiet VSPackage można utworzyć w szablonie pakietu programu Visual Studio.

  • Aby wygenerować plik z istniejącego pliku ctc, można użyć kompilatora konfiguracji tabeli poleceń opartych na języku XML, Vsct.exe.

  • Możesz użyć narzędzia Vsct.exe , aby wygenerować plik vsct z istniejącego pliku cto .

  • Możesz ręcznie utworzyć nowy plik vsct .

    W tym artykule wyjaśniono, jak ręcznie utworzyć nowy plik vsct .

Aby ręcznie utworzyć nowy plik vsct

  1. Uruchom program Visual Studio.

  2. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Plik.

  3. W okienku Szablony kliknij pozycję Plik XML, a następnie kliknij przycisk Otwórz.

  4. W menu Widok kliknij pozycję Właściwości, aby wyświetlić właściwości pliku XML.

  5. W oknie Właściwości kliknij przycisk Przeglądaj we właściwości Schematy.

  6. Na liście schematów XSD wybierz schemat vsct.xsd . Jeśli nie znajduje się na liście, kliknij przycisk Dodaj , a następnie znajdź plik na dysku lokalnym. Po zakończeniu kliknij przycisk OK.

  7. W pliku XML wpisz <CommandTable, a następnie naciśnij klawisz Tab. Zamknij tag, wpisując .>

    Ta akcja powoduje utworzenie podstawowego pliku vsct .

  8. Wypełnij elementy pliku XML, które chcesz dodać, zgodnie z odwołaniem do schematu XML VSCT. Aby uzyskać więcej informacji, zobacz Tworzenie plików vsct.

Tworzenie pliku vsct na podstawie istniejącego pliku ctc

Plik vsct oparty na formacie XML można utworzyć z istniejącego pliku źródłowego tabeli poleceń ctc. Dzięki temu możesz skorzystać z nowego formatu kompilatora poleceń programu Visual Studio (VSCT) opartego na języku XML.

Aby utworzyć plik vsct z pliku ctc

  1. Uzyskaj kopię języka Perl.

  2. Uzyskaj kopię ConvertCTCToVSCT.pl skryptu Perl, zazwyczaj znajdującą się w <ścieżce> instalacji zestawu VISUAL Studio SDK\VisualStudioIntegration\Tools\bin.

  3. Uzyskaj kopię pliku źródłowego ctc , który chcesz przekonwertować.

  4. Umieść pliki w tym samym katalogu.

  5. W oknie wiersza polecenia programu Visual Studio przejdź do katalogu.

  6. Typ

    perl.exe ConvertCTCtoVSCT.pl PkgCmd.ctc PkgCmd.vsct
    

    gdzie PkgCmd.ctc jest nazwą pliku .ctc i PkgCmd.vsct jest nazwą pliku vsct, który chcesz utworzyć.

    Ta akcja powoduje utworzenie nowego pliku źródłowego tabeli poleceń .vsct XML. Plik można skompilować przy użyciu narzędzia Vsct.exe, kompilatora VSCT, tak jak w przypadku dowolnego innego pliku vsct .

    Uwaga

    Czytelność pliku vsct można poprawić przez ponowne sformatowanie komentarzy XML.

Tworzenie pliku vsct na podstawie istniejącego pliku cto

Plik vsct oparty na formacie XML można utworzyć na podstawie istniejącego binarnego pliku cto. Dzięki temu można korzystać z nowego formatu kompilatora tabeli poleceń. Ten proces działa nawet wtedy, gdy plik cto został skompilowany z pliku ctc . Plik vsct można edytować i skompilować do innego pliku cto.

Aby utworzyć plik vsct z pliku cto

  1. Uzyskaj kopie pliku cto i odpowiadający mu plik ctsym .

  2. Umieść pliki w tym samym katalogu co kompilator vsct.exe .

  3. W wierszu polecenia programu Visual Studio przejdź do katalogu zawierającego pliki cto i ctsym .

  4. Typ

    vsct.exe <ctofilename>.cto <vsctfilename>.vsct -S<symfilename>.ctsym
    

    gdzie <ctofilename> jest nazwą pliku .cto , <vsctfilename> jest nazwą pliku vsct , który chcesz utworzyć, a <symfilename> jest nazwą pliku ctsym .

    Ten proces tworzy nowy plik kompilatora tabeli poleceń .vsct XML. Plik można edytować i kompilować za pomocą pliku vsct.exe, kompilatora vsct, tak jak każdy inny plik vsct .

Kompilowanie kodu

Po prostu dodanie pliku vsct do projektu nie powoduje jego skompilowania. Należy je uwzględnić w procesie kompilacji.

Aby dodać plik vsct do kompilacji projektu

  1. Otwórz plik projektu w edytorze. Jeśli projekt zostanie załadowany, musisz go zwolnić jako pierwszy.

  2. Dodaj element ItemGroup, który zawiera VSCTCompile element, jak pokazano w poniższym przykładzie.

    <ItemGroup>
      <VSCTCompile Include="TopLevelMenu.vsct">
        <ResourceName>Menus.ctmenu</ResourceName>
      </VSCTCompile>
    </ItemGroup>
    
    

    Element ResourceName powinien być zawsze ustawiony na Menus.ctmenuwartość .

  3. Jeśli projekt zawiera plik resx , dodaj EmbeddedResource element zawierający MergeWithCTO element, jak pokazano w poniższym przykładzie:

    <EmbeddedResource Include="VSPackage.resx">
      <MergeWithCTO>true</MergeWithCTO>
      <ManifestResourceName>VSPackage</ManifestResourceName>
    </EmbeddedResource>
    
    

    Ten znacznik powinien znajdować się wewnątrz elementu zawierającego ItemGroup zasoby osadzone.

  4. Otwórz plik pakietu o nazwie <ProjectName>Package.cs lub< ProjectName>Package.vb w edytorze.

  5. ProvideMenuResource Dodaj atrybut do klasy pakietu, jak pokazano w poniższym przykładzie.

    [ProvideMenuResource("Menus.ctmenu", 1)]
    

    Pierwsza wartość parametru musi być zgodna z wartością atrybutu ResourceName zdefiniowanego w pliku projektu.