应用程序中通常会包含一些贯穿APP生命周期的变量信息,这些信息在APP大多数地方可能都会被用到,比如当前用户信息、Local信息等。在Flutter中我们把需要全局共享的信息分为两类:全局变量和共享状态

  • 全局变量指会贯穿整个APP生命周期的变量,用于单纯的保存一些信息,或者封装一些全局工具和方法的对象
  • 共享状态则是指哪些需要跨组件或跨路由共享的信息,这些信息通常也是全局变量,
  • 共享状态和全局变量的不同在于前者发生改变时需要通知所有使用该状态的组件,而后者不需要。为此,我们将全局变量和共享状态分开单独管理

全局变量 Global类

在lib/common/global.dart目录下创建一个Global类,它主要管理APP的全局变量,定义如下:

  1. // 提供五套可选主题色
  2. const _themes = <MaterialColor>[
  3. Colors.blue,
  4. Colors.cyan,
  5. Colors.teal,
  6. Colors.green,
  7. Colors.red,
  8. ];
  9. class Global {
  10. static SharedPreferences _prefs;
  11. static Profile profile = Profile();
  12. // 网络缓存对象
  13. static NetCache netCache = NetCache();
  14. // 可选的主题列表
  15. static List<MaterialColor> get themes => _themes;
  16. // 是否为release版
  17. static bool get isRelease => bool.fromEnvironment("dart.vm.product");
  18. //初始化全局信息,会在APP启动时执行
  19. static Future init() async {
  20. _prefs = await SharedPreferences.getInstance();
  21. var _profile = _prefs.getString("profile");
  22. if (_profile != null) {
  23. try {
  24. profile = Profile.fromJson(jsonDecode(_profile));
  25. } catch (e) {
  26. print(e);
  27. }
  28. }
  29. // 如果没有缓存策略,设置默认缓存策略
  30. profile.cache = profile.cache ?? CacheConfig()
  31. ..enable = true
  32. ..maxAge = 3600
  33. ..maxCount = 100;
  34. //初始化网络请求相关配置
  35. Git.init();
  36. }
  37. // 持久化Profile信息
  38. static saveProfile() =>
  39. _prefs.setString("profile", jsonEncode(profile.toJson()));
  40. }

Global类的各个字段的意义都有注释,在此不再赘述,需要注意的是init()需要在App启动时就要执行,所以应用的main方法如下:

  1. void main() => Global.init().then((e) => runApp(MyApp()));

在此,一定要确保Global.init()方法不能抛出异常,否则 runApp(MyApp())根本执行不到

共享状态

有了全局变量,我们还需要考虑如何跨组件共享状态。当然,如果我们将要共享的状态全部用全局变量替代也是可以的,但是这在Flutter开发中并不是一个好主意,因为组件的状态是和UI相关,而在状态改变时我们会期望依赖该状态的UI组件会自动更新,如果使用全局变量,那么我们必须得去手动处理状态变动通知、接收机制以及变量和组件依赖关系。因此,本实例中,我们使用前面介绍过的Provider包来实现跨组件状态共享,因此我们需要定义相关的Provider。在本实例中,需要共享的状态有登录用户信息、APP主题信息、APP语言信息。由于这些信息改变后都要立即通知其它依赖的该信息的Widget更新,所以我们应该使用ChangeNotifierProvider,另外,这些信息改变后都是需要更新Profile信息并进行持久化的

综上所述,创建 lib/states/ProfileChangeNotifier.dart 文件,可以以定义一个ProfileChangeNotifier基类,然后让需要共享的Model继承自该类即可,ProfileChangeNotifier定义如下:

  1. class ProfileChangeNotifier extends ChangeNotifier {
  2. Profile get _profile => Global.profile;
  3. @override
  4. void notifyListeners() {
  5. Global.saveProfile(); //保存Profile变更
  6. super.notifyListeners(); //通知依赖的Widget更新
  7. }
  8. }

用户状态

用户状态在登录状态发生变化时更新、通知其依赖项,我们定义如下:

  1. class UserModel extends ProfileChangeNotifier {
  2. User get user => _profile.user;
  3. // APP是否登录(如果有用户信息,则证明登录过)
  4. bool get isLogin => user != null;
  5. //用户信息发生变化,更新用户信息并通知依赖它的子孙Widgets更新
  6. set user(User user) {
  7. if (user?.login != _profile.user?.login) {
  8. _profile.lastLogin = _profile.user?.login;
  9. _profile.user = user;
  10. notifyListeners();
  11. }
  12. }
  13. }

APP主题状态

主题状态在用户更换APP主题时更新、通知其依赖项,定义如下:

  1. class ThemeModel extends ProfileChangeNotifier {
  2. // 获取当前主题,如果为设置主题,则默认使用蓝色主题
  3. ColorSwatch get theme => Global.themes
  4. .firstWhere((e) => e.value == _profile.theme, orElse: () => Colors.blue);
  5. // 主题改变后,通知其依赖项,新主题会立即生效
  6. set theme(ColorSwatch color) {
  7. if (color != theme) {
  8. _profile.theme = color[500].value;
  9. notifyListeners();
  10. }
  11. }
  12. }

APP语言状态

当APP语言选为跟随系统(Auto)时,在系通语言改变时,APP语言会更新;当用户在APP中选定了具体语言时(美国英语或中文简体),则APP便会一直使用用户选定的语言,不会再随系统语言而变。语言状态类定义如下:

  1. class LocaleModel extends ProfileChangeNotifier {
  2. // 获取当前用户的APP语言配置Locale类,如果为null,则语言跟随系统语言
  3. Locale getLocale() {
  4. if (_profile.locale == null) return null;
  5. var t = _profile.locale.split("_");
  6. return Locale(t[0], t[1]);
  7. }
  8. // 获取当前Locale的字符串表示
  9. String get locale => _profile.locale;
  10. // 用户改变APP语言后,通知依赖项更新,新语言会立即生效
  11. set locale(String locale) {
  12. if (locale != _profile.locale) {
  13. _profile.locale = locale;
  14. notifyListeners();
  15. }
  16. }
  17. }