【Kotlin】Kotlin 中使用 ButterKnife ( 仅用于适配 Kotlin 语言

文章目录

I . 特别注意 : ButterKnife 已停止维护 ( 新项目禁止使用该框架 )
II . Android Studio 中配置 Kotlin 和 ButterKnife 步骤
III . Android Studio 中配置 Kotlin 和 ButterKnife 示例
IV . Kotlin 注解错误使用
V . 错误处理导入库冲突 ( 与 androidx 冲突 )

I . 特别注意 : ButterKnife 已停止维护 ( 新项目禁止使用该框架 )

1 . 情况说明 : ButterKnife 已经停止维护 , 新项目直接使用 视图绑定 , 数据绑定 进行开发 , 本篇博客只是为了适配老版本项目 ;

2 . 当前需求 : 目前的需求是保证之前的 Java 代码能平稳运行 , 基本框架不变 , 在 Kotlin 中使用 ButterKnife 进行视图绑定操作 ;

II . Android Studio 中配置 Kotlin 和 ButterKnife 步骤

1 . Kotlin 配置 : 不再详细说明 , 创建项目时 , 选择支持 Kotlin 即可 ;

2 . ButterKnife 配置 : ButterKnife 只需要在 Module 下的 build.gradle 构建脚本中配置 ,

① 配置依赖库 : 在 Module 下的 build.gradle 的 dependencies 中进行如下配置 ;

/** androidx 依赖与老版本的 butterknife 冲突 */
implementation 'com.jakewharton:butterknife:10.0.0'
kapt 'com.jakewharton:butterknife-compiler:10.0.0'

② 应用插件 : 在 Module 下的 build.gradle 顶部添加如下配置 ;

apply plugin: 'kotlin-kapt'

3 . 注解使用 :

① 组件定义 : 这里注意 , 只能使用下面的两种方式 , 其它方式会报错 ;

@BindView(R.id.tv_1)
lateinit var tv_1 : TextView@JvmField
@BindView(R.id.tv_2)
var tv_2 : TextView? = null

② 视图绑定 : 使用 ButterKnife.bind(this) 绑定定义的组件 , 与 Java 中操作一样 ;

override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)ButterKnife.bind(this)
}

III . Android Studio 中配置 Kotlin 和 ButterKnife 示例

GitHub 示例 : https://github.com/han1202012/Kotlin_ButterKnife

1 . 工程下的 build.gradle 构建脚本 :

// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript {ext.kotlin_version = '1.3.71'repositories {google()jcenter()}dependencies {classpath 'com.android.tools.build:gradle:3.6.1'classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"// NOTE: Do not place your application dependencies here; they belong// in the individual module build.gradle files}
}allprojects {repositories {google()jcenter()}
}task clean(type: Delete) {delete rootProject.buildDir
}

2 . Module 下的 build.gradle 脚本 :

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-android-extensions'
apply plugin: 'kotlin-kapt'android {compileSdkVersion 29buildToolsVersion "29.0.2"defaultConfig {applicationId "kim.hsl.kb"minSdkVersion 24targetSdkVersion 29versionCode 1versionName "1.0"testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"}buildTypes {release {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'}}}dependencies {implementation fileTree(dir: 'libs', include: ['*.jar'])implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"implementation 'androidx.appcompat:appcompat:1.1.0'implementation 'androidx.core:core-ktx:1.0.2'implementation 'androidx.constraintlayout:constraintlayout:1.1.3'testImplementation 'junit:junit:4.12'androidTestImplementation 'androidx.test.ext:junit:1.1.1'androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'/** androidx 依赖与老版本的 butterknife 冲突 */implementation 'com.jakewharton:butterknife:10.0.0'kapt 'com.jakewharton:butterknife-compiler:10.0.0'
}

3 . Kotlin 代码的 Activity 中使用 ButterKnife 注解 : 注意只能使用下面的两种方式 ;

package kim.hsl.kbimport android.app.Activity
import android.os.Bundle
import android.util.Log
import android.widget.TextView
import butterknife.BindView
import butterknife.ButterKnifeclass MainActivity : Activity() {@BindView(R.id.tv_1)lateinit var tv_1 : TextView@JvmField@BindView(R.id.tv_2)var tv_2 : TextView? = nulloverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)ButterKnife.bind(this)Log.i("TAG", tv_1?.text.toString())Log.i("TAG", tv_2?.text.toString())}
}

IV . Kotlin 注解错误使用

1 . 报错内容 :

@BindView fields must not be private or static. (kim.hsl.kb.MainActivity.tv_2)private android.widget.TextView tv_2;

2 . 报错原因 : 使用了如下声明方式 , @BindView(R.id.tv_2) var tv_2 : TextView? = null ;

3 . 只能使用下面两种声明方式 : ① 使用 lateinit 修饰变量 , ② 使用 @JvmField 注解 ;

@BindView(R.id.tv_1)
lateinit var tv_1 : TextView@JvmField
@BindView(R.id.tv_2)
var tv_2 : TextView? = null

V . 错误处理导入库冲突 ( 与 androidx 冲突 )

1 . 报错信息如下 :

The given artifact contains a string literal with a package reference 'android.support.v4.content'
that cannot be safely rewritten. Libraries using reflection such as annotation processors need to
be updated manually to add support for androidx.

2 . 报错原因 : 引入了 androidx 包依赖 , 与低版本的 butterknife 产生了冲突 , 二者不能同时使用 ;

Static interface methods are only supported starting with Android N (--min-api 24):
void butterknife.Unbinder.lambda$static$0()

3 . 总结 : 坑有点多 , 新应用能不用 ButterKnife 就不用 , 10.0.0 版本的 butterknife 必须要求 android-24 以上最低兼容版本 , 对于商业项目来说 , 这是不可接受的 ;

4 . 推荐用法 : 老版本应用 ( 没有使用 androidx ) 继续使用老版本的 ButterKnife , 新版本的应用就别用这个框架了 , 使用 JetPack 中的视图 / 数据绑定 ;

① 老项目 : 没有使用 androidx 依赖 , 可以使用低版本的 ButterKnife , 这也是唯一的途径了 ;

dependencies {implementation fileTree(dir: 'libs', include: ['*.jar'])implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"testImplementation 'junit:junit:4.12'/** androidx 依赖与老版本的 butterknife 冲突 */implementation 'com.jakewharton:butterknife:8.8.1'kapt 'com.jakewharton:butterknife-compiler:8.8.1'
}

② 新项目 : 如果使用了 androidx 依赖 , 必须使用高版本的 ButterKnife , 只能兼容 24 以上的最小版本 ; ( 商业项目用了就废了 )

dependencies {implementation fileTree(dir: 'libs', include: ['*.jar'])implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"implementation 'androidx.appcompat:appcompat:1.1.0'implementation 'androidx.core:core-ktx:1.0.2'implementation 'androidx.constraintlayout:constraintlayout:1.1.3'testImplementation 'junit:junit:4.12'androidTestImplementation 'androidx.test.ext:junit:1.1.1'androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'/** androidx 依赖与老版本的 butterknife 冲突 */implementation 'com.jakewharton:butterknife:10.0.0'kapt 'com.jakewharton:butterknife-compiler:10.0.0'
}

目前使用了 ButterKnife 的应用 , 无法迁移到 JetPack ;

GitHub 示例 : https://github.com/han1202012/Kotlin_ButterKnife