Flutter - 暗模式

Flutter是基于主题构建的,因此处理OS级暗模式非常简单。但这不是那么简单。您还必须:


  • 使自定义窗口小部件(或渐变或阴影之类的装饰)和非平台颤动窗口小部件(例如来自Google Maps的程序包)在所有主题中都可以接受。
  • 确保自定义窗口小部件(或装饰)在用户更改设备上的主题时正确更新。
  • 对于在较旧版本的操作系统上运行的用户以及更喜欢在单个应用程序上设置主题的用户,请进行适当的降级。

本文将讨论如何处理这些问题。我将提供示例代码。

本文中的信息来自许多来源,包括本文马特-卡罗尔,这也解释了颤如何支持深色模式本身在Android上。我希望在iOS 13发布后不久,即可在iOS上获得本机支持。它还包括Matthias Schuyten的这篇文章中的信息,其中详细介绍了如何设置Flutter Google Maps Plugin地图的样式。

黑暗模式就在这里;您的应用必须调整

iOS和Android的最新版本均具有暗模式。在测试为家人编写的Android / iOS NYC公交应用程序时,我不得不处理黑暗模式。当我第一次编写它时,系统范围内的暗模式并不是什么问题,而该应用程序是海洋或明亮的色彩。虽然该应用程序在iPhone和Android上均可正常运行,但在暗模式下的手机上使用该应用程序却令人震惊,尤其是在夜间户外。尽管Flutter进行了自动更新以支持暗模式的应用程序,但外部包装和自定义组件并不容易。在这种情况下,扑朔迷离的Google Maps包不会(也不应)通过平台级主题更改自动切换主题。应用程序中的彩色小部件需要针对不同的模式进行一些其他的重新设计。

除非您的应用是单色的,否则处理浅色或深色主题会很棘手,尤其是在彩色背景下的文本。请记住,当用户选择深色主题时,他们希望所有主要元素都变暗,而所有对比元素(例如文本和图标)都变亮。添加颜色使其变得棘手。我怀疑这就是Google移除应用程序所有品牌着色的原因(例如,中等深红色,#D44638和深红色辅助口音#B23121表示gmail),这是支持深色模式的第一步。将文本保持黑色以切换为浅色主题会产生难以阅读的标题:

让我们从确定暗模式对我们的应用程序的工作开始。我认为最好从一个角度进行研究:哪种方法最适合我们的用户?

应该如何运作?

除非用户特别关心,否则这不是您的用户应该考虑的事情;它应该易于理解和以他们期望的方式工作;并且应该隐藏任何复杂的逻辑。我们有一个适用于Google日历等生产应用程序的模型:主题首选项交叉的最简单版本很清楚:LIGHT,DARK和SYSTEM,默认为system。

我建议默认为系统有以下三个原因。首先,大多数关心明暗模式的用户已经使用该系统选择了首选模式。用户的默认首选项已定义。其次,对于有选择权而又不在乎的用户,系统的其他每个部分都使用系统值(通常为灯光模式)。第三,在不支持亮/暗主题的较旧版本的OS上运行时,它的作用与其他应用一样。

我们如何实现呢?让我们看一些Flutter代码。

(在Android上)暗模式已经可以在Flutter中工作

但是,您必须做一些工作才能启用它。如果在应用程序中使用MaterialApp类,则允许您自定义明暗主题作为应用程序定义的一部分。这些主题将链接到系统的明/暗模式设置。

@override
Widget build(BuildContext context) {
 return MaterialApp(
  title: 'App title',
  theme: ThemeData(),
  darkTheme: ThemeData.dark(),
  home: MyHomePage(),
 );
}

simple_theme.dart

您可以自定义每个主题的颜色和字体:

Widget build(BuildContext context) {
return MaterialApp(
 title: 'BusWatch',
 theme: ThemeData(
  brightness: Brightness.light,
  primarySwatch: Colors.orange,
 ),
 darkTheme: ThemeData(
  brightness: Brightness.dark,
  primarySwatch: Colors.orange
 ),
 home: MyHomePage(),
);
}

modified_theme.dart

如您所见,您可以根据需要修改默认主题,Flutter窗口小部件将进行自我更新以匹配系统。但这对自定义和自定义窗口小部件没有帮助。如果我们有一个带有深红色背景的小部件,并且在其顶部有一个文本小部件,该怎么办?当用户选择灯光模式时,默认的黑色文本将变得不可读。我们如何知道用户选择了什么亮度?

查询系统亮度

如果用户使用的是最新版本的Android,iOS或Fuschia,则我们想知道设备在平台级别上显示的主题。最安全的方法是使用上下文的媒体查询数据。如果返回Brightness.dark,则表示选择了暗模式。

final Brightness brightnessValue = MediaQuery.of(context).platformBrightness;
bool isDark = brightnessValue == Brightness.dark;

brightness_query.dart

如果要查询该级别的值,也可以直接从系统窗口获取平台亮度。您可以使用类似于以下代码

Window window = WidgetsBinding.instance.window;

(您永远不必真正执行此操作。如果您发现自己直接使用Window,则可能是做错了,还有一种更好的方法可以简化模拟和无头测试。在这种情况下,您可能应该使用MediaQuery。)

您可以在小部件初始化上检查并适当设置小部件值。但是,当用户更改为亮或暗模式(或者它在预定的时间自动发生,例如日落)时该怎么办?大多数小部件都会自动处理这些问题,但是您的自定义组件又如何,例如嵌入式地图或将不会更新的自定义装饰呢?他们怎么知道什么时候更新?

监听黑暗模式的变化

我们通常必须在应用程序的主要部分中,在平台级别上亲自听取主题更改。您可以在有状态的小部件中使用WidgetsBinding,该小部件将抽象的WidgetsBindingObserver子类化(作为混合)。

WidgetsBinding使您可以钩住通常的窗口小部件生命周期方法之外的更改,例如旋转电话或用户更改设备字体大小(例如,将手机交给需要较大字体的亲戚)。对于这种情况,它为平台亮度的变化提供了一个契机。您将小部件添加为initState()中的侦听器。当通过覆盖dispose()从窗口小部件树中永久删除窗口小部件的状态对象时,这确实需要释放引用。例如:

class _MyHomePageState extends State<MyHomePage> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
     WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangePlatformBrightness() {
    final Brightness brightness = 
    WidgetsBinding.instance.window.platformBrightness;
    //inform listeners and rebuild widget tree
  }

theme_listener.dart

Flutter的小部件会自动运行,我们可以安全地设置自定义小部件的值。但是外部小部件呢?我们如何定制它们?我将使用一个常见的软件包:Google Maps for Flutter。

在嵌入式Google地图中实现暗模式

Flutter最大的优势之一就是其开放的,受支持的软件包系统。通常,每种需求都有编写良好且维护良好的软件包。最好的之一(我已经在包括该项目在内的多个项目中使用过)是google maps软件包。默认的地图视图非常明亮,不会自动更新为主题更改。幸运的是,地图允许主题化。可以在这里找到关于这方面的优秀文章。

Google提供了一个主题化网络工具,可在https://mapstyle.withgoogle.com/上生成地图主题。

我使用该工具生成默认的明暗地图主题。地图使用json格式保存地图样式。您可以使用浮动资产加载实时加载地图定义。

首先,使用网络工具生成浅色和深色json样式的文件。将它们保存在资产文件夹中。您可以使用rootBundle将文件作为字符串加载:

@override
void initState() {
  super.initState();
  rootBundle.loadString('assets/dark_map_style.json').then((string) {
     _darkMapStyle = string;
  });
  rootBundle.loadString('assets/normal_map_style.json').then((string) {
     _normalMapStyle = string;
  });

load_styles.dart

加载地图并设置地图控制器后(通过onMapCreated设置),您可以在构建地图小部件时安全地使用样式:

@override
Widget build(BuildContext context) {
  bool isDark = MediaQuery.of(context).platformBrightness == Brightness.dark;
  if (mapController != null ) {
     if (isDark) {
        mapController.setMapStyle(_darkMapStyle);
     }
     else {
        mapController.setMapStyle(_normalMapStyle);
     }
  }
  //...

map_styles.dart

现在,地图会动态更新其样式以匹配系统。

因此,我们已负责更新应用程序以匹配设备的主题。但是,想要独立于系统设置应用程序主题的用户或使用旧版本操作系统的用户呢?我们如何独立设置主题?

独立于系统更改主题

独立设置主题实际上是两个选择(暗/亮),是我上面提到的三个选择的子集。在这种情况下,简单的UI效果很好。

但是我们要保存用户在会话之间的选择。有几种方法可以从属性文件,sqlite或远程执行此操作。在设计时就考虑到了这种用例。我建议使用“ 共享首选项”插件。(我不会远程存储亮/暗模式首选项;它是每个设备的首选项。)

保存主题首选项

要使用共享首选项,请导入“首选项”插件并创建一种安全获取引用的方法,您可以在应用启动时实例化该引用(可能在主窗口小部件状态的initState()中)。为主题值使用一个枚举。

其次,如果您想让系统主题更新的监听器,请定义一种方法来接收这些更新。在这种情况下,我使用了typedef PrefsListener。

在这种情况下,我关心的首选项是应用程序的主题:

static const String THEME_PREF = “AppTheme”;

然后,为其他类创建一个钩子,以侦听主题更新并注销(addListener()removeListener())。

示例首选项实现如下:

import 'package:shared_preferences/shared_preferences.dart';

enum Themes {
    DARK, LIGHT, SYSTEM
}

class Prefs {

    static const Map<Themes, String> themes = {
        Themes.DARK: "Dark", Themes.LIGHT : "Light", Themes.SYSTEM : "System"
    };

    Map<String, List<PrefsListener>> _listeners;

    factory Prefs.singleton() {
        return _instance;
    }

    static final Prefs _instance = Prefs._internal();

    SharedPreferences _prefs;
    bool _initialized = false;

    static const String THEME_PREF = "AppTheme";

    Prefs._internal() {
        _listeners = Map<String, List<PrefsListener>>();
        _getPrefs().then((prefs) {
            _initialized = true;
            for (String key in _listeners.keys) {
                List<PrefsListener> listeners = _listeners[key];
                if(listeners != null && listeners.isNotEmpty) {
                    Object value = prefs.get(key);
                    for (PrefsListener listener in listeners) {
                        listener(key, value);
                    }
                }
            }
        });
    }

    void addListenerForPref(String key, PrefsListener listener) {
        List<PrefsListener> list = _listeners[key];
        if (list == null) {
            list = List<PrefsListener>();
            _listeners[key] = list;
        }
        list.add(listener);
    }

    Future<SharedPreferences> _getPrefs() async {
        if (_prefs == null) {
            _prefs = await SharedPreferences.getInstance();
        }
        return _prefs;
    }

    String getTheme() {
        if (_initialized) {
            String theme = _prefs.getString(THEME_PREF);
            if (theme != null) {
                return theme;
            }
            else {
                _prefs.setString(THEME_PREF, themes[Themes.SYSTEM]); //ok not to wait
                return themes[Themes.SYSTEM];
            }
        }
        else {
            return themes[Themes.SYSTEM];
        }
    }

    //called when the user updates the operating system theme
    //(by choosing light or dark mode)
    void systemThemeUpdated(Brightness brightness) {
        if (isSystemTheme()) {
            String theme = getTheme();

            List<PrefsListener> listenerList = _listeners[THEME_PREF];
            if (listenerList != null) {
                for (PrefsListener listener in listenerList) {
                    listener(THEME_PREF, theme);
                }
            }
        }
    }

    ///set the app's theme preference from the 
    ///app's own UI
    void setTheme(String theme) {
        _getPrefs().then((prefs) {
            prefs.setString(THEME_PREF, theme);
        });
        List<PrefsListener> listenerList = _listeners[THEME_PREF];
        if (listenerList != null) {
            for (PrefsListener listener in listenerList) {
                listener(THEME_PREF, theme);
            }
        }
    }
}

typedef PrefsListener(String key, Object value);

prefs.dart

翻译自:https://medium.com/@pmutisya/dark-mode-in-flutter-3742062f9f59

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,776评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,527评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,361评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,430评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,511评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,544评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,561评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,315评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,763评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,070评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,235评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,911评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,554评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,173评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,424评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,106评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,103评论 2 352

推荐阅读更多精彩内容