Android端末は自身の置かれている状況を認識して、ユーザーが使い易いように動作を変える仕組みを持ちます。

uiModeのNight（UI_MODE_NIGHT_YES：夜である）とDay（UI_MODE_NIGHT_NO：昼である） は、その「置かれている状況」の一つです。

NightとDayは古くから定義されているモードです。

API29で追加された機能の「Dark Theme」と結びついて、Night Modeの時はDark Themeにする使い方が定番になってしまいました。

その影響でしょうか…

Settingsアプリを見ると、Night Modeの影が薄れて、「Drak Themeにする・しない」が主題に作られています。

しかし、裏にNight Modeが存在していることを忘れてはいけません。

※環境：Android Studio Jellyfish | 2023.3.1
　　　　Kotlin 1.9.0
　　　　Compose Compiler 1.5.1
　　　　androidx.compose.foundation:foundation 1.5.0

Dark Theme（Light Theme）とは

Dark Theme（Light Theme）は、画面の配色を定義したテーマです。

背景を暗い配色にするテーマです。画面の全体的な輝度が抑えられます。

以下の利点があります。

背景を明るい配色にするテーマです。画面の全体的な輝度が上げられます。

以下の利点があります。

【Dark Theme】

【Light Theme】

Night Mode（Day Mode）とは

Night Mode（Day Mode）は、端末の置かれている状況を表すモードです。

夜を表すモードです。太陽は沈み、周囲は暗いと判断されます。

昼を表すモードです。太陽は昇り、周囲は明るいと判断されます。

【Night Mode】

【Day Mode】

両者の関係

ユーザーエクスペリエンス（使い心地）を向上させるために、（a）画面の見やすさを優先して、次のようにするのが普通です。

また、（b）アプリの省電力化を優先して、Night/Day Modeに関係なく、表示をDark Themeに固定する場合もあります。

Dark Themeの切り替え

Android Studioが作成するプロジェクトのテンプレートは、isSystemDarkTheme( )関数が出力するフラグ（true：Night Mode、false：Day Mode）に従って、テーマの切り替え（コード中のwhen部）が行われます。

...

@Composable
fun MyApplicationTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    // Dynamic color is available on Android 12+
    dynamicColor: Boolean = true,
    content: @Composable () -> Unit
) {
    val colorScheme = when {
        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
            val context = LocalContext.current
            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
        }

        darkTheme -> DarkColorScheme
        else -> LightColorScheme
    }

    MaterialTheme(
        colorScheme = colorScheme,
        typography = Typography,
        content = content
    )
}

切り替えはisSystemDarkTheme( )関数の出力のみに依存しています。

Night Modeの切り替え

表はNight Modeの切り替えをまとめたものです。非常に複雑です。

切り替えの結果がisSystemdarkTheme( )関数の出力（true：Night Mode、false：Day Mode）に反映されます。

ポイントは、対象により切り替えの方法が異なる点と、タイプにより切り替えの時刻が異なる点です。

切り替えの対象

切り替えの対象は3つに分類できます。影響を受ける範囲が異なります。

切り替えのタイプ

手動の他に、時刻に連動して自動で行うモードがあります。

切り替えの詳細

切り替えの詳細は以下のリンクを参照してください。

関連記事：