布景
好像汉语里的他、她、它,英语里的 He、She、it,许多言语都存在根据性别、对象不同而形成的语法差异,乃至不仅限于名词,还涉及到形容词、动词等,复杂得多。
而这部分言语所涉及到的人群多达 30 亿之众,如果文本只运用通用的、中性的表述,则显得不够准确。假使不加区分,乃至对女性运用男性化的表述方法,则体会更为糟糕。
所以如果 App 的界面言语能正确反映用户的语法性别,则就能够进步用户好感度、互动度,达到更个性化、更天然的用户体会。
这便是 Android 14 推出的重要新特性:语法性别 Grammatical Gender。
语法性别办理 API
首要,Android 14 推出了针对语法性别的 API:GrammaticalInflectionManager
,其提供了针对单个 App 获取、设置性别偏好的入口。
-
getApplicationGrammaticalGender():获取语法性别偏好,返回的是 Configuration 类中的 int 常量,有这么几种类型:
- GRAMMATICAL_GENDER_NOT_SPECIFIED, 0:没有指定性别偏好,将用默许的资源文本
- GRAMMATICAL_GENDER_NEUTRAL, 1:指定中性、客观的资源文本
- GRAMMATICAL_GENDER_FEMININE, 2:指定针对女性的资源文本
- GRAMMATICAL_GENDER_MASCULINE, 3:指定针对男性的资源文本
-
setRequestedApplicationGrammaticalGender():相对应的将上述常量类型动态设置到性别偏好
设置性别资源
反映语法性别的改变还得有根据语法性别装备的文本才行。而法语针对语法性别的差异比较典型,咱们挑选法语文本进行示例阐明。
比方咱们增加 res/values-fr-feminine 目录,在其 strings.xml 里增加针对女性的表述方法。
<resources>
...
<string name="example_string">Vous tes abonne ...</string>
</resources>
并增加 res/values-fr-masculine 目录,增加针对男性的表述方法。
<resources>
...
<string name="example_string">Vous tes abonn ...</string>
</resources>
在 res/values-fr 下的 strings.xml 里增加针对中性、客观的表述方法。
<resources>
...
<string name="example_string">Abonnement ...activ</string>
</resources>
另外在 values/strings.xml 增加默许的英文表述。
<resources>
<string name="example_string">You are subscribed to our store service</string>
</resources>
动态设置性别偏好
然后咱们增加个 TextView 来展现语法性别改变的作用,首要看一下默许 Gender 即 NOT_SPECIFIED 时的文本表述。
能够看到运用的是 values 下默许的英文表述。
然后,在 Button 点击里模拟各种性别偏好的动态更新。
class GenderActivity : AppCompatActivity() {
private lateinit var gIM: GrammaticalInflectionManager
private lateinit var binding: GenderLayoutBinding
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
Log.d("Gender", "onCreate()")
binding = GenderLayoutBinding.inflate(layoutInflater)
setContentView(binding.root)
gIM = getSystemService(GrammaticalInflectionManager::class.java)
updateCurrentGender()
binding.changeGender.setOnClickListener {
Log.d("Gender", "change Gender button tapped")
gIM.setRequestedApplicationGrammaticalGender(
gIM.applicationGrammaticalGender.nextGender()
)
updateCurrentGender()
}
}
private fun updateCurrentGender() {
gIM.applicationGrammaticalGender.genderToString().let {
Log.d("Gender", "current gender: $it")
binding.changeGender.text = "Grammatical gender:$it"
}
}
private fun Int.nextGender() =
when (this) {
Configuration.GRAMMATICAL_GENDER_NEUTRAL -> Configuration.GRAMMATICAL_GENDER_MASCULINE
Configuration.GRAMMATICAL_GENDER_MASCULINE -> Configuration.GRAMMATICAL_GENDER_FEMININE
Configuration.GRAMMATICAL_GENDER_FEMININE -> Configuration.GRAMMATICAL_GENDER_NOT_SPECIFIED
Configuration.GRAMMATICAL_GENDER_NOT_SPECIFIED -> Configuration.GRAMMATICAL_GENDER_NEUTRAL
else -> Configuration.GRAMMATICAL_GENDER_NEUTRAL
}
}
运行下看下改变作用,能够看到 Gender 在 NOT_SPECIFIED、NEUTRAL、MASCULINE 和 FEMININE 装备之间切换,TextView 的表述也相应地进行了更新。
Log 也展现了当时 Gender 和改变的记录:
ellisonchan@bogon AndroidUDemo % adb logcat -s Gender
06-16 17:47:33.160 D Gender : onCreate()
06-16 17:47:33.228 D Gender : current gender: Not specified
06-16 17:47:49.103 D Gender : change Gender button tapped
06-16 17:47:49.238 D Gender : onCreate()
06-16 17:47:49.261 D Gender : current gender: Neutral
06-16 17:47:49.325 D Gender : current gender: Neutral
06-16 17:47:55.771 D Gender : change Gender button tapped
06-16 17:47:55.845 D Gender : onCreate()
06-16 17:47:55.863 D Gender : current gender: Masculine
06-16 17:47:55.904 D Gender : current gender: Masculine
06-16 17:47:59.634 D Gender : change Gender button tapped
06-16 17:47:59.666 D Gender : onCreate()
06-16 17:47:59.683 D Gender : current gender: Feminine
06-16 17:47:59.742 D Gender : current gender: Feminine
06-16 17:48:01.735 D Gender : change Gender button tapped
06-16 17:48:01.773 D Gender : onCreate()
06-16 17:48:01.788 D Gender : current gender: Not specified
06-16 17:48:01.846 D Gender : current gender: Not specified
需求留心的是,上述作用需求将设备或 App 偏好言语设置成法语才干够看到作用。
还有个细节要注意,调用完 setRequestedApplicationGrammaticalGender 更新 Gender 后,经过 getApplicationGrammaticalGender() 的处理要稍微推迟一下,才干看到新的偏好,也能够理解,由于这个设置是 GrammaticalInflectionManager 体系服务通知的 App Context,这个进程是异步的。
class GenderActivity : AppCompatActivity() {
...
override fun onCreate(savedInstanceState: Bundle?) {
...
binding.changeGender.setOnClickListener {
...
gIM.setRequestedApplicationGrammaticalGender(
gIM.applicationGrammaticalGender.nextGender()
)
// 推迟一下再去获取最新 Gender 偏好
GlobalScope.launch(Dispatchers.Main) {
delay(50)
updateCurrentGender()
}
}
}
...
}
语法性别改变的重绘避免
上面的录屏、log 都能够看到 Gender 偏好改变之后 Activity 会产生重绘,由于它本质上也属于 Configuration 的范畴。和其他 Configuration change 一样,如有需求避免画面重启,能够在 Manifest 中装备。
<?xml version="1.0" encoding="utf-8"?>
<manifest ...>
...
<application...>
<activity
...
android:configChanges="grammaticalGender">
</activity>
</application>
</manifest>
可想而知,Activity 不自动改写,改了 Gender TextView 也不会有作用了。
但好在该 Gender 偏好跟着 onConfigurationChanged() 被传递了过来。
06-16 18:05:31.021 D Gender : onCreate()
06-16 18:05:31.021 D Gender : current gender: Not specified
06-16 18:06:33.023 D Gender : change Gender button tapped
06-16 18:06:33.229 D Gender : GenderActivity# onConfigurationChanged() new gender:Neutral
06-16 18:06:34.541 D Gender : change Gender button tapped
06-16 18:06:34.578 D Gender : GenderActivity# onConfigurationChanged() new gender:Masculine
...
咱们能够挑选运用 Configuration
中 getGrammaticalGender()
来获取新的 Gender 偏好,也能够运用上述的 GrammaticalInflectionManager
获取 API,两者得到的性别偏好结果是一致的。
class GenderActivity : AppCompatActivity() {
...
override fun onConfigurationChanged(newConfig: Configuration) {
super.onConfigurationChanged(newConfig)
Log.d("Gender", "GenderActivity# onConfigurationChanged()" +
" new gender:${newConfig.grammaticalGender.genderToString()}"
)
}
}
既然能够拿到新的 Gender,那么让 TextView 被迫改写即可,而改写的要害运用新的 Resources 获取当时 Gender Configuration 下的 text 去更新。
class GenderActivity : AppCompatActivity() {
...
override fun onConfigurationChanged(newConfig: Configuration) {
...
// Resources will be updated with new configuration
val newText = resources.getString(R.string.example_string)
Log.d("Gender", "onConfigurationChanged()" +
" new text:${resources.getString(R.string.example_string)}"
)
binding.textview.text = newText
}
}
能够看到这次只是 TextView 部分改写,不会有全体的重绘、闪耀。
需求留心,如下两个方法是无效成功更新 Gender 作用的:
- invalidate(),由于它只是触发从头测量、布局和描画,text 内容并无改变
- dispatchConfigurationChanged(),由于 TextView 的 onConfigurationChanged() 只针对 Locale、Typeface 进行了装备改写,没有针对 Gender 做更新
注意
即便在最新的 Release 版 AS 上,都是无法辨认上述语法性别资源目录的,会产生编译失利:
AndroidUDemo/app/src/main/res/values-fr-feminine: Error: Invalid resource directory name
得升级到 Android Studio Giraffe Canary 7 或更高的版别,才干支撑。
另外还得升级到最新的 AGP,笔者运用的版别组合是:Android Studio Hedgehog | 2023.1.1 Canary 7 + AGP 8.1.0-alpha07,供大家参阅。
DEMO 源码
github.com/ellisonchan…
参阅
- developer.android.com/about/versi…
- developer.android.com/studio/prev…
- developer.android.google.cn/reference/a…
- androidstudio.googleblog.com/2023/02/and…