可為空的 CupertinoThemeData.brightness

CupertinoThemeData.brightness 現在可為空。

CupertinoThemeData.brightness 現在用於覆寫 Cupertino 元件 (Widget) 的 MediaQuery.platformBrightness。 在此變更之前，CupertinoThemeData.brightness getter 在被設為 null 時會回傳 Brightness.light。

過去 CupertinoThemeData.brightness 是以 getter 方式實作：

Brightness get brightness => _brightness ?? Brightness.light;
final Brightness _brightness;

它現在是一個儲存屬性：

final Brightness brightness;

一般來說，CupertinoThemeData.brightness 在 Flutter 框架之外很少會用到。 若要取得 Cupertino 元件 (Widget) 的亮度設定， 現在請改用 CupertinoTheme.brightnessOf。

隨著這項變更，現在可以在 CupertinoThemeData 的子類別中覆寫 CupertinoThemeData.brightness， 以變更亮度覆寫設定。例如：

class AlwaysDarkCupertinoThemeData extends CupertinoThemeData {
  Brightness brightness => Brightness.dark;
}

當 CupertinoTheme 使用上述 CupertinoThemeData 時， 所有受此 CupertinoTheme 影響的 Cupertino 元件 (Widget) 子孫都會啟用深色模式 (dark mode)。

合併於版本：1.16.3
穩定版發佈：1.17

設計文件：

• Make CupertinoThemeData.brightness nullable

API 文件：

• CupertinoThemeData.brightness

相關議題：

• Issue 47255

相關 PR：

• Let material ThemeData dictate brightness if cupertinoOverrideTheme.brightness is null