DroidKit

自用工具库

功能：

• 多类型Adapter组装 (已完成，优化中)
• mvi，mvvm封装
• Base层封装
• 页面快速搭起框架
• others

使用介绍：

AdapterHolder使用姿势：

如何引入？

项目使用ksp生成代码，首先在根目录build.gradle.kts下引入ksp:

plugins {
    id("com.android.application") version "8.1.2" apply false
    id("org.jetbrains.kotlin.android") version "1.9.21" apply false
    id("com.google.devtools.ksp") version "1.9.21-1.0.15" apply false // ksp
}
tasks.register<Delete>("clean") {
    delete(rootProject.buildDir)
}

在根目录settings.gradle.kts下设置jitpack仓库：

pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
        maven("https://jitpack.io")
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}

在具体模块目录的build.gradle.kts引入依赖，将其中latest_version替换成最新版本：

plugins{
    // other plugin
    id("com.google.devtools.ksp")//使用ksp插件
}
android{
    //.....your android config
}
dependencies{
    implementation("com.github.RQ527.DroidKit:annotation:latest_version")
    implementation("com.github.RQ527.DroidKit:library:latest_version")
    ksp("com.github.RQ527.DroidKit:compiler:latest_version")
}

接下来是在项目中的具体使用方式：

首先创建Bean类，继承自BaseViewTypeItem：

data class TestBean(
    override val viewType: String,
    val content:String, override val id: Int
):BaseViewTypeItem()

实现BaseViewTypeAdapter或者直接使用DefaultViewTypeAdapter，如果需要ListAdapter可使用DefaultListAdapter或实现BaseViewTypeListAdapter：

class TestAdapter(
    override val holderFactory: HolderFactory = TestAdapterFactory.instance
) :
    BaseViewTypeAdapter<BaseViewTypeItem>() {
        //其他逻辑
        //....
}

实现BaseViewTypeHolder，给adapter传holder所支持的adapter，如果你的adapter没有任何其他逻辑可直接直接使用默认Adapter：DefaultListAdapter或DefaultViewTypeAdapter：

@AdapterHolder(adapters = [TestAdapter::class,DefaultViewTypeAdapter::class],viewTypes = ["test"])
class TestHolder(private val composeView: ComposeView) : BaseViewTypeHolder<TestBean>(composeView) {

    override fun onBind(data: TestBean) {
        composeView.setContent {
            Text(
                modifier = Modifier.fillMaxWidth(),
                text = data.content,
                textAlign = TextAlign.Center
            )
        }
    }
}

holder的rootView有三种，普通xml的itemView，composeView，viewBinding。以上是需要composeView的实现方式。当你需要itemView时，请提供LayoutProvider：

@AdapterHolder(
    adapters = [TestAdapter::class],
    viewTypes = ["text_type"],
    layoutProvider = TestHolder.HolderLayoutProvider::class
)
class TestHolder(itemView: View) :
    BaseViewTypeHolder<TestBean>(itemView) {
    private val mTextView: TextView = itemView.findViewById(R.id.rv_item_tv)

    class HolderLayoutProvider() : LayoutProvider {
        override fun getLayoutView(parent: ViewGroup): View =
            LayoutInflater.from(parent.context).inflate(R.layout.recycler_item, parent, false)

    }

    override fun onBind(data: TestBean) {
        mTextView.text = data.content
    }

}

需要注意的是内部会调用LayoutProvider的无参构造请保证其实现类有一个无参构造函数，LayoutProvider作为内部类外部类都无关系，只需有一个无参构造函数即可。如果你需要dataBinding，只需将其绑定到itemView。因为内部使用了ksp生成代码，无法为你提供在kapt生成的dataBinding。使用方式：

@AdapterHolder(
    adapters = [TestAdapter::class],
    viewTypes = ["text_type"],
    layoutProvider = TestHolder.HolderLayoutProvider::class
)
class TestHolder(itemView: View) :
    BaseViewTypeHolder<TestBean>(itemView) {
    private val binding: RecyclerItemBinding = RecyclerItemBinding.bind(itemView)

    class HolderLayoutProvider() : LayoutProvider {
        override fun getLayoutView(parent: ViewGroup): View =
            LayoutInflater.from(parent.context).inflate(R.layout.recycler_item, parent, false)
    }

    override fun onBind(data: TestBean) {
        binding.rvItemTv.text = data.content
    }

}

或者直接继承BaseBindingTypeHolder并提供binding类型，然后就能直接使用binding对象：

@AdapterHolder(
    adapters = [TestAdapter::class],
    viewTypes = ["text_type"],
    layoutProvider = TestHolder.HolderLayoutProvider::class
)
class TestHolder(itemView: View) :
    BaseBindingTypeHolder<RecyclerItemBinding,TestBean>(itemView) {

    class HolderLayoutProvider() : LayoutProvider {
        override fun getLayoutView(parent: ViewGroup): View =
            LayoutInflater.from(parent.context).inflate(R.layout.recycler_item, parent, false)
    }

    override fun onBind(data: TestBean) {
        binding.rvItemTv.text = data.content
    }

}

然后在Recyclerview层面（这里就暂且使用compose作为示例）：

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            DroidKitTheme {
                AndroidView(modifier = Modifier.fillMaxSize(), factory = { context ->
                    RecyclerView(context).apply {
                        adapter = TestAdapter().apply {
                            setItemList(
                                mutableListOf(
                                    TestBean("test","我是item1",1),
                                    TestBean("test", "我是item2",2),
                                    TestBean("text_type", "我是item3",3),
                                    TestBean("text_type","我是item4",4)
                                )
                            )
                        }
                        layoutManager = LinearLayoutManager(context)
                    }
                })
            }
        }
    }
}

当然这里的dataList的成员可以是任何BaseViewTypeItem的子类。只要能与holder所需的data数据类相匹配即可。

AdapterHolder支持一个Holder对多个Adapter，拥有多个类型viewType，将其适用的Adapter全部传入adapters，适用的viewType全部传入viewTypes即可，

@Retention(AnnotationRetention.BINARY)
@Target(AnnotationTarget.CLASS)
annotation class AdapterHolder (
    val viewTypes:Array<String> = [],
    val adapters:Array<KClass<out RecyclerView.Adapter<out RecyclerView.ViewHolder>>> = [],
    val layoutProvider:KClass<out LayoutProvider> = LayoutProvider::class,
)

adapter默认使用字符的hashcode作为int类型的viewType传给adapter，如需自定义可实现adapter的getIntViewTypeByString函数。

TODO

..........