Actualizaciones de traducciones over-the-air en Flutter

Pasos de configuración

1. 1

   Crea una publicación

   En litei18n, confirma tus traducciones y crea una publicación en la página Releases (plan Starter o superior). Copia el ID de tu proyecto de la URL de la publicación que aparece allí. Exporta también tus traducciones en JSON y añádelas a tu app como copia incluida.

2. 2

   Carga la publicación al iniciar la app

   Añade el paquete http a pubspec.yaml, coloca tus archivos JSON exportados en assets/i18n/ y declara esa carpeta en flutter: assets: dentro de pubspec.yaml; si no, la app no podrá leerlos. Esta clase lee primero el archivo incluido y después sustituye sus valores por los de la última publicación cuando hay conexión.

   lib/translations.dartCopiar

   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 los textos

   Carga las traducciones antes de runApp y pásalas hacia abajo, o guárdalas en el gestor de estado que ya uses. Una clave que falta muestra su propio nombre, así que es fácil detectarla.

   lib/main.dartCopiar

   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 textos sin una nueva build

   Edita una traducción, confírmala y crea una nueva publicación. La URL latest ya sirve el texto nuevo y tu app lo recoge la próxima vez que cargue las traducciones. Sin nueva build ni revisión en la tienda.