Android 14 新功能：区域偏好 Regional Preferences

news2024/11/16 5:40:49

在这里插入图片描述

翻译自 https://alexzh.com/regional-preferences-in-android-14/

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9YLBwPZs-1687502002096)(/Users/ellisonchan/Nutstore Files/ellison-wiki/docs/文章输出/原创/locale/android14-base-locale.png)]

背景
获取区域偏好设置

2.1 获取温度单位

2.2 获取一周首日

2.3 获取小时周期

2.4 获取日历类型
示例
结语

1. 背景

Android 14 的 Settings 中新增了区域偏好的设置画面，让用户可以设置具体的区域习惯，包括：

温度单位
一周首日

本篇文章基于 Android 14 Beta 2。

这项特性很适合那些使用某区域习惯而居住的地方是另一套习惯的人群，比如习惯了温度单位为华氏的外国人居住在中国，他希望天气、地图 App 能展示华氏单位，而非系统默认的摄氏单位。

利用这项特性，可以设置区别于系统语言的特定温度单位、一周首日以及小时周期等区域偏好。

具体的，可以在 Settings > System > Languages 中可以看到 Regional Preferences 的菜单入口。

2. 获取区域偏好设置

我们可以使用全新的 LocalePreferences API 获取如下偏好数据：

温度单位
一周首日
小时周期
日历类型

这个 API 存在于 AndroidX 包中，想要使用的话，需要集成 androidx.core:core-ktx 的依赖，版本在 1.12.0-alpha01 及以上。

如下链接可以找到 core-ktx 的所有版本：

https://developer.android.com/jetpack/androidx/releases/core?ref=alexzh.com

dependencies {
    ...
    implementation "androidx.core:core:1.12.0-alpha04"
}

2.1 获取温度单位

利用 LocalePreferences 提供的 getTemperatureUnit() 可以返回代表当前选择的温度单位的 String 类型：

“celsius” (°C)

“fahrenhe” (°F)

同时也提供了其他函数来获取指定区域的温度单位：

getTemperatureUnit(Locale locale)
getTemperatureUnit(Locale locale, boolean resolved)

拿到温度单位的字符串之后，还可以和 SDK 提供的温度单位 Class TemperatureUnit 中的常（比如华氏的 FAHRENHEIT）量进行 mapping、对比。下面的链接可以看到所有的常量定义：

https://developer.android.com/reference/androidx/core/text/util/LocalePreferences.TemperatureUnit?ref=alexzh.com

2.2 获取一周首日

getFirstDayOfWeek() 则返回代表当前选择的一周首日偏好：

“sun” - Sunday
“mon” - Monday
“tue” - Tuesday
“wed” - Wednesday
“thu” - Thursday
“fri” - Friday
“sat” - Saturday

获取指定区域的一周首日偏好的函数：

getFirstDayOfWeek(Locale locale)
getFirstDayOfWeek(Locale locale, boolean resolved)

可以和 SDK 提供的 FirstDayOfWeek class 中的常量（比如 MONDAY，周一）进行 mapping、对比。下面的链接可以看到所有的常量定义：

https://developer.android.com/reference/androidx/core/text/util/LocalePreferences.FirstDayOfWeek?ref=alexzh.com

2.3 获取小时周期

getHourCycle() 则用来获取当前区域的小时周期偏好，具体包括如下几种字符串：

“h11” - 12 Hour System (0-11)
“h12” - 12 Hour System (1-12)
“h23” - 24 Hour System (0-23)
“h24” - 24 Hour System (1-24)

一样的，如下函数可以获取指定区域的小时周期偏好：

getHourCycle(Locale locale)
getHourCycle(Locale locale, boolean resolved)

可以用 HourCycle class 包含的常量和上述字符串进行对比。下面的链接可以看到所有的常量定义：

https://developer.android.com/reference/androidx/core/text/util/LocalePreferences.HourCycle?ref=alexzh.com

2.4 获取日历类型

getCalendarType() 则用来获取当前区域的日历类型偏好：

“chinese” - Chinese Calendar
“dangi” - Dangi Calendar (Korea Calendar)
“gregorian” - Gregorian Calendar
“hebrew” - Hebrew Calendar
“indian” - Indian National Calendar
“islamic” - Islamic Calendar
“islamic-civil” - Islamic Calendar (tabular, civil epoch)
“islamic-rgsa” - Islamic Calendar (Saudi Arabia, sighting)
“islamic-tbla” - Islamic Calendar (tabular, astronomical epoch)
“islamic-umalqura” - Islamic Calendar (Umm al-Qura)
“persian” - Persian Calendar

获取指定区域的日历类型的函数：

getCalendarType(Locale locale)
getCalendarType(Locale locale, boolean resolved)

相同的，CalendarType 类中的常量可以用来和字符串进行对比。下面的链接可以看到所有的常量定义：

https://developer.android.com/reference/androidx/core/text/util/LocalePreferences.CalendarType?ref=alexzh.com

3. 示例

比较不同区域偏好值的最简单办法是创建一个 BroadcastReceiver，当监听到区域变更（从 Settings > System > Languages > System Languages 中操作）的时候，通过 LocalePreferences API 来打印新区域的偏好值。

class LocaleReceiver : BroadcastReceiver() {
    @RequiresApi(Build.VERSION_CODES.TIRAMISU)
    override fun onReceive(context: Context, intent: Intent) {
        val localePreferenceData = """
            getTemperatureUnit: ${LocalePreferences.getTemperatureUnit()}
            getFirstDayOfWeek: ${LocalePreferences.getFirstDayOfWeek()}
            getHourCycle: ${LocalePreferences.getHourCycle()}
            getCalendarType: ${LocalePreferences.getCalendarType()}
        """.trimIndent()

        Log.d("New locale prefs values", localePreferenceData)
    }
}

下一步是在 AndroidManifest.xml 文件里声明上述 LocaleReceiver。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  ...
    <application
    ...>
    <receiver
        android:name=".LocaleReceiver"
        android:enabled="true"
        android:exported="true">
        <intent-filter>
        <action android:name="android.intent.action.LOCALE_CHANGED" />
        </intent-filter>
    </receiver>
        ...
    </application>
</manifest>