升级目标API级别到35，以Android15为目标平台(三 View绑定篇)

---

🎯 什么是 kotlin-android-extensions

基本概念

kotlin-android-extensions 是 Kotlin 官方提供的一个 Android 插件，它允许开发者通过 kotlinx.android.synthetic 包直接访问 XML 布局文件中定义的 View，而无需使用 findViewById() 方法。

主要功能

• 自动生成 View 绑定代码：根据 XML 布局文件自动生成对应的 View 引用
• 类型安全：编译时检查 View 类型，避免运行时类型转换错误
• 简化代码：减少样板代码，提高开发效率

---

🔧 kotlin-android-extensions 的工作原理

编译时处理

1. 插件扫描：在编译时扫描 XML 布局文件
2. 代码生成：为每个布局文件生成对应的 synthetic 导入
3. 字节码注入：将生成的代码注入到 Kotlin 类中

生成的代码示例

// 原始代码
import kotlinx.android.synthetic.main.activity_main.*class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)// 直接使用 View，无需 findViewByIdtextView.text = "Hello World"button.setOnClickListener { /* ... */ }}
}

编译后生成的代码：

// 编译器自动生成的代码
class MainActivity : AppCompatActivity() {private var _$_findViewCache: Map<Int, View>? = nullprivate fun _$_findCachedViewById(id: Int): View? {if (_$_findViewCache == null) {_$_findViewCache = HashMap()}var view = _$_findViewCache!![id]if (view == null) {view = findViewById(id)_$_findViewCache!![id] = view}return view}// 为每个 View 生成属性val textView: TextViewget() = _$_findCachedViewById(R.id.textView) as TextViewval button: Buttonget() = _$_findCachedViewById(R.id.button) as Button
}

---

⚙️ 如何集成 kotlin-android-extensions

重要提示

⚠️ 从 Kotlin 1.4.20-M2 版本开始，kotlin-android-extensions 插件已被官方废弃。
如果您正在开始新项目，建议直接使用 View Binding。
以下内容仅供参考和维护旧项目使用。

版本要求

• Kotlin 版本：< 1.8.0
• Android Gradle Plugin 版本：≤ 4.2.2
• Gradle 版本：≤ 6.7.1

1. 在项目级 build.gradle 中配置

buildscript {ext.kotlin_version = '1.7.10' // 必须使用 1.8.0 以下版本dependencies {classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"// 不需要单独添加 kotlin-android-extensions，它包含在 kotlin-gradle-plugin 中}
}

2. 在模块级 build.gradle 中启用插件

// 旧版 Groovy DSL
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-android-extensions'// 或者使用新版 Kotlin DSL
plugins {id("kotlin-android")id("kotlin-android-extensions")
}

3. 配置实验性功能（可选）

如果需要使用 @Parcelize 等实验性功能：

androidExtensions {experimental = true
}

4. 兼容性说明

1. 版本限制：

   • 不支持 Kotlin 1.8.0 及以上版本
   • 不建议在新项目中使用
   • 与某些新版本的 Jetpack 库可能存在兼容性问题

2. 跨模块限制：

   • synthetic 导入在跨模块场景下无法工作
   • 存在一个自2018年1月就未解决的相关问题

3. IDE支持：

   • Android Studio 最新版本可能无法很好地支持此插件
   • 建议使用与项目 Kotlin 版本相匹配的 IDE 版本

5. 替代方案

如果您正在开始新项目，建议使用以下方案之一：

1. View Binding（推荐）：

   android {buildFeatures {viewBinding true}
   }
   

2. 传统 findViewById：

   private lateinit var textView: TextViewoverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)textView = findViewById(R.id.textView)
   }
   

---

📖 kotlin-android-extensions 的使用方法

1. 基本用法

// 导入布局文件的所有 View
import kotlinx.android.synthetic.main.activity_main.*class MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)// 直接使用 ViewtitleTextView.text = "Welcome"loginButton.setOnClickListener {// 处理点击事件}}
}

2. 导入特定 View

// 只导入特定的 View
import kotlinx.android.synthetic.main.activity_main.titleTextView
import kotlinx.android.synthetic.main.activity_main.loginButtonclass MainActivity : AppCompatActivity() {override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)titleTextView.text = "Welcome"loginButton.setOnClickListener { /* ... */ }}
}

3. 在 Fragment 中使用

import kotlinx.android.synthetic.main.fragment_home.*class HomeFragment : Fragment() {override fun onCreateView(inflater: LayoutInflater,container: ViewGroup?,savedInstanceState: Bundle?): View? {return inflater.inflate(R.layout.fragment_home, container, false)}override fun onViewCreated(view: View, savedInstanceState: Bundle?) {super.onViewCreated(view, savedInstanceState)// 在 Fragment 中使用recyclerView.adapter = adapterswipeRefreshLayout.setOnRefreshListener { /* ... */ }}
}

4. 在 RecyclerView.ViewHolder 中使用

import kotlinx.android.synthetic.main.item_user.view.*class UserViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {fun bind(user: User) {// 使用 itemView 前缀itemView.userNameTextView.text = user.nameitemView.userAvatarImageView.load(user.avatarUrl)}
}

5. 在自定义 View 中使用

import kotlinx.android.synthetic.main.custom_view.view.*class CustomView @JvmOverloads constructor(context: Context,attrs: AttributeSet? = null,defStyleAttr: Int = 0
) : FrameLayout(context, attrs, defStyleAttr) {init {inflate(context, R.layout.custom_view, this)// 直接使用 ViewtitleText.text = "Custom Title"actionButton.setOnClickListener { /* ... */ }}
}

---

✅ kotlin-android-extensions 的优缺点

优点

1. 简化代码：无需手动调用 findViewById()
2. 类型安全：编译时检查 View 类型
3. 性能优化：使用缓存机制，避免重复查找
4. 开发效率：减少样板代码，提高开发速度
5. IDE 支持：自动补全和重构支持

缺点

1. 全局导入：可能导致命名冲突
2. 编译时依赖：增加编译时间
3. 调试困难：生成的代码难以调试
4. 版本兼容性：与某些库可能存在兼容性问题
5. 废弃风险：已被官方废弃，不再维护

---

⚠️ 为什么需要迁移

官方废弃声明

• 废弃时间：2020年10月
• 废弃原因：View Binding 提供了更好的替代方案
• 维护状态：不再接收新功能和 bug 修复

技术债务

1. 安全风险：使用废弃的插件存在安全风险
2. 兼容性问题：与新版本 Android Gradle Plugin 可能存在兼容性问题
3. 性能影响：可能影响编译性能和运行时性能

现代化需求

1. View Binding：官方推荐的现代化解决方案
2. 类型安全：提供更好的类型安全保证
3. 空安全：支持 Kotlin 空安全特性

---

🚀 迁移到 View Binding

View Binding 的优势

1. 官方支持：Google 官方推荐
2. 类型安全：编译时类型检查
3. 空安全：支持 Kotlin 空安全
4. 性能优化：编译时生成代码，运行时性能更好
5. IDE 支持：更好的 IDE 支持

启用 View Binding

android {buildFeatures {viewBinding true}
}

基本用法对比

使用 kotlin-android-extensions：

import kotlinx.android.synthetic.main.activity_main.*class MainActivity : AppCompatActivity(