Android Extras Delegates 使用教程

1、项目介绍

Android Extras Delegates 是一个由 Kotlin 编写的库，旨在简化 Android 开发中 Intent 和 Bundle 的额外信息（extras）处理。该库通过 Kotlin 的属性委托（property delegates）提供了一组方便的工具，帮助开发者以更简洁、优雅的方式管理和获取 Intent 或 Bundle 的 extra 数据。

2、项目快速启动

添加依赖

首先，在你的项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'me.eugeniomarletti:android-extras-delegates:1.0.0'
}

定义 Intent 的 extra

你可以这样定义一个 Intent 的 extra：

object IntentOptions {
    var Intent.someExtra by IntentExtra<String>()
}

访问 extra

在需要的地方通过这样的方式访问这个 extra：

val someExtraValue = intent.options[it.someExtra]

3、应用案例和最佳实践

启动 Activity 时设置 Intent 参数

创建一个 ActivityCompanion，可以方便地构建和传递 Intent 的额外参数：

class SomeActivity : Activity() {
    companion object : ActivityCompanion<IntentOptions>(IntentOptions, SomeActivity::class)

    object IntentOptions {
        var Intent.someExtra by IntentExtra<String>()
    }

    fun test() {
        val someExtraValue = intent.options[it.someExtra]
    }
}

fun test(context: Context) {
    SomeActivity.start(context) {
        it.someExtra = "hello"
    }
}

自定义类型与嵌套类型

库支持自定义类型（如 Joda-Time 的 LocalDate）和嵌套类型（如自定义的数据类 User），只需定义适当的 reader 和 writer：

data class User(val id: Long, val email: String, val birthDay: LocalDate)

import android.content.Intent
import me.eugeniomarletti.extras.DelegateProvider
import me.eugeniomarletti.extras.defaultDelegateName
import me.eugeniomarletti.extras.intent.IntentExtra
import me.eugeniomarletti.extras.intent.base.Long

4、典型生态项目

Android Extras Delegates 可以与其他 Kotlin 库和工具结合使用，例如：

• Kotlin Coroutines: 用于异步编程，提高应用性能。
• Dagger 2: 用于依赖注入，简化对象创建和管理。
• Retrofit: 用于网络请求，简化 API 调用。

通过这些工具的结合使用，可以进一步提高 Android 应用的开发效率和代码质量。