AdroidX 下使用 Activity 和 Fragment 的变化

原文:How AndroidX changes the way we work with Activities and Fragments

作者:Miłosz Lewandowski

译者:Flywith24

在构造器中传入布局 ID

AndroidX AppCompat 1.1.0Fragment 1.1.0 ( 译者注:AppCompat 包含 Fragment,且 Fragment 包含 Activity,详情见【整理】Jetpack 主要组件的依赖及传递关系 )开始,您可以使用将 layoutId 作为参数的构造函数:

1
2
3
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

1
2
3
4
5
6
7
8
9
10
11
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 中重写两个方法:onSaveInstanceStateonRestoreInstanceState。 您还可以在 onCreate 方法中访问恢复的状态。 同样,在 Fragment 中,您可以使用onSaveInstanceState 方法(并且可以在 onCreateonCreateViewonActivityCreated方法中恢复状态)。

AndroidX SavedState 1.0.0(它是 AndroidX ActivityAndroidX Fragment 内部的依赖。译者注:您不需要单独声明它)开始,您可以访问 SavedStateRegistry,它使用了与前面描述的 OnBackPressedDispatcher 类似的机制:您可以从 Activity / Fragment 中获取 SavedStateRegistry,然后 注册您的 SavedStateProvider

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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.0AndroidX Fragment 1.2.0 开始,启用 SavedStateSavedStateViewModelFactory 是在获取 ViewModel 的所有方式中使用的默认工厂:委托 ViewModelProvider 构造函数和 ViewModelProviders.of() 方法。

FragmentFactory

Fragment 最常提及的问题之一是不能使用带有参数的构造函数。 例如,如果您使用 Dagger2 进行依赖项注入,则无法使用 Inject 注解 Fragment 构造函数并指定参数。 现在,您可以通过指定 FragmentFactory 类来减少 Fragment 创建过程中的类似问题。 通过在 FragmentManager 中注册 FragmentFactory,可以重写实例化 Fragment 的默认方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
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 并进行单独测试:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 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() 扩展方法结合使用,我们可以获得以下代码:

1
2
3
4
5
6
7
8
9
10
// 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


关于我


我是 Fly_with24

查看评论