csv_localizations 0.2.0+1

A minimal CSV localization package for Flutter built on LocalizationsDelegate.

csv_localizations

A minimal CSV localization package for Flutter.

Usage

See example.

Install

Add to your pubspec.yaml

dependencies:
  csv_localizations:

Add CSV asset file

Add a CSV file as an asset and describe it in your pubspec.yaml

Tip: Create a Spreadsheet via Google docs, then export as CSV

flutter:
  assets:
    - assets/lang.csv

Example CSV file:

key, en, nb
Hi, Hi, Hei
my_img,assets/en.png,assets/nb.png

First row is supported language codes; below are localizations. Left column are keys for localized values to the right.

Tip: keys can point to local assets like images etc.

MaterialApp

Add CsvLocalizationsDelegate to MaterialApp and set supportedLocales using language codes.

MaterialApp(
  localizationsDelegates: [
    ... // global delegates
    CsvLocalizationsDelegate(
      CsvLocalizations(
        assetPath: 'assets/lang.csv',
        supportedLanguageCodes: [ 'en', 'nb', ],
      ),
    ),
  ],
  supportedLocales: [ Locale('en'), Locale('nb'), ],
}

API

Translate strings using

CsvLocalizations.of(context).string('Hi')

Localize an image by pointing to various local assets

Image.asset(CsvLocalizations.of(context).string('my_img'))

We keep the API simple, but you can easily add an extension method to String like this:

extension LocalizedString on String {
  String tr(BuildContext context) => CsvLocalizations.of(context).string(this);
}

Note on iOS

Add supported languages to ios/Runner/Info.plist as described here.

Example:

<key>CFBundleLocalizations</key>
<array>
	<string>en</string>
	<string>nb</string>
</array>