Google 在 Android Studio 3.6 Canary 11
及更高版本中提供了一个 viewBinding
的开关,可以开启视图绑定功能,以此来替代 findViewById
。
viewBinding功能可按模块启用。要在某个模块中启用viewBinding,请将 viewBinding
元素添加到其 build.gradle
文件中,如下例所示:
android {
...
viewBinding {
enabled = true
}
}
如果您希望在生成绑定类时忽略某个布局文件,请将 tools:viewBindingIgnore="true"
属性添加到相应布局文件的根视图中:
<LinearLayout
...
tools:viewBindingIgnore="true" >
...
</LinearLayout>
为某个模块启用视图绑定功能后,系统会为该模块中包含的每个 XML 布局文件生成一个绑定类。每个绑定类均包含对根View以及具有 ID 的所有View的引用。系统会通过以下方式生成绑定类的名称:将 XML 文件的名称转换为驼峰式大小写,并在末尾添加“Binding”。
例如,假设某个布局文件的名称为 result_profile.xml
:
<LinearLayout ... >
<TextView android:id="@+id/name" />
<ImageView android:cropToPadding="true" />
<Button android:id="@+id/button"
android:background="@drawable/rounded_button" />
</LinearLayout>
所生成的绑定类的名称就为 ResultProfileBinding
。此类具有两个字段:一个是名为 name
的 TextView
,另一个是名为 button
的 Button
。该布局中的 ImageView
没有 ID,因此绑定类中不存在对它的引用。
每个绑定类还包含一个 getRoot()
方法,用于为相应布局文件的根View提供直接引用。在此示例中,ResultProfileBinding
类中的 getRoot()
方法会返回 LinearLayout
根视图。
如需设置绑定类的实例以供 Activity 使用,请在 Activity 的 onCreate()
方法中执行以下步骤:
inflate()
方法。此操作会创建该绑定类的实例以供 Activity 使用。getRoot()
方法或使用 Kotlin 属性语法获取对根View的引用。setContentView()
,使其成为屏幕上的活动View。 private lateinit var binding: ResultProfileBinding
override fun onCreate(savedInstanceState: Bundle) {
super.onCreate(savedInstanceState)
binding = ResultProfileBinding.inflate(layoutInflater)
val view = binding.root
setContentView(view)
}
然后即可使用该绑定类的实例来引用任何View控件:
binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }
如需设置绑定类的实例以供 Fragment 使用,请在 Fragment 的 onCreateView()
方法中执行以下步骤:
inflate()
方法。此操作会创建该绑定类的实例以供 Fragment 使用。getRoot()
方法或使用 Kotlin 属性语法获取对根View的引用。onCreateView()
方法返回根View,使其成为屏幕上的活动View。 private var _binding: ResultProfileBinding? = null
// This property is only valid between onCreateView and onDestroyView.
private val binding get() = _binding!!
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
_binding = ResultProfileBinding.inflate(inflater, container, false)
val view = binding.root
return view
}
override fun onDestroyView() {
super.onDestroyView()
_binding = null
}
然后即可使用该绑定类的实例来引用任何View控件:
binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }
注意:inflate()
方法会要求传入LayoutInflater
对象。如果布局已经inflated
,则可以调用绑定类的静态 bind()
方法。 例如:
/**
* View Binding example with a fragment that uses the alternate constructor for inflation and
* [onViewCreated] for binding.
*/
class BindFragment : Fragment(R.layout.fragment_blank) {
// Scoped to the lifecycle of the fragment's view (between onCreateView and onDestroyView)
private var fragmentBlankBinding: FragmentBlankBinding? = null
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
val binding = FragmentBlankBinding.bind(view)
fragmentBlankBinding = binding
binding.textViewFragment.text = getString(string.hello_from_vb_bindfragment)
}
override fun onDestroyView() {
// Consider not storing the binding instance in a field, if not needed.
fragmentBlankBinding = null
super.onDestroyView()
}
}
注意:Fragment 的存在时间比其视图长。请务必在 Fragment 的
onDestroyView()
方法中清除对绑定类实例的所有引用。
与使用 findViewById
相比,viewBinding
具有一些很显著的优点:
@Nullable
标记。这些差异意味着布局和代码之间的不兼容将会导致构建在编译时(而非运行时)失败。
viewBinding和dataBinding 均会生成可用于直接引用视图的绑定类。但是,viewBinding旨在处理更简单的用例,与dataBinding 相比,具有以下优势:
反过来,与 dataBinding 相比,viewBinding 也具有以下限制:
viewBinding 还有一个重要作用是替代以前的 Kotlin Android Extensions,在之前的kotlin版本中提供了一个针对android的扩展插件,它可以允许我们直接用布局文件中的 view id 来访问 view,也无需写 findViewById。
但是由于 KAE 存在一些潜在的 bug (例如可以访问到不属于当前Activity布局的view id造成空指针异常等), 从 Kotlin 1.7 开始,KAE被正式移除了。
那么 viewBinding 的出现也是为了弥补之前 KAE 的功能和缺陷。
最后,viewBinding 只是针对传统 View 体系的开发,在进入 Jetpack Compose 的世界以后,这项功能就基本无用武之地了。