add easy_localization_storage, easy_localization_shared_preferences_storage and easy_localization_helper

example/lib/main.dart

@@ -1,4 +1,5 @@
 import 'package:easy_localization/easy_localization.dart';
+import 'package:easy_localization_storage/easy_localization_storage.dart';
 //import 'package:easy_localization_loader/easy_localization_loader.dart'; // import custom loaders
 import 'package:flutter/material.dart';
 import 'package:font_awesome_flutter/font_awesome_flutter.dart';
@@ -8,17 +9,17 @@ import 'lang_view.dart';
 
 void main() async {
   WidgetsFlutterBinding.ensureInitialized();
-  await EasyLocalization.ensureInitialized();
+  await EasyLocalization.ensureInitialized(EasyLocalizationInMemoryStorage());
 
   runApp(EasyLocalization(
-    supportedLocales: [
+    supportedLocales: const [
       Locale('en', 'US'),
       Locale('ar', 'DZ'),
       Locale('de', 'DE'),
       Locale('ru', 'RU')
     ],
     path: 'resources/langs',
-    child: MyApp(),
+    child: const MyApp(),
     // fallbackLocale: Locale('en', 'US'),
     // startLocale: Locale('de', 'DE'),
     // saveLocale: false,
@@ -40,6 +41,8 @@ void main() async {
 }
 
 class MyApp extends StatelessWidget {
+  const MyApp({Key? key}) : super(key: key);
+
   @override
   Widget build(BuildContext context) {
     return MaterialApp(
@@ -49,18 +52,18 @@ class MyApp extends StatelessWidget {
       theme: ThemeData(
         primarySwatch: Colors.blue,
       ),
-      home: MyHomePage(title: 'Easy localization'),
+      home: const MyHomePage(title: 'Easy localization'),
     );
   }
 }
 
 class MyHomePage extends StatefulWidget {
-  MyHomePage({Key? key, required this.title}) : super(key: key);
+  const MyHomePage({Key? key, required this.title}) : super(key: key);
 
   final String title;
 
   @override
-  _MyHomePageState createState() => _MyHomePageState();
+  State<MyHomePage> createState() => _MyHomePageState();
 }
 
 class _MyHomePageState extends State<MyHomePage> {
@@ -83,7 +86,7 @@ class _MyHomePageState extends State<MyHomePage> {
   Widget build(BuildContext context) {
     return Scaffold(
       appBar: AppBar(
-        title: Text(LocaleKeys.title).tr(),
+        title: const Text(LocaleKeys.title).tr(),
         actions: <Widget>[
           TextButton(
             onPressed: () {
@@ -93,20 +96,15 @@ class _MyHomePageState extends State<MyHomePage> {
                     builder: (_) => LanguageView(), fullscreenDialog: true),
               );
             },
-            child: Icon(
-              Icons.language,
-              color: Colors.white,
-            ),
+            child: const Icon(Icons.language, color: Colors.white),
           ),
         ],
       ),
       body: Center(
         child: Column(
           mainAxisAlignment: MainAxisAlignment.center,
           children: <Widget>[
-            Spacer(
-              flex: 1,
-            ),
+            const Spacer(flex: 1),
             Text(
               LocaleKeys.gender_with_arg,
               style: TextStyle(
@@ -124,27 +122,23 @@ class _MyHomePageState extends State<MyHomePage> {
             Row(
               mainAxisAlignment: MainAxisAlignment.center,
               children: <Widget>[
-                FaIcon(FontAwesomeIcons.male),
+                const FaIcon(FontAwesomeIcons.male),
                 Switch(value: _gender, onChanged: switchGender),
-                FaIcon(FontAwesomeIcons.female),
+                const FaIcon(FontAwesomeIcons.female),
               ],
             ),
-            Spacer(
-              flex: 1,
-            ),
-            Text(LocaleKeys.msg).tr(args: ['aissat', 'Flutter']),
-            Text(LocaleKeys.msg_named)
+            const Spacer(flex: 1),
+            const Text(LocaleKeys.msg).tr(args: ['aissat', 'Flutter']),
+            const Text(LocaleKeys.msg_named)
                 .tr(namedArgs: {'lang': 'Dart'}, args: ['Easy localization']),
-            Text(LocaleKeys.clicked).plural(counter),
+            const Text(LocaleKeys.clicked).plural(counter),
             TextButton(
               onPressed: () {
                 incrementCounter();
               },
-              child: Text(LocaleKeys.clickMe).tr(),
-            ),
-            SizedBox(
-              height: 15,
+              child: const Text(LocaleKeys.clickMe).tr(),
             ),
+            const SizedBox(height: 15),
             Text(
                 plural(LocaleKeys.amount, counter,
                     format: NumberFormat.currency(
@@ -153,24 +147,20 @@ class _MyHomePageState extends State<MyHomePage> {
                     color: Colors.grey.shade900,
                     fontSize: 18,
                     fontWeight: FontWeight.bold)),
-            SizedBox(
-              height: 20,
-            ),
+            const SizedBox(height: 20),
             ElevatedButton(
               onPressed: () {
                 context.resetLocale();
               },
-              child: Text(LocaleKeys.reset_locale).tr(),
-            ),
-            Spacer(
-              flex: 1,
+              child: const Text(LocaleKeys.reset_locale).tr(),
             ),
+            const Spacer(flex: 1),
           ],
         ),
       ),
       floatingActionButton: FloatingActionButton(
         onPressed: incrementCounter,
-        child: Text('+1'),
+        child: const Text('+1'),
       ),
     );
   }

example/macos/Flutter/GeneratedPluginRegistrant.swift

@@ -5,8 +5,6 @@
 import FlutterMacOS
 import Foundation
 
-import shared_preferences_foundation
 
 func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
-  SharedPreferencesPlugin.register(with: registry.registrar(forPlugin: "SharedPreferencesPlugin"))
 }

example/pubspec.yaml

@@ -25,6 +25,8 @@ dependencies:
   cupertino_icons: ^1.0.2
   easy_localization:
     path: ../
+  easy_localization_storage:
+    path: ../packages/easy_localization_storage
   font_awesome_flutter: 9.0.0-nullsafety
 
   #custom loaders

lib/src/asset_loader.dart

@@ -2,6 +2,7 @@ import 'dart:convert';
 import 'dart:ui';
 
 import 'package:easy_localization/easy_localization.dart';
+import 'package:easy_localization_helper/easy_localization_helper.dart';
 import 'package:flutter/services.dart';
 
 /// abstract class used to building your Custom AssetLoader

lib/src/easy_localization_app.dart

@@ -2,6 +2,7 @@ import 'dart:async';
 
 import 'package:easy_localization/easy_localization.dart';
 import 'package:easy_localization/src/easy_localization_controller.dart';
+import 'package:easy_localization_storage/easy_localization_storage.dart';
 import 'package:easy_logger/easy_logger.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
@@ -159,8 +160,8 @@ class EasyLocalization extends StatefulWidget {
   /// ensureInitialized needs to be called in main
   /// so that savedLocale is loaded and used from the
   /// start.
-  static Future<void> ensureInitialized() async =>
-      await EasyLocalizationController.initEasyLocation();
+  static Future<void> ensureInitialized(EasyLocalizationStorage storage) async =>
+      await EasyLocalizationController.initEasyLocation(storage);
 
   /// Customizable logger
   static EasyLogger logger = EasyLogger(name: '🌎 Easy Localization');

lib/src/easy_localization_controller.dart

@@ -1,18 +1,31 @@
 import 'package:easy_localization/easy_localization.dart';
+import 'package:easy_localization_helper/easy_localization_helper.dart';
+import 'package:easy_localization_storage/easy_localization_storage.dart';
 import 'package:flutter/material.dart';
 import 'package:intl/intl_standalone.dart'
     if (dart.library.html) 'package:intl/intl_browser.dart';
-import 'package:shared_preferences/shared_preferences.dart';
 
 import 'translations.dart';
 
 class EasyLocalizationController extends ChangeNotifier {
   static Locale? _savedLocale;
   static late Locale _deviceLocale;
+  static EasyLocalizationStorage? _storage;
+  static EasyLocalizationStorage get storage {
+    if (_storage == null) {
+      throw StateError(
+          'EasyLocalizationController not initialized. Call initEasyLocation first.');
+    }
+    return _storage!;
+  }
+
+  static set storage(EasyLocalizationStorage storage) {
+    _storage = storage;
+  }
 
   late Locale _locale;
   Locale? _fallbackLocale;
-  List<Locale>? _supportedLocales;
+  late List<Locale> _supportedLocales;
 
   final Function(FlutterError e) onLoadError;
   final AssetLoader assetLoader;
@@ -161,9 +174,11 @@ class EasyLocalizationController extends ChangeNotifier {
     final result = <String, dynamic>{};
     final loaderFutures = <Future<Map<String, dynamic>?>>[];
 
-    // need scriptCode, it might be better to use ignoreCountryCode as the variable name of useOnlyLangCode 
-    final Locale desiredLocale =
-        useOnlyLangCode ? Locale.fromSubtags(languageCode: locale.languageCode, scriptCode: locale.scriptCode) : locale;
+    // need scriptCode, it might be better to use ignoreCountryCode as the variable name of useOnlyLangCode
+    final Locale desiredLocale = useOnlyLangCode
+        ? Locale.fromSubtags(
+            languageCode: locale.languageCode, scriptCode: locale.scriptCode)
+        : locale;
 
     List<AssetLoader> loaders = [
       assetLoader,
@@ -197,34 +212,33 @@ class EasyLocalizationController extends ChangeNotifier {
 
   Future<void> _saveLocale(Locale? locale) async {
     if (!saveLocale) return;
-    final preferences = await SharedPreferences.getInstance();
-    await preferences.setString('locale', locale.toString());
+    await storage.setLocale(value: locale);
     EasyLocalization.logger('Locale $locale saved');
   }
 
-  static Future<void> initEasyLocation() async {
-    final preferences = await SharedPreferences.getInstance();
-    final strLocale = preferences.getString('locale');
-    _savedLocale = strLocale?.toLocale();
+  static Future<void> initEasyLocation(EasyLocalizationStorage storage) async {
+    EasyLocalizationController.storage = storage;
+    _savedLocale = await storage.getLocale();
     final foundPlatformLocale = await findSystemLocale();
     _deviceLocale = foundPlatformLocale.toLocale();
     EasyLocalization.logger.debug('Localization initialized');
   }
 
   Future<void> deleteSaveLocale() async {
     _savedLocale = null;
-    final preferences = await SharedPreferences.getInstance();
-    await preferences.remove('locale');
+    storage.setLocale();
     EasyLocalization.logger('Saved locale deleted');
   }
 
   Locale get deviceLocale => _deviceLocale;
   Locale? get savedLocale => _savedLocale;
 
   Future<void> resetLocale() async {
-    final locale = selectLocaleFrom(_supportedLocales!, deviceLocale, fallbackLocale: _fallbackLocale);
+    final locale = selectLocaleFrom(_supportedLocales, deviceLocale,
+        fallbackLocale: _fallbackLocale);
 
-    EasyLocalization.logger('Reset locale to $locale while the platform locale is $_deviceLocale and the fallback locale is $_fallbackLocale');
+    EasyLocalization.logger(
+        'Reset locale to $locale while the platform locale is $_deviceLocale and the fallback locale is $_fallbackLocale');
     await setLocale(locale);
   }
 }

lib/src/utils.dart

@@ -29,39 +29,6 @@ String localeToString(Locale locale, {String separator = '_'}) {
   return locale.toString().split('_').join(separator);
 }
 
-/// [Easy Localization] locale helper
-extension LocaleToStringHelper on Locale {
-  /// Convert [locale] to String with custom separator
-  String toStringWithSeparator({String separator = '_'}) {
-    return toString().split('_').join(separator);
-  }
-}
-
-/// [Easy Localization] string locale helper
-extension StringToLocaleHelper on String {
-  /// Convert string to [Locale] object
-  Locale toLocale({String separator = '_'}) {
-    final localeList = split(separator);
-    switch (localeList.length) {
-      case 2:
-        return localeList.last.length == 4 // scriptCode length is 4
-            ? Locale.fromSubtags(
-                languageCode: localeList.first,
-                scriptCode: localeList.last,
-              )
-            : Locale(localeList.first, localeList.last);
-      case 3:
-        return Locale.fromSubtags(
-          languageCode: localeList.first,
-          scriptCode: localeList[1],
-          countryCode: localeList.last,
-        );
-      default:
-        return Locale(localeList.first);
-    }
-  }
-}
-
 extension MapExtension<K> on Map<K, dynamic> {
   void addAllRecursive(Map<K, dynamic> other) {
     for (final entry in other.entries) {

packages/easy_localization_helper/.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+build/

packages/easy_localization_helper/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "603104015dd692ea3403755b55d07813d5cf8965"
+  channel: "stable"
+
+project_type: package

packages/easy_localization_helper/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+* TODO: Describe initial release.

packages/easy_localization_helper/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.