Android Studio ViewBinding绑定视图控件

Android 中 ViewBinding(视图绑定)的具体用法,这是替代 findViewById 的官方推荐方案,能让你更安全、更高效地访问布局中的控件

ViewBinding 的核心优势是编译时类型安全(避免因控件 id 写错导致运行时崩溃)、无需手动强转控件类型,且使用简单。下面分步骤讲解完整用法。

一、第一步:启用 ViewBinding

首先需要在项目的 build.gradle 中开启 ViewBinding 功能,不同 Android Gradle 插件版本配置略有差异,这里提供通用写法:

1. 模块级 build.gradle(app 目录下)
Kotlin 复制代码
android {
    ...
    buildFeatures {
        // 启用 ViewBinding
        viewBinding true
        // 如果同时用了 DataBinding,需要这样写:
        // dataBinding true
        // viewBinding true
    }

    // 可选:排除某些布局不生成 ViewBinding 类(比如测试布局)
    // viewBinding {
    //     exclude "layout/activity_test.xml"
    // }
}

注意:配置完成后,点击 Sync Now 同步项目,Android Studio 会自动为每个布局文件生成对应的 Binding 类(比如 activity_main.xml 生成 ActivityMainBinding)。(Sync Now在页面左上方)

二、第二步:在 Activity 中使用 ViewBinding

activity_main.xml 为例,演示 Activity 中如何使用 ViewBinding 访问控件:

1. 基础用法(最常用)
Kotlin 复制代码
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
// 导入自动生成的 Binding 类(AS 会自动提示)
import com.example.yourprojectname.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() {
    // 声明 Binding 对象(lateinit 表示延迟初始化)
    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // 1. 初始化 Binding 对象,替代 setContentView
        binding = ActivityMainBinding.inflate(layoutInflater)
        // 2. 获取根布局并设置为 Activity 内容
        setContentView(binding.root)

        // 3. 直接通过 binding.控件id 访问控件(无需 findViewById)
        // 比如布局中有一个 id 为 tv_title 的 TextView、id 为 btn_click 的 Button
        binding.tvTitle.text = "ViewBinding 测试标题"
        binding.btnClick.setOnClickListener {
            // 点击事件
            binding.tvTitle.text = "按钮被点击了!"
        }
    }
}
2. 关键说明
  • 生成的 Binding 类命名规则:布局文件名去掉下划线,首字母大写 + Binding(比如 fragment_home.xmlFragmentHomeBinding)。
  • binding.root 对应布局的根控件(比如 LinearLayout/ConstraintLayout),等价于 setContentView(R.layout.activity_main)
  • 控件访问:布局中控件的 id 是 tv_title,Binding 类中会自动转为驼峰命名 tvTitle,直接通过 binding.tvTitle 访问。
相关推荐
hai_android43 分钟前
Kotlin / Android 常用函数使用示例手册
android·java·kotlin
hai_android2 小时前
Android MeasureSpec 详解
android·java·kotlin
又见情义4 小时前
RK3568 Android 13 本地 U 盘 OTA 升级实战:基于 RKUpdateService 的完整流程
android
Godikov5 小时前
Android10后台弹窗与APK自动更新
android
又见情义6 小时前
RK3568 Android 13 USB OTG/Host 切换调试经验分享
android
终端安全笔记7 小时前
iOS 27 之后「策略空转」:设备升级不报错,但旧策略不再管它
android·网络·安全·ios·智能手机
JMchen8 小时前
实战案例:实现120fps流畅的渐变进度条
android·kotlin·canvas
敲代码的瓦龙8 小时前
Jetpack?DataBinding!!!
android·java·开发语言·mysql·android-studio
Android-Flutter10 小时前
Compose CompositionLocal 详解
android·compose
三少爷的鞋11 小时前
Kotlin 协程闯关:看代码,猜结果
android