Cosa cerca lo strumento
- Chiavi mancanti: presenti nel template ma assenti in una lingua. L'app compila, ma gli utenti vedono il testo nella lingua del template invece che nella loro.
- Chiavi in più: presenti in una traduzione ma non più nel template, spesso residui di una funzionalità rimossa.
- Valori vuoti: la chiave esiste ma la traduzione è vuota, cosa che un semplice controllo delle chiavi non vede.
- Placeholder non corrispondenti:
{name} diventato {nom}, o sparito. Vengono letti anche i placeholder dentro plurali e select ICU.
Le chiavi che iniziano con @ (metadati e @@locale) vengono ignorate. Il file di riferimento è quello impostato da template-arb-file in l10n.yaml, di solito app_en.arb: lo strumento lo individua e puoi sceglierne un altro.
Trovare le chiavi mancanti in un'app Flutter
- Raccogli i file della cartella
arb-dir (lib/l10n per impostazione predefinita).
- Trascinali tutti insieme, template compreso.
- Apri ogni lingua per vederne i problemi, poi copia le chiavi mancanti in formato ARB: riprendono il testo del template, pronte da tradurre.
Per un controllo automatico a ogni build, l'opzione untranslated-messages-file di flutter gen-l10n e un piccolo script di CI sono spiegati nella guida per trovare le chiavi mancanti nei file ARB. Gli errori sui placeholder ICU sono spiegati nella guida su plurali e placeholder.
Limiti dello strumento
Lo strumento confronta chiavi e nomi dei placeholder: non valida la sintassi ICU completa (è compito di flutter gen-l10n), non giudica la qualità della traduzione e non modifica mai i tuoi file. Per importare un intero progetto, tradurre ed esportare con un backup, serve un editor di localizzazione come LocalePilot.