Aggiornamenti delle traduzioni over-the-air in Flutter

Passaggi di configurazione

1. 1

   Crea una release

   In litei18n, esegui il commit delle traduzioni e crea una release nella pagina Releases (dal piano Starter in su). Copia l'ID del progetto dall'URL della release mostrato lì. Esporta anche le traduzioni in JSON e aggiungile alla tua app come copia inclusa.

2. 2

   Carica la release all'avvio dell'app

   Aggiungi il pacchetto http a pubspec.yaml, metti i file JSON esportati in assets/i18n/ ed elenca quella cartella sotto flutter: assets: in pubspec.yaml, altrimenti l'app non può leggerli. Questa classe legge prima il file incluso, poi ne sostituisce i valori con l'ultima release quando la rete lo consente.

   lib/translations.dartCopia

   import 'dart:convert';
   
   import 'package:flutter/services.dart' show rootBundle;
   import 'package:http/http.dart' as http;
   
   const projectId = 'YOUR_PROJECT_ID';
   const releases =
       'https://ttksowxkfdohtprtfarf.supabase.co/storage/v1/object/public/releases/locales';
   
   class Translations {
     Translations(this._values);
   
     final Map<String, String> _values;
   
     String t(String key) => _values[key] ?? key;
   
     static Future<Translations> load(String locale) async {
       // The copy bundled with the app: works offline and on first launch.
       final values = Map<String, String>.from(
         jsonDecode(await rootBundle.loadString('assets/i18n/$locale.json')),
       );
       try {
         final res = await http
             .get(Uri.parse('$releases/$projectId/latest/$locale.json'))
             .timeout(const Duration(seconds: 5));
         if (res.statusCode == 200) {
           values.addAll(Map<String, String>.from(jsonDecode(utf8.decode(res.bodyBytes))));
         }
       } catch (_) {
         // Offline or slow: keep the bundled copy.
       }
       return Translations(values);
     }
   }

3. 3

   Usa i testi

   Carica le traduzioni prima di runApp e passale ai widget, oppure tienile nella gestione dello stato che usi già. Una chiave mancante mostra il proprio nome, quindi è facile accorgersene.

   lib/main.dartCopia

   import 'package:flutter/material.dart';
   
   import 'translations.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     final tr = await Translations.load('es');
     runApp(MyApp(tr: tr));
   }
   
   // In a widget:
   Text(tr.t('home.title'))

4. 4

   Cambia i testi senza una nuova build

   Modifica una traduzione, esegui il commit e crea una nuova release. L'URL latest ora restituisce il nuovo testo e la tua app lo riceve la prossima volta che carica le traduzioni. Nessuna nuova build, nessuna revisione dello store.