VSIX Paketlerini Yerelleştirme

Makale
01/13/2024

Her hedef dil için bir Extension.vsixlangpack dosyası oluşturup bunları doğru klasöre yerleştirerek vsIX paketini yerelleştirebilirsiniz. Yerelleştirilmiş bir paket yüklendiğinde, uzantının yerelleştirilmiş adı yerelleştirilmiş bir açıklamayla birlikte görüntülenir. Yerelleştirilmiş bir lisans dosyası veya yerelleştirilmiş bilgilere işaret eden bir URL sağlarsanız, bunlar da görüntülenir.

VSIX paketinizin içeriği menü komutları veya başka kullanıcı arabirimi ekleyen bir VSPackage içeriyorsa, yeni kullanıcı arabirimi öğelerini yerelleştirme hakkında bilgi için bkz . Menü komutlarını yerelleştirme.

Dizin yapısı

Kullanıcı bir uzantı yüklediğinde Uzantılar ve Güncelleştirmeler, adı hedef bilgisayarın Visual Studio yerel ayarıyla eşleşen bir klasör için VSIX paketinin en üst düzeyini denetler. Uzantılar ve Güncelleştirmeler klasörde bir .vsixlangpack dosyası bulursa, bu dosyadaki yerelleştirilmiş değerleri .vsixmanifest dosyasındaki karşılık gelen değerlerin yerini alır. Uzantı yüklenirken bu değerler görüntülenir. Aşağıdaki örnek, İspanyolca (es-ES) ve Fransızca (fr-FR) olarak yerelleştirilmiş bir VSIX paketinin dizin yapısını gösterir.

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

Not

Visual Studio SDK'sında VSIX tarafından desteklenen proje şablonları bir VSIX bildirimi oluşturur ve source.extension.vsixmanifest olarak adlandırır. Visual Studio projeyi derlediğinde, bu dosyanın içeriğini VSIX paketindeki Extension.VsixManifest dosyasına kopyalar.

Extension.vsixlangpack dosyası

Extension.vsixlangpack dosyası VSIX Dil Paketi şeması 2.0'a uyar. Bu şemanın hemen ardından bir PackageLanguagePackManifestalt öğe gelen bir Metadata öğesi vardır. Metadata öğesi en fazla 6 alt öğe içerebilir: DisplayName, Description, MoreInfo, License, , ReleaseNotesve Icon. Bu alt öğeler Extension.vsixmanifest dosyasının öğesinin Metadata, DescriptionMoreInfoLicense, , ReleaseNotesve Icon alt öğelerine karşılık gelir.DisplayName

Vsixlangpack dosyası oluşturduğunuzda özelliğini olarak trueayarlamanız Include in Vsix gerekir. Aksi takdirde, yerelleştirilmiş yükleme metni yoksayılır.

Vsix'e Ekle özelliğini ayarlamak için

Çözüm Gezgini extension.vsixlangpack dosyasına sağ tıklayın ve ardından Özellikler'e tıklayın.
Özellik Kılavuzu'nda Vsix'e Ekle'ye tıklayın ve değerini olarak trueayarlayın.

Örnek

Açıklama

Aşağıdaki örnekte Extension.vsixmanifest dosyasının ilgili bölümleri gösterilmektedir. Dosya, İspanyolca için karşılık gelen Extension.vsixlangpack dosyasını da içerir. Hedef bilgisayarın Visual Studio yerel ayarı İspanyolca olarak ayarlandıysa dil paketindeki değerler bildirimdeki değerlerin yerini alır.

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>

Ayrıca bkz.

Ünvan	Açıklama
VSIX Dil Paketi şema 2.0 başvurusu	VSIX dil paketi, .vsix dağıtım dosyasının yerelleştirme bilgilerini açıklar.
VSIX paketinin anatomisi	Vsix paketinin yapısını ve içeriğini açıklar.
Menü komutlarını yerelleştir	Uzantıdaki diğer metin kaynaklarını yerelleştirmeyi gösterir.

Aracılığıyla paylaş