Flutter Translate is a fully featured localization / internationalization (i18n) library for Flutter.

Add an option to automatically sync the current locale with the system locale.

So when the system locale is changed, the current/app locale will be reloaded as well (if supported).

Reference: https://github.com/bratan/flutter_translate/issues/20

Currently, if a translation file is incomplete (i.e. a key is missing), then we will show the key instead of a translation. But for me it would be more intuitive to fallback to the fallbackLocale in these cases.

This allows to iteratively translate an App and if something is forgotten or not yet translated, we have a more meaningful placeholder.

Currently, I just load both translation maps (the chosen locale and the fallback locale) and then fallback during lookup. Another alternative is to merge the maps in the beginning and then just have one translation map.

Let me know, what you think. We could also make this a setting.

I have a dynamic list showing some descriptions like this:

List<Map> descriptions = [
"title":  "My title",
"description": ["description1", "description2"]
];

How could I get this from the translation json file?

Migration to null-safety Dependencies upgraded Example Android Folder upraged to support dart 2 Added pt-BR as translation example Formated Lib folder to pub.dev patterns with dartfmt command

Problem: when you test your app with Flutter Drive - app will stay on White screen while trying to init the app.

To be more specific, this call is never executes: final delegate = await LocalizationDelegate.create(fallbackLocale: 'en_US', supportedLocales: ['en_US']);

Root cause of the issue is inside locale_file_service.dart - Future getLocaleContent(String file) method.

This code hangs:

return rootBundle.loadString(file);

This code will work:

static Future<String> getLocaleContent(String file) async
    {
        final ByteData data = await rootBundle.load(file);
        if (data == null) return null;
        return utf8.decode(data.buffer.asUint8List());
    }

Underlying reason for that (if qurious to read) is here: https://github.com/flutter/flutter/issues/24703

Hi!

Actually it is not possible to have your locales outside of the rootBundle. This is needed in cases where you download your locales over network and can't have them in the rootBundle.

greetz

What

Added support to translate a list of strings.

Why

For a project I'm working on I needed to get a list of strings to display in a random way (ex.: a pseudo bot that says different sentences for a specific action) using the nested json feature provided by lokalise (link to specific doc page).

Example

json:

{
   "level_1": {
      "attack": [
          "Your attack was effective",
          "You hit your enemy!"
      ]
   }
}

flutter:

import "dart:math";
import 'package:flutter/material.dart';
import 'package:flutter_translate/flutter_translate.dart';

class FightFeedback extends StatelessWidget {

  @override
  Widget build(BuildContext context) {
    final rnd = Random();
    final messages = translateList('level_1.attack');
    final message = messages[rnd.nextInt(messages.length)];

    return Text(message);
  }
}

It seems like the generation of plural keys is not working correctly at the moment. The generated keys file in the static_keys example does not generate the key "Plural.demo", only the children of it (Plural.demo.zero etc.). Which in turn gives a compilation error when I try to use the key in my widget, as the key does not exist.

I thought originally i was doing something wrong, but the generated files in the example also does this.

Am i correct in assuming that the example will not work either? Or am i doing something wrong when i get the compilation error when running:

translatePlural(Keys.Plural_Demo, _counter)

Getting the following error after upgrading to 4.0.0:

../../../Flutter/flutter/.pub-cache/hosted/pub.dartlang.org/flutter_translate-4.0.0/lib/src/utils/device_locale.dart:11:49: Error: Property 'window' cannot be accessed on 'WidgetsBinding?' because it is potentially null.
     - 'WidgetsBinding' is from 'package:flutter/src/widgets/binding.dart' ('../../../Flutter/flutter/packages/flutter/lib/src/widgets/binding.dart').
    Try accessing using ?. instead.
      final deviceLocales = WidgetsBinding.instance.window.locales;

Flutter Doctor output:

Flutter (Channel stable, 2.10.5, on macOS 12.3.1 21E258 darwin-arm, locale
    en-DE)
    • Flutter version 2.10.5 at /Users/janbrinkmann/Flutter/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 5464c5bac7 (2 weeks ago), 2022-04-18 09:55:37 -0700
    • Engine revision 57d3bac3dd
    • Dart version 2.16.2
    • DevTools version 2.9.2

Fixes issue #13 and possibly #14 but I don't have an iOS device to test on. Takes into account if there are preferences on the device and if not loads the device locale.

I keep receiving this message when i run my program. if i add flutter: assets:

• assets/i18n

then i receive message No file or variants found for asset: assets/i18n.

Add translateIfExists API which returns null if the translation key is not found. This enables the caller to know that the translation is not available and act accordingly.