Aracılığıyla paylaş

Meta veri yerelleştirmeye genel bakış

  • Makale

Yapılandırma nesnelerinin içinde tanımlanan bazı meta veriler yerelleştirmeyi destekler. Yerelleştirmeyi destekleyen özellikler ile LocalizableStringAttribute donatılır ve bu özellikler yerelleştirilebilir olmayan bir değere ayarlanırsa derleyici bir uyarı yayar. Bu değerler, uzantınıza string-resources.json dosyaları eklenerek ve dize kaynak anahtarını karakterlerle % çevreleyerek yerelleştirilebilir.

Command Yerelleştirilmiş DisplayName ve ToolTipText aşağıdaki gibi görünen A:

public override CommandConfiguration CommandConfiguration => new("%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName%")
{
    ToolTipText = "%Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText%"
}

string-resources.json

Uzantınız, uzantınızın desteklediği her dil için bir string-resources.json dosyası sağlamalıdır. Bu JSON dosyası, anahtarın bir dize kaynağı için genel olarak (visual studio'nun tümü) benzersiz tanımlayıcısı olduğu ve değerin yerelleştirilmiş dize kaynağı olduğu anahtar/değer çiftlerinin sözlüğüdür. Bu JSON dosyaları, uzantınızla birlikte dizinin altında .vsextension dağıtılmalıdır ve desteklediğiniz her dil yerel ayarın adıyla eşleşen bir klasörde gönderilir; yani Almanca için "de", İtalyanca için "it", vb. Uzantınız Visual Studio'nun .vsextension şu anda ayarlandığı dili desteklemiyorsa, dizinin kökünde dağıtılan string-resources.json varsayılan olarak kullanılır. Bu dizin yapısının nasıl görüneceğine yönelik bir örnek burada görülebilir:

Localization directory structure

string-resources.json örneği:

{
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.DisplayName": "Sample Remote Command Display Name",
    "Microsoft.VisualStudio.MyExtension.SampleRemoteCommand.ToolTipText": "Sample Remote Command ToolTip"
}

Sonraki adımlar

Visual Studio komutları ekleme başlığında VisualStudio.Genişletilebilirlik komutları hakkında daha fazla bilgi edinin.