Flutter Yerelleştirmesi: ARB Dosyaları, intl ve gen-l10n Açıklaması

Tek bir yerelleştirme oluşturucu kullanın ve giriş ile çıkış konumlarını açıkça belirtin. Aşağıdaki örnek, kendi SDK kısıtlamalarına ve olağan proje yapılandırmasına sahip mevcut bir Flutter uygulamasını varsayar.

İlgili girdileri pubspec.yaml dosyasına birleştirin; dependencies veya flutter bölümlerini çoğaltmayın:

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  intl: any

flutter:
  generate: true

Bağımlılıkları flutter pub get ile çözümleyin. intl: any girdisi resmi kurulum modelini izler ve bağımlılık çözümlemesinin Flutter SDK ile uyumlu sürümü seçmesine olanak tanır; uygulamanın kilit dosyasını ve olağan bağımlılık inceleme sürecini koruyun.

Proje kök dizininde l10n.yaml oluşturun:

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart

SDK’ya özgü kurulum için güncel Flutter uluslararasılaştırma kılavuzunu kullanın. Modern süreçte oluşturulan yerelleştirme dosyaları uygulamanın kaynak ağacında yer alır. Örnek, lib/l10n konumundan içe aktarır; yeni bir kuruluma eski sentetik package:flutter_gen içe aktarımını kopyalamaktan kaçının. Oluşturulan kaynak geçiş notuna bakın.

lib/l10n/app_en.arb dosyasını oluşturun:

{
  "@@locale": "en",
  "appTitle": "Reading room",
  "@appTitle": {
    "description": "Title of the sample reading application"
  },
  "welcomeName": "Welcome, {name}",
  "@welcomeName": {
    "description": "Greeting on the home screen",
    "placeholders": {
      "name": {"type": "String", "example": "Sam"}
    }
  },
  "savedBooks": "{count, plural, =0{No saved books} one{1 saved book} other{{count} saved books}}",
  "@savedBooks": {
    "description": "Number of books saved to the user's library",
    "placeholders": {
      "count": {"type": "int"}
    }
  },
  "readingState": "{state, select, active{Reading now} paused{Reading paused} other{Ready to read}}",
  "@readingState": {
    "description": "Reading status; state is active, paused or another value",
    "placeholders": {
      "state": {"type": "String"}
    }
  }
}

lib/l10n/app_es.arb dosyasını oluşturun:

{
  "@@locale": "es",
  "appTitle": "Sala de lectura",
  "welcomeName": "Te damos la bienvenida, {name}",
  "savedBooks": "{count, plural, =0{No hay libros guardados} one{1 libro guardado} other{{count} libros guardados}}",
  "readingState": "{state, select, active{Leyendo ahora} paused{Lectura en pausa} other{Todo listo para leer}}"
}

Şablon, oluşturucunun kullandığı yer tutucu meta verilerini içerir. Yerelleştirilmiş dosya, kullanıcıya yönelik ifadeleri değiştirirken mesaj anahtarlarını, yer tutucu adlarını ve select tanımlayıcılarını korur. Bu İspanyolca örnekler mekanizmayı göstermek içindir; üretimdeki dil, gerçek ürün bağlamında anadili konuşan uzmanlarca gözden geçirilmelidir.

Kaynak ekledikten veya değiştirdikten sonra flutter gen-l10n komutunu çalıştırın. Oluşturucu hatalarını çözülmesi gereken kaynak sorunları olarak ele alın ve dosyaları bir sürüme entegre etmeden önce giderin.

Aşağıdaki örnek, oluşturma işleminden sonra lib/main.dart dosyasına eklenir:

import 'package:flutter/material.dart';
import 'l10n/app_localizations.dart';

void main() => runApp(const ReadingApp());

class ReadingApp extends StatelessWidget {
  const ReadingApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      home: const ReadingHome(),
    );
  }
}

class ReadingHome extends StatelessWidget {
  const ReadingHome({super.key});

  @override
  Widget build(BuildContext context) {
    final messages = AppLocalizations.of(context)!;
    return Scaffold(
      appBar: AppBar(title: Text(messages.appTitle)),
      body: Padding(
        padding: const EdgeInsetsDirectional.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text(messages.welcomeName('Sam')),
            Text(messages.savedBooks(3)),
            Text(messages.readingState('active')),
          ],
        ),
      ),
    );
  }
}

Oluşturulan API, düz bir mesaj ile bağımsız değişken alan bir mesaj arasındaki farkı kodda görünür kılar. appTitle bir değer olarak erişilir; welcomeName, savedBooks ve readingState ise mesajlarını oluşturmak için gereken değerleri alır.

Seçim yapmadan önce güncel easy_localization belgelerini ve GetX belgelerini inceleyin. Yedek davranışını, parametreleri, çoğul kategorilerini ve ayıklama süreçlerini gerçek mesajlarınızla test edin. İngilizce dizeler için kullanışlı bir API, sunmayı planladığınız her dil için kapsam sağladığını kanıtlamaz.

intl, rakip bir çeviri yönetim platformu değildir. Yerelleştirme süreçlerinde kullanılan uluslararasılaştırma yardımcı araçlarını sağlar. gen-l10n, ARB kaynaklarından uygulama erişimcileri oluşturur. Ayrı intl_utils paketi de yerelleştirme kodu oluşturur, ancak paket sayfası 30 Ekim 2026’da kontrol edildiğinde geliştirilmesi durdurulmuş olarak işaretlenmişti. Yeni bir projede benimsemeden önce bakım durumunu kontrol edin.

Pratik bir test matrisi kullanın:

Flutter’ın web SSS sayfası, odağının uygulama deneyimleri olduğunu belirtir ve statik, metin ağırlıklı web içeriği için belge odaklı bir yaklaşım önerir. Pazarlama, yardım ve editoryal sayfaların organik aramada başarılı olması gerekiyorsa bunlar için ayrı HTML tabanlı sayfalar düşünün.

Uygulama ile bu herkese açık sayfalar arasında terminolojiyi uyumlu tutun. Arama yoluyla gelen bir ziyaretçi, iki yüzey farklı oluşturma sistemleri kullansa bile yerelleştirilmiş açılış sayfasından uygulamaya geçtiğinde özellik adını tanıyabilmelidir.

Smartcat’in belgelenmiş yazılım projesi biçimleri arasında JSON, YAML, Android XML, iOS .strings ve LocJSON içe aktarımları bulunur. Bu kılavuz için incelenen belgeler, yerel ARB desteğini veya test edilmiş bir ARB’den JSON’a dönüştürme sürecini doğrulamamaktadır. Dosya uzantısını değiştirmenin uyumluluğu kanıtladığını varsaymayın. Yazılım projesi belgelerine bakın.

Aşağıdakini, önceden test edilmiş bir bağlayıcı tarifi olarak değil, uygulama ekibinizle birlikte önerilen bir doğrulama prosedürü olarak kullanın: