RESX Dosyalarıyla Yerelleştirme

Ekibiniz zaten .resx kaynak dosyalarıyla çeviri yapıyorsa (klasik .NET iş akışı), FmgLib.MauiMarkup doğrudan onlara takılır — JSON varyantıyla aynı canlı-değişim davranışıyla, sizin ResourceManager'ınız tarafından sürülür.

1. RESX Kaynaklarını Oluşturun#

Projenize kaynak dosyaları ekleyin, örn. Resources/Languages altında:

Code

AppResources.resx          (varsayılan dil)
AppResources.tr-TR.resx
AppResources.fr-FR.resx

Her dosya aynı anahtarları çevrilmiş değerlerle içerir (Hello → "Hello World!" / "Merhaba Dünya!"). Visual Studio, statik ResourceManager'lı AppResources sınıfını üretir.

2. `MauiProgram.cs`'te Kaydedin#

builder
    .UseMauiApp<App>()
    .UseMauiMarkupLocalizationWithResx(AppResources.ResourceManager);

// veya açık başlangıç diliyle:
// .UseMauiMarkupLocalizationWithResx(AppResources.ResourceManager, "en-US");

// veya options overload'ı ile — yedek kültür / eksik anahtar politikası / kültür senkronizasyonu:
// .UseMauiMarkupLocalizationWithResx(AppResources.ResourceManager, o => o
//     .UseDefaultCulture("en-US")
//     .OnMissingTranslation(MissingTranslationBehavior.Marker));

3. Metinleri `TranslateResx` ile Bağlayın#

new Label()
    .Text(e => e.TranslateResx("Hello"))
    .FontSize(32)
    .CenterHorizontal()
    .SemanticHeadingLevel(SemanticHeadingLevel.Level1),

new Label()
    .Text(e => e.TranslateResx(nameof(AppResources.Msg)))   // güçlü tipli anahtar!
    .FontSize(18)
    .CenterHorizontal()
    .SemanticDescription(e => e.TranslateResx("Msg"))

nameof(AppResources.Msg) formu önerilendir — bir kaynak anahtarını yeniden adlandırmak derleme zamanı kontrollü bir refactoring olur.

JSON varyantında olduğu gibi her string özellik çevrilebilir:

new Entry().Placeholder(e => e.TranslateResx(nameof(AppResources.EnterEmail)))
this.Title(e => e.TranslateResx(nameof(AppResources.SettingsTitle)))

4. Çalışma Zamanında Dil Değiştirin#

TranslatorResx.Instance.ChangeCulture(CultureInfo.GetCultureInfo("en-US"));

TranslateResx ile bağlanan tüm özellikler anında güncellenir; çağrı arka plan thread'inden de güvenlidir. JSON varyantında olduğu gibi kültür değişimi varsayılan olarak ortam CultureInfo'sunu da günceller — bkz. CultureSyncMode.

Dil seçici örneği:

new VerticalStackLayout()
.Center()
.Children(
    new RadioButton()
        .IsChecked(TranslatorResx.Instance.CurrentCulture.Name == "tr-TR")
        .Content("tr-TR")
        .OnCheckedChanged((sender, e) =>
        {
            if (e.Value)
                TranslatorResx.Instance.ChangeCulture(CultureInfo.GetCultureInfo("tr-TR"));
        }),

    new RadioButton()
        .IsChecked(TranslatorResx.Instance.CurrentCulture.Name == "en-US")
        .Content("en-US")
        .OnCheckedChanged((sender, e) =>
        {
            if (e.Value)
                TranslatorResx.Instance.ChangeCulture(CultureInfo.GetCultureInfo("en-US"));
        })
)

Kodda Çeviri Okuma#

string msg = TranslatorResx.Instance[nameof(AppResources.Msg)];
await DisplayAlert("Bilgi", msg, "OK");

// string genişletme karşılıkları:
string hello   = "Hello".ToTranslateResx();            // geçerli kültür
string helloTr = "Hello".ToTranslateResx("tr-TR");     // açık kültür

Notlar ve İpuçları#

Kültür yedeği (fallback) standart ResourceManager kurallarını izler: tr-TR → tr → varsayılan kaynaklar. Nötr .resx'i eksiksiz tutun. UseFallbackCulture(...) bu zincirden sonra bir deneme daha ekler.
Eksik anahtarlar varsayılan olarak anahtarı döner (önceden ResourceManager.GetString null dönüyor ve etiket boş görünüyordu). OnMissingTranslation(...) ile değiştirin — JSON translator'ı ile aynı politika.
Seçimi kalıcılaştırın Preferences ile ve başlangıçta yeniden uygulayın (bkz. Yerelleştirme (JSON) deseni).
JSON ve RESX sistemleri bağımsızdır (Translator vs. TranslatorResx); ikisini bir uygulamada kullanabilirsiniz ama birinde standartlaşmak işleri basit tutar.
Biçimli string'ler: kalıbı kaynaklarda saklayın ("WelcomeUser" = "Hoş geldin, {0}!") ve TranslateResxFormat ile bağlayın; hem dil hem değerler için canlı kalır:

new Label().Text(e => e.TranslateResxFormat(nameof(AppResources.WelcomeUser), nameof(vm.UserName)))

Sağdan sola: this.FlowDirection(e => e.FromCulture(TranslatorResx.Instance)) sayfayı Arapça/İbranice için aynalar.

İlgili Konular#

Yerelleştirme (JSON) — JSON-vs-RESX karşılaştırma tablosunu içerir
Fluent Özellikler