Android 视图绑定

300 阅读4分钟

Android架构组件是Android Jetpack的一部分。Jetpack是一套库、工具和指南,可帮助开发者更轻松地编写优质应用。这些组件可帮助我们遵循最佳做法、让我们摆脱编写样板代码的工作并简化复杂任务,以便将精力集中放在所需的代码上。Jetpack 包含与平台 API 解除捆绑的 androidx.* 软件包库。这意味着,它可以提供向后兼容性,且比Android平台的更新频率更高,以此确保始终可以获取最新且最好的 Jetpack 组件版本。

通过视图绑定功能,我们可以更轻松地编写可与视图交互的代码。在模块中启用视图绑定之后,系统会为该模块中的每个XML 布局文件生成一个绑定类。绑定类的实例包含对在相应布局中具有 ID 的所有视图的直接引用,在大多数情况下,视图绑定会替代 findViewById。

视图绑定功能可按模块启用。要在某个模块中启用视图绑定,请将viewBinding元素添加到其 build.gradle 文件中:

 apply plugin: 'kotlin-kapt'
 
  android {
    compileSdkVersion 29
    buildToolsVersion "29.0.2"
    
    viewBinding {
        enabled = true
    }
}

如果你试着在项目中使用了,那么你可能会得到下面的错误:

这是因为视图绑定这个功能我们只能在 Android Studio 3.6 Canary 11 及更高版本中可用。

如果你使用的Android Studio版本比这个低,那么我们同样可以使用Kotlin Android Extensions。

要想使用该功能我们需要在模块的 build.gradle 文件中启用 Gradle 安卓扩展插件即可:

apply plugin: 'kotlin-android-extensions'

假如我们有下面内容的布局文件activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/helloWorld"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

在使用的在Activity中使用下面语句进行导入指定布局文件中所有控件属性:

import kotlinx.android.synthetic.main.布局文件名称.*


import kotlinx.android.synthetic.main.activity_main.*

在使用的时候我们就不需要在使用findViewById()方法了,直接通过控件的id就可引用对应的控件。

helloWorld.text = "使用kotlin扩展"

如果在使用视图绑定的时候希望在生成绑定类时忽略某个布局文件,请将 tools:viewBindingIgnore="true" 属性添加到相应布局文件的根视图中:

为某个模块启用视图绑定功能后,系统会为该模块中包含的每个XML布局文件各生成一个绑定类。每个绑定类均包含对根视图以及具有ID的所有视图的引用。系统会通过以下方式生成绑定类的名称:将XML文件的名称转换为驼峰式大小写,并在末尾添加“Binding”一词。

每个绑定类还包含一个 getRoot() 方法,用于为相应布局文件的根视图提供直接引用。在此示例中,ResultProfileBinding 类中的 getRoot() 方法会返回 LinearLayout 根视图。

要获取生成的绑定类的实例,您可以调用其静态inflate()方法。通常情况下还会调用setContentView(),从而将该绑定类的根视图作为参数进行传递,以使它成为屏幕上的活动视图。

使用示例:

class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding;
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        binding.helloWorld.text = "视图绑定"
        setContentView(binding.root)
    }
}

视图绑定与使用 findViewById 相比,视图绑定具有一些很显著的优点:

  • Null 安全:由于视图绑定会创建对视图的直接引用,因此不存在因视图ID无效而引发Null指针异常的风险。此外,如果视图仅出现在布局的某些配置中,则绑定类中包含其引用的字段会使用 @Nullable 标记。

  • 类型安全:每个绑定类中的字段均具有与它们在 XML 文件中引用的视图相匹配的类型。这意味着不存在发生类转换异常的风险。 这些差异意味着布局和代码之间的不兼容性可能会导致编译版本在编译时(而非运行时)失败。