Android KTX

Android KTX   Android Jetpack 的一部分。

Android KTX 是一组 Kotlin 扩展程序,属于 Android Jetpack 系列。它优化了供 Kotlin 使用的 Jetpack 和 Android 平台 API。Android KTX 旨在让您利用 Kotlin 语言功能(例如扩展函数/属性、lambda、命名参数和参数默认值),以更简洁、更愉悦、更惯用的方式使用 Kotlin 进行 Android 开发。Android KTX 不会向现有的 Android API 添加任何新功能。

要详细了解 Android KTX,请观看我们的 DevBytes 视频

使用入门

要开始使用 Android KTX,请将以下代码添加到项目的 build.gradle 文件中:

repositories {
        google()
    }
    

Android KTX 划分为不同的模块。每个模块都包含一个或多个软件包。

使用模块时,请在应用的 build.gradle 文件中为每个 Android KTX 工件添加一个依赖项。请记住在工件后面附上版本号。例如,如果您使用 core-ktx 模块,则完整的依赖项将如下所示:

dependencies {
        implementation 'androidx.core:core-ktx:1.0.0'
    }
    

模块

Android KTX 由以下 Maven 软件工件组成。要获取 API 参考文档,请点击特定软件包名称并查看扩展函数摘要。请注意,版本号可能会改变。要确保您使用的是最新版本,请查看 Google Maven 代码库

模块(工件) 版本 软件包
androidx.core:core-ktx 1.0.0 查看下面的所有核心软件包
androidx.fragment:fragment-ktx 1.0.0 androidx.fragment.app
androidx.palette:palette-ktx 1.0.0 androidx.palette.graphics
androidx.sqlite:sqlite-ktx 2.0.0 androidx.sqlite.db
androidx.collection:collection-ktx 1.0.0 androidx.collection
androidx.lifecycle:lifecycle-viewmodel-ktx 2.0.0 androidx.lifecycle
androidx.lifecycle:lifecycle-reactivestreams-ktx 2.0.0 androidx.lifecycle
android.arch.navigation:navigation-common-ktx 1.0.0-alpha06 androidx.navigation
android.arch.navigation:navigation-fragment-ktx 1.0.0-alpha06 androidx.navigation.fragment
android.arch.navigation:navigation-runtime-ktx 1.0.0-alpha06 androidx.navigation
android.arch.navigation:navigation-testing-ktx 1.0.0-alpha06 androidx.navigation.testing
android.arch.navigation:navigation-ui-ktx 1.0.0-alpha06 androidx.navigation.ui
android.arch.work:work-runtime-ktx 1.0.0-alpha10 androidx.work.ktx

核心模块包括以下软件包:

示例

Android KTX 用在 Sunflower 演示应用中。

以下示例演示了一些 Android KTX 扩展函数。它们按模块(工件)名称分组。有关扩展函数的完整列表,请查看完整的软件包参考文档。

androidx.core:core-ktx

Kotlin

    sharedPreferences.edit()
        .putBoolean("key", value)
        .apply()
    

Kotlin + Android KTX

    sharedPreferences.edit {
        putBoolean("key", value)
    }
    

Kotlin

    view.viewTreeObserver.addOnPreDrawListener(
        object : ViewTreeObserver.OnPreDrawListener {
            override fun onPreDraw(): Boolean {
                viewTreeObserver.removeOnPreDrawListener(this)
                actionToBeTriggered()
                return true
            }
        }
    )
    

Kotlin + Android KTX

    view.doOnPreDraw {
         actionToBeTriggered()
    }
    

androidx.sqlite:sqlite-ktx

Kotlin

    db.beginTransaction()
    try {
        // insert data
        db.setTransactionSuccessful()
    } finally {
        db.endTransaction()
    }
    

Kotlin + Android KTX

    db.transaction {
        // insert data
    }
    

androidx.fragment:fragment-ktx

Kotlin

    supportFragmentManager
        .beginTransaction()
        .replace(R.id.my_fragment_container, myFragment, FRAGMENT_TAG)
        .commitAllowingStateLoss()
    

Kotlin + Android KTX

    supportFragmentManager.transaction(allowStateLoss = true) {
                replace(R.id.my_fragment_container, myFragment, FRAGMENT_TAG)
            }
    

反馈

我们将继续在整个 Jetpack 中添加新的 Kotlin 扩展功能,欢迎您提供反馈。如果您想要报告问题或提供功能建议,请在 Android KTX 问题跟踪器上提交新的问题。