布景

好像汉语里的他、她、它,英语里的 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 时的文本表述。

Android 14 新特性:语法性别 Grammatical Gender

能够看到运用的是 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 的表述也相应地进行了更新。

Android 14 新特性:语法性别 Grammatical Gender

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 也不会有作用了。

Android 14 新特性:语法性别 Grammatical Gender

但好在该 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
 ...

咱们能够挑选运用 ConfigurationgetGrammaticalGender() 来获取新的 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 部分改写,不会有全体的重绘、闪耀。

Android 14 新特性:语法性别 Grammatical Gender

需求留心,如下两个方法是无效成功更新 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…