Lokalizowanie pakietów VSIX

Artykuł
01/13/2024

Pakiet VSIX można zlokalizować, tworząc plik Extension.vsixlangpack dla każdego języka docelowego, a następnie umieszczając go w poprawnym folderze. Po zainstalowaniu zlokalizowanego pakietu zostanie wyświetlona zlokalizowana nazwa rozszerzenia wraz z zlokalizowanym opisem. Jeśli podasz zlokalizowany plik licencji lub adres URL wskazujący zlokalizowane informacje, zostaną one również wyświetlone.

Jeśli zawartość pakietu VSIX zawiera pakiet VSPackage, który dodaje polecenia menu lub inny interfejs użytkownika, zobacz Localize menu polecenia , aby uzyskać informacje na temat lokalizowania nowych elementów interfejsu użytkownika.

Struktura katalogów

Gdy użytkownik instaluje rozszerzenie, rozszerzenia i Aktualizacje sprawdza najwyższy poziom pakietu VSIX dla folderu, którego nazwa jest zgodna z ustawieniami regionalnymi programu Visual Studio komputera docelowego. Jeśli rozszerzenia i Aktualizacje znajdzie plik vsixlangpack w folderze, zastąpi zlokalizowane wartości w tym pliku odpowiednimi wartościami w pliku vsixmanifest. Te wartości są wyświetlane podczas instalowania rozszerzenia. Poniższy przykład przedstawia strukturę katalogów pakietu VSIX zlokalizowanego w języku hiszpańskim (es-ES) i francuskim (fr-FR).

.
├── MyExtension.dll
├── Extension.vsixmanifest
├── [Content_Types].xml
├── es-ES
│   └── Extension.vsixlangpack
└── fr-FR
    └── Extension.vsixlangpack

Uwaga

Szablony projektów obsługiwane przez program VSIX w zestawie SDK programu Visual Studio generują manifest VSIX i nadaj mu nazwę source.extension.vsixmanifest. Gdy program Visual Studio skompiluje projekt, kopiuje zawartość tego pliku do pliku Extension.VsixManifest w pakiecie VSIX.

Plik Extension.vsixlangpack

Plik Extension.vsixlangpack jest zgodny ze schematem pakietu językowego VSIX 2.0. Ten schemat ma PackageLanguagePackManifestelement , który jest natychmiast obserwowany przez element podrzędny Metadata . Element Metadata może zawierać maksymalnie 6 elementów podrzędnych, DisplayName, , MoreInfoDescription, License, ReleaseNotes, i Icon. Te elementy podrzędne odpowiadają elementom podrzędnym DisplayName, , LicenseMoreInfoDescription, ReleaseNotes, i Icon elementu podrzędnego pliku Extension.vsixmanifest.Metadata

Podczas tworzenia pliku vsixlangpack należy ustawić Include in Vsix właściwość na true. W przeciwnym razie zlokalizowany tekst instalacji zostanie zignorowany.

Aby ustawić właściwość Uwzględnij w vsix

W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik Extension.vsixlangpack, a następnie kliknij polecenie Właściwości.
W siatce właściwości kliknij pozycję Uwzględnij w vsix i ustaw jego wartość na true.

Przykład

opis

W poniższym przykładzie przedstawiono odpowiednie fragmenty pliku Extension.vsixmanifest . Plik zawiera również odpowiedni plik Extension.vsixlangpack dla języka hiszpańskiego. Wartości z pakietu językowego zastępują wartości z manifestu, jeśli ustawienia regionalne programu Visual Studio komputera docelowego są ustawione na hiszpański.

Kod

[Extension.vsixmanifest]

<?xml version="1.0" encoding="utf-8"?>
<PackageManifest ...>
  <Metadata ...>
    <DisplayName>Family Tree</DisplayName>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <MoreInfo>http://www.contoso.com/products/FamilyTree.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
  <Installation .../>
  <Dependencies .../>
  <Prerequisites .../>
  <Assets .../>
</PackageManifest>

[Extension.vsixlangpack]

<?xml version="1.0" encoding="utf-8"?>
<PackageLanguagePackManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011">
  <Metadata>
    <DisplayName>Arbol de Familia</DisplayName>
    <Description> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</Description>
    <MoreInfo> http://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
</PackageLanguagePackManifest>

Zobacz też

Nazwa	opis
Dokumentacja dotycząca schematu pakietu językowego VSIX 2.0	Pakiet językowy VSIX opisuje informacje o lokalizacji pliku wdrożenia vsix.
Anatomia pakietu VSIX	Opisuje strukturę i zawartość pakietu vsix.
Lokalizowanie poleceń menu	Pokazuje, jak lokalizować inne zasoby tekstowe w rozszerzeniu.

Share via