Kontrol aracı neye bakar
- Eksik anahtarlar: şablonda var ama bir dilde yok. Uygulama yine derlenir, ama kullanıcılarınız kendi dilleri yerine şablon dilindeki metni görür.
- Fazla anahtarlar: bir çeviride var ama artık şablonda yok; çoğunlukla kaldırılmış bir özellikten kalanlar.
- Boş değerler: anahtar var ama çevirisi boş; basit bir anahtar kontrolü bunu gözden kaçırır.
- Placeholder uyumsuzlukları:
{name} placeholder'ının {nom} olması ya da tamamen düşmesi. ICU plural ve select içindeki placeholder'lar da okunur.
@ ile başlayan anahtarlar (meta veriler ve @@locale) yok sayılır. Referans dosya, l10n.yaml içindeki template-arb-file ile belirlenen dosyadır (genellikle app_en.arb). Araç bu dosyayı kendisi bulmaya çalışır, isterseniz başka bir dosya seçebilirsiniz.
Bir Flutter uygulamasında eksik anahtarları bulmak
arb-dir klasörünüzdeki dosyaları toplayın (varsayılan olarak lib/l10n).- Şablon dahil hepsini tek seferde bırakın.
- Sorunlarını görmek için her dili açın, ardından eksik anahtarları ARB formatında kopyalayın: kopyalanan anahtarlar şablon metnini içerir ve çeviriye hazırdır.
Her build'de otomatik kontrol için flutter gen-l10n komutunun untranslated-messages-file seçeneği ve küçük bir CI betiği ARB dosyalarında eksik anahtarları bulma rehberinde anlatılıyor. ICU placeholder hataları çoğullar ve placeholder'lar rehberinde açıklanıyor.
Kontrol aracının sınırları
Araç anahtarları ve placeholder adlarını karşılaştırır: tam ICU sözdizimini doğrulamaz (bu flutter gen-l10n'in işidir), çeviri kalitesini değerlendirmez ve dosyalarınızı asla değiştirmez. Projenin tamamını içe aktarmak, çevirmek ve yedek alarak dışa aktarmak için LocalePilot gibi bir yerelleştirme editörü gerekir.