原文:How AndroidX changes the way we work with Activities and Fragments
作者:Miłosz Lewandowski
译者:Fly_with24
链接:https://juejin.im/post/5e5a0c316fb9a07cd248d29e
过去的一段时间,AndroidX 软件包下的 Activity/Fragmet 的 API 发生了很多变化。让我们看看它们是如何提升Android 的开发效率以及如何适应当下流行的编程规则和模式。
本文中描述的所有功能现在都可以在稳定的 AndroidX 软件包中使用,它们在去年均已发布或移至稳定版本。
在构造器中传入布局 ID
从 AndroidX AppCompat 1.1.0 和 Fragment 1.1.0 ( 译者注:AppCompat 包含 Fragment,且 Fragment 包含 Activity,详情见【整理】Jetpack 主要组件的依赖及传递关系 )开始,您可以使用将 layoutId 作为参数的构造函数:
class MyActivity : AppCompatActivity(R.layout.my_activity)class MyFragmentActivity: FragmentActivity(R.layout.my_fragment_activity)class MyFragment : Fragment(R.layout.my_fragment)
这种方法可以减少 Activity/Fragment 中方法重写的数量,并使类更具可读性。无需在 Activity 中重写 onCreate() 即可调用 setContentView() 方法。另外,无需手动在Fragment 中重写 onCreateView 即可手动调用 Inflater 来扩展视图。
扩展 Activity/Fragment 的灵活性
借助 AndroidX 新的 API ,可以减少在 Activity/Fragment 处理某些功能的情况。通常,您可以获取提供某些功能的对象并向其注册您的处理逻辑,而不是重写 Activity / Fragment 中的方法。这样,您现在可以在屏幕上组成几个独立的类,获得更高的灵活性,复用代码,并且通常在不引入自己的抽象的情况下,对代码结构具有更多控制。让我们看看这在两个示例中如何工作。
1. OnBackPressedDispatcher
有时,您需要阻止用户返回上一级。在这种情况下,您需要在 Activity 中重写 onBackPressed() 方法。但是,当您使用 Fragment 时,没有直接的方法来拦截返回。在 Fragment 类中没有可用的 onBackPressed() 方法,这是为了防止同时存在多个 Fragment 时发生意外行为。
但是,从 AndroidX Activity 1.0.0 开始,您可以使用 OnBackPressedDispatcher 在您可以访问该 Activity 的代码的任何位置(例如,在 Fragment 中)注册 OnBackPressedCallback。
class MyFragment : Fragment() {
override fun onAttach(context: Context) {
super.onAttach(context)
val callback = object : OnBackPressedCallback(true) {
override fun handleOnBackPressed() {
// Do something
}
}
requireActivity().onBackPressedDispatcher.addCallback(this, callback)
}
}
您可能会在这里注意到另外两个有用的功能:
OnBackPressedCallback 的构造函数中的布尔类型的参数有助于根据当前状态动态 打开/关闭按下的行为
addCallback() 方法的可选第一个参数是 LifecycleOwner,以确保仅在您的生命周期感知对象(例如,Fragment)至少处于 STARTED 状态时才使用回调。
通过使用 OnBackPressedDispatcher ,您不仅可以获得在 Activity 之外处理返回键的便捷方式。根据您的需要,您可以在任意位置定义 OnBackPressedCallback,使其可复用,或根据应用程序的架构进行任何操作。您不再需要重写Activity 中的 onBackPressed 方法,也不必提供自己的抽象的来实现需求的代码。
2. SavedStateRegistry
如果您希望 Activity 在终止并重启后恢复之前的状态,则可能要使用 saved state 功能。过去,您需要在 Activity 中重写两个方法:onSaveInstanceState 和 onRestoreInstanceState。您还可以在 onCreate 方法中访问恢复的状态。同样,在 Fragment 中,您可以使用onSaveInstanceState 方法(并且可以在 onCreate,onCreateView 和onActivityCreated方法中恢复状态)。
从 AndroidX SavedState1.0.0(它是 AndroidX Activity 和 AndroidX Fragment 内部的依赖。译者注:您不需要单独声明它)开始,您可以访问 SavedStateRegistry,它使用了与前面描述的 OnBackPressedDispatcher 类似的机制:您可以从 Activity / Fragment 中获取 SavedStateRegistry,然后 注册您的 SavedStateProvider:
class MyActivity : AppCompatActivity() {
companion object {
private const val MY_SAVED_STATE_KEY = "my_saved_state"
private const val SOME_VALUE_KEY = "some_value"
}
private lateinit var someValue: String
private val savedStateProvider = SavedStateRegistry.SavedStateProvider {
Bundle().apply {
putString(SOME_VALUE_KEY, someValue)
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
savedStateRegistry
.registerSavedStateProvider(MY_SAVED_STATE_KEY, savedStateProvider)
}
fun someMethod() {
someValue = savedStateRegistry
.consumeRestoredStateForKey(MY_SAVED_STATE_KEY)
?.getString(SOME_VALUE_KEY)
?: ""
}
}
如您所见,SavedStateRegistry 强制您将密钥用于数据。这样可以防止您的数据被 attach 到同一个 Activity/Fragment的另一个 SavedStateProvider 破坏。就像在 OnBackPressedDispatcher 中一样,您可以例如将 SavedStateProvider 提取到另一个类,通过使用所需的任何逻辑使其与数据一起使用,从而在应用程序中实现清晰的保存状态行为。
此外,如果您在应用程序中使用 ViewModel,请考虑使用 AndroidX ViewModel-SavedState 使你的ViewModel 可以保存其状态。为了方便起见,从 AndroidX Activity 1.1.0 和 AndroidX Fragment 1.2.0 开始,启用 SavedState 的SavedStateViewModelFactory 是在获取 ViewModel 的所有方式中使用的默认工厂:委托 ViewModelProvider 构造函数和 ViewModelProviders.of() 方法。
FragmentFactory
Fragment 最常提及的问题之一是不能使用带有参数的构造函数。例如,如果您使用 Dagger2 进行依赖项注入,则无法使用 Inject 注解 Fragment 构造函数并指定参数。现在,您可以通过指定 FragmentFactory 类来减少 Fragment 创建过程中的类似问题。通过在 FragmentManager 中注册 FragmentFactory,可以重写实例化 Fragment 的默认方法:
class MyFragmentFactory : FragmentFactory() {
override fun instantiate(classLoader: ClassLoader, className: String): Fragment {
// Call loadFragmentClass() to obtain the Class object
val fragmentClass = loadFragmentClass(classLoader, className)
// Now you can use className/fragmentClass to determine your prefered way
// of instantiating the Fragment object and just do it here.
// Or just call regular FragmentFactory to instantiate the Fragment using
// no arguments constructor
return super.instantiate(classLoader, className)
}
}
如您所见,该API非常通用,因此您可以执行想要创建 Fragment 实例的所有操作。回到 Dagger2 示例,例如,您可以注入FragmentFactory Provider <Fragment> 并使用它来获取 Fragment 对象。
测试 Fragment
从AndroidX Fragment 1.1.0 开始,可以使用 Fragment 测试组件提供 FragmentScenario 类,该类可以帮助在测试中实例化 Fragment 并进行单独测试:
// To launch a Fragment with a user interface:
val scenario = launchFragmentInContainer<FirstFragment>()
// To launch a headless Fragment:
val scenario = launchFragment<FirstFragment>()
// To move the fragment to specific lifecycle state:
scenario.moveToState(CREATED)
// Now you can e.g. perform actions using Espresso:
onView(withId(R.id.refresh)).perform(click())
// To obtain a Fragment instance:
scenario.onFragment { fragment ->
...
}
More Kotlin!
很高兴看到 -ktx AndroidX 软件包中提供了许多有用的 Kotlin 扩展方法,并且定期添加了新的方法。例如,在AndroidX Fragment-KTX 1.2.0 中,使用片段化类型的扩展名可用于 FragmentTransaction 上的 replace() 方法。将其与 commit() 扩展方法结合使用,我们可以获得以下代码:
// Before
supportFragmentManager
.beginTransaction()
.add(R.id.container, MyFragment::class.java, null)
.commit()
// After
supportFragmentManager.commit {
replace<MyFragment>(R.id.container)
}
FragmentContainerView
一件小而重要的事情。如果您将 FrameLayout 用作 Fragment 的容器,则应改用 FragmentContainerView 。它修复了一些动画 z轴索引顺序问题和窗口插入调度。从 AndroidX Fragment 1.2.0 开始可以使用 FragmentContainerView。