Bölüm 12 — Konu 61: Yerelleştirme (Localization / i18n)

Bu tutorial'ın son konusuna hoş geldin. Bir uygulamayı tek bir dilde yazmak kolaydır — ama gerçek dünyada, kullanıcıların farklı dillerde, farklı tarih/sayı formatlarında konuştuğu bir dünyada yaşıyoruz (sen bile, Türkiye'den Azerbaycan'a taşındıktan sonra, muhtemelen birden fazla dilde arayüzlerle karşılaşıyorsundur). Bu ders, Flutter'ın resmi yerelleştirme altyapısını — intl paketi ve .arb dosyalarını — baştan sona işliyor.

#İki Terim: i18n ve l10n

• i18n (internationalization / uluslararasılaştırma): Uygulamanı, birden fazla dili destekleyecek şekilde hazırlama süreci — metinleri koddan ayırma, tarih/sayı formatlarını esnek hale getirme.
• l10n (localization / yerelleştirme): Belirli bir dile/bölgeye özgü içeriği (çeviriler, tarih formatları) gerçekten ekleme süreci.

(Sayılar, kelimelerin ilk ve son harfleri arasındaki harf sayısını temsil eder — "internationalization" = i + 18 harf + n, "localization" = l + 10 harf + n. Sektörde çok yaygın bir kısaltma.)

#Flutter'ın Yerelleşme Altyapısı — flutter_localizations + intl

# pubspec.yaml
dependencies:
  flutter_localizations:
    sdk: flutter
  intl: ^0.19.0

flutter:
  generate: true   # .arb dosyalarından OTOMATİK Dart kodu üretimini AÇAR

generate: true, Bölüm 6'da Riverpod'un @riverpod code generation'ını (Konu 25'te "Bir Adım İleri" bölümünde değinmiştik) ya da Bölüm 8'de gördüğümüz code generation mantığına benzer bir fikir — sen veri (çeviri metinleri) yazarsın, Flutter senin için tip-güvenli Dart kodu üretir.

#.arb Dosyaları — Çevirilerin Kaynağı

ARB (Application Resource Bundle), JSON tabanlı bir format — her dil için ayrı bir dosya:

// lib/l10n/app_tr.arb
{
  "@@locale": "tr",
  "merhaba": "Merhaba, {isim}!",
  "@merhaba": {
    "description": "Kullanıcıyı isimle karşılayan selamlama",
    "placeholders": {
      "isim": { "type": "String" }
    }
  },
  "sepettekiUrunSayisi": "{sayi, plural, =0{Sepetiniz boş} =1{Sepetinizde 1 ürün var} other{Sepetinizde {sayi} ürün var}}"
}

// lib/l10n/app_en.arb
{
  "@@locale": "en",
  "merhaba": "Hello, {isim}!",
  "sepettekiUrunSayisi": "{sayi, plural, =0{Your cart is empty} =1{You have 1 item} other{You have {sayi} items}}"
}

plural sözdizimi özellikle önemli — Bölüm 2'de Dart'ın kontrol yapılarını öğrendiğimizde, bir sayının "tekil/çoğul" olmasına göre farklı metin göstermek için if/else yazardık; ama diller arası çoğul kuralları çok farklıdır (Türkçe'de "0 ürün" ile "5 ürün" aynı biçimde çekimlenir, İngilizce'de "0 items" ile "1 item" farklı çekimlenir — bazı dillerde, örneğin Arapça'da, 6 farklı çoğul kategorisi vardır). intl'in plural sözdizimi, bu dil-özel kuralları senin yerine yönetir — sen sadece =0, =1, other durumlarını doldurursun, hangi dilde hangi kuralın uygulanacağını paket halleder.

#Kod Üretimi ve Kullanım

flutter gen-l10n   # .arb dosyalarından lib/l10n/app_localizations.dart üretir (elle DÜZENLENMEZ)

// main.dart
MaterialApp(
  localizationsDelegates: AppLocalizations.localizationsDelegates,
  supportedLocales: AppLocalizations.supportedLocales,
  // ...
)

// herhangi bir widget içinde:
Text(AppLocalizations.of(context)!.merhaba('Ayşe'))
// çıktı: "Merhaba, Ayşe!" (tr) ya da "Hello, Ayşe!" (en) — cihazın DİL AYARINA göre OTOMATİK

Text(AppLocalizations.of(context)!.sepettekiUrunSayisi(3))
// çıktı: "Sepetinizde 3 ürün var" (tr) ya da "You have 3 items" (en)

AppLocalizations.of(context), Bölüm 6 Konu 23'te öğrendiğimiz InheritedWidget deseninin tam bir uygulamasıdır — Theme.of(context), MediaQuery.of(context) ile birebir aynı mekanizma: widget ağacında yukarı doğru en yakın Localizations widget'ını bulur ve o context'e uygun dildeki çevirileri döndürür.

#Dil Değiştirme — locale Parametresi

// Cihazın SİSTEM DİLİNİ otomatik kullanmak istersen (varsayılan davranış):
MaterialApp(
  supportedLocales: [Locale('tr'), Locale('en'), Locale('az')],  // desteklenen diller
  // locale belirtilmezse, sistem dili kullanılır (destekleniyorsa)
)

// Kullanıcının UYGULAMA İÇİNDEN dil seçebilmesini istersen:
MaterialApp(
  locale: seciliDil,   // Bölüm 6'da öğrendiğimiz state management ile YÖNETİLEN bir değişken
  supportedLocales: [Locale('tr'), Locale('en'), Locale('az')],
)

seciliDil, tipik olarak Bölüm 6'da öğrendiğimiz Riverpod/Provider ile global state olarak tutulur — kullanıcı bir dil seçtiğinde, bu state değişir, MaterialApp yeniden build olur (Bölüm 3'teki setState/rebuild mantığının aynısı), ve tüm AppLocalizations.of(context) çağrıları otomatik olarak yeni dile göre günceller.

#Tarih, Sayı ve Para Birimi Formatlama

Çeviri metinlerinin ötesinde, sayıların kendisi de dile göre değişir:

import 'package:intl/intl.dart';

// Tarih:
DateFormat.yMMMMd('tr').format(DateTime.now());   // "29 Eylül 2026"
DateFormat.yMMMMd('en').format(DateTime.now());   // "September 29, 2026"

// Sayı (ondalık ayracı diller arası FARKLIDIR!):
NumberFormat.decimalPattern('tr').format(1234.56);  // "1.234,56"  (Türkçe: nokta=binlik, virgül=ondalık)
NumberFormat.decimalPattern('en').format(1234.56);  // "1,234.56"  (İngilizce: TERSİ)

// Para birimi:
NumberFormat.currency(locale: 'tr', symbol: '₺').format(1234.56);  // "₺1.234,56"
NumberFormat.currency(locale: 'az', symbol: '₼').format(1234.56);  // Azerbaycan manatı

Bu, i18n'in en sık gözden kaçan tuzağıdır: Bir geliştirici, sayıyı elle '${fiyat.toStringAsFixed(2)}' gibi formatlarsa, her dilde aynı (yanlış) formatı gösterir — NumberFormat/DateFormat kullanmak, Bölüm 2'de öğrendiğimiz "string interpolasyonunu doğru kullanma" disiplininin, yerelleştirme bağlamındaki kritik uzantısıdır.

#RTL (Sağdan Sola) Diller

Arapça, İbranice gibi diller sağdan sola yazılır — Flutter, bunu büyük ölçüde otomatik yönetir:

// Row/Column yerine, YÖN-BAĞIMSIZ eşdeğerlerini kullanmak RTL desteğini kolaylaştırır:
Padding(
  padding: EdgeInsetsDirectional.only(start: 16),  // 'left' YERİNE — RTL'de OTOMATİK ters döner
  child: ...,
)

Row(
  textDirection: TextDirection.rtl,  // genelde ELLE ayarlamana gerek YOK, Localizations bunu sistem dilinden anlar
)

EdgeInsetsDirectional (start/end) ile EdgeInsets (left/right) arasındaki fark önemli — start, LTR dillerde "sol", RTL dillerde "sağ" anlamına gelir ve otomatik döner; left her zaman fiziksel olarak sol demektir. Baştan Directional varyantlarını kullanmak, sonradan RTL desteği eklemeyi çok kolaylaştırır — tıpkı Bölüm 4'te öğrendiğimiz responsive tasarımın, baştan esnek yazıldığında sonradan kolayca uyarlanabilmesi gibi.

#Test Etme

testWidgets('Türkçe çeviri doğru gösteriliyor', (tester) async {
  await tester.pumpWidget(
    MaterialApp(
      locale: Locale('tr'),
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      home: KarsilamaEkrani(),
    ),
  );

  expect(find.text('Merhaba, Ayşe!'), findsOneWidget);  // Bölüm 10 Konu 45'teki widget test mantığı
});

Bu, Bölüm 10 Konu 45'te öğrendiğimiz widget testlerinin, her desteklenen dil için tekrarlanabilir bir versiyonu — özellikle plural kurallarının (0/1/çoğul) doğru çalıştığını doğrulamak için değerlidir.

#Pratik Bir Uyarı: Ne Zaman Gerekli?

Bu tutorial boyunca yazdığın öğrenme amaçlı projelerde tek dil (Türkçe) yeterliydi — ama gerçek bir yayınlanan uygulamada (Bölüm 11'i hatırla, Play Store/App Store'a yayınlama), hedef pazarının dillerini düşünmek, kullanıcı tabanını doğrudan büyütür. Azerbaycan'da yaşadığını düşünürsek, örneğin Türkçe + Azerbaycanca + İngilizce desteği, gerçek bir uygulamada düşük maliyetli, yüksek getirili bir yatırımdır — özellikle .arb dosyaları, çeviri metinlerini tek bir yerde toplayarak, bir çevirmene (senin kendi Dart/Flutter bilgin olmadan) kolayca gönderilebilir hale getirir.

#🎯 Bu Dersten Çıkarılması Gerekenler

• i18n (uluslararasılaştırma) = koda hazırlık; l10n (yerelleştirme) = belirli bir dile içerik ekleme.
• .arb dosyaları, dile göre ayrılmış çeviri kaynaklarıdır; flutter gen-l10n, bunlardan tip-güvenli Dart kodu üretir.
• plural sözdizimi, dil-özel çoğul kurallarını (Türkçe/İngilizce/Arapça farklı davranır) senin yerine yönetir.
• AppLocalizations.of(context), Bölüm 6'daki InheritedWidget mekanizmasının (Theme.of, MediaQuery.of ile aynı desen) birebir bir uygulamasıdır.
• NumberFormat/DateFormat (intl paketi), sayı/tarih/para birimi formatlarını dile göre doğru gösterir — elle string formatlamak, farklı dillerde yanlış sonuç üretir.
• EdgeInsetsDirectional (start/end), RTL dilleri (Arapça, İbranice) desteklemek için EdgeInsets (left/right)'a tercih edilmelidir.
• Gerçek bir yayınlanan uygulamada, hedef pazarın dillerini desteklemek düşük maliyetli, yüksek getirili bir yatırımdır.

#📝 Ödevler

• [ ] Bu tutorial boyunca yazdığın bir uygulamaya flutter_localizations/intl ekle, en az iki dil (tr, en) için .arb dosyaları oluştur.
• [ ] En az bir plural içeren çeviri anahtarı yaz (örn. "X ürün var") ve 0/1/çoklu durumlarda doğru çalıştığını gözlemle.
• [ ] Uygulamana, kullanıcının dil seçebileceği bir ayarlar ekranı ekle (Bölüm 6'daki state management ile locale değerini yönet).
• [ ] NumberFormat.currency ile bir fiyatı hem tr hem en locale'de formatlayıp farkı gözlemle.
• [ ] Kendi cümlelerinle, "AppLocalizations.of(context)'in neden Theme.of(context) ile aynı mekanizmayı kullandığını" açıkla.

#🎓 Tebrikler — Flutter Tutorial'ı Tamamladın!

Bölüm 1'de MaterialApp/Scaffold ile başladığın bu yolculuk, 61 konu ve 12 bölüm sonunda, Custom RenderObject'lere, engine mimarisine, federated plugin'lere ve monorepo yönetimine kadar uzandı. Dart'taki 66 konuyla birlikte düşünürsen, artık dilin temellerinden, framework'ün iç mekanizmalarına, üretim/yayınlama süreçlerine kadar uçtan uca bir haritan var.

Bundan sonrası, gerçek projeler inşa ederek pekiştirme zamanı — istersen, öğrendiklerini birleştiren kapsamlı bir bitirme projesi (state management + backend + testler + CI/CD + yayınlama adımlarının hepsini bir araya getiren) için birlikte bir yol haritası çıkarabiliriz, ya da belirli bir konuyu (örneğin bir konuyu daha derinlemesine, ya da güncellik taraması yaptığımız gibi tüm Flutter derslerini bir kez daha tarayabiliriz) tekrar ele alabiliriz.