AndroidKotlin扩展

在本教程中，我们将介绍使用Kotlin Android Extensions插件所需的步骤，从而增强Android的开发体验。

查看绑定

背景

每个Android开发者都知道这个findViewById()功能。毫无疑问，这是一个难以阅读和支持的潜在错误和恶劣代码的来源。虽然有几个库可用于解决这个问题，但是这些库需要为每个暴露的注释字段View。

Kotlin Android Extensions插件使我们能够获得与其中一些库相同的体验，而不必添加任何额外的代码。

实质上，这允许以下代码：

// Using R.layout.activity_main from the 'main' source set
import kotlinx.android.synthetic.main.activity_main.*

class MyActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Instead of findViewById<TextView>(R.id.textView)
        textView.setText("Hello, world!")
    }
}

textView是一个扩展属性Activity，并且它具有与在activity_main.xml（所以它是TextView）中声明的相同的类型。

使用Kotlin Android扩展

配置依赖关系

在本教程中，我们将使用Gradle，但使用IntelliJ IDEA项目结构或Maven也可以完成相同的任务。有关设置Gradle以使用Kotlin的详细信息，请参阅使用Gradle。

Android扩展是IntelliJ IDEA和Android Studio的Kotlin插件的一部分。你不需要安装额外的插件。

您只需要在模块build.gradle文件中启用Android扩展插件就可以了：

apply plugin: 'kotlin-android-extensions'

导入合成属性

一次性导入特定布局的所有小部件属性非常方便：

import kotlinx.android.synthetic.main.<layout>.*

因此，如果布局文件名是activity_main.xml，我们会导入kotlinx.android.synthetic.main.activity_main.*。

如果我们想调用综合属性View，我们也应该导入kotlinx.android.synthetic.main.activity_main.view.*。

一旦我们这样做，我们就可以调用相应的扩展，它们是以XML文件中的视图命名的属性。例如，对于这个观点：

    <TextView
        android:id="@+id/hello"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"/>

将会有一个名为hello：

activity.hello.text = "Hello World!"

实验模式

Android扩展插件包含几个实验功能，如LayoutContainer支持和Parcelable实现生成器。这些功能尚未被视为生产准备，所以您需要打开实验模式build.gradle才能使用它们：

androidExtensions {
    experimental = true
}

`LayoutContainer` 支持

Android扩展插件支持不同类型的容器。最基本的有Activity，Fragment并且View，但是你可以通过实现转（几乎）任何类到Android扩展容器LayoutContainer接口，例如：

import kotlinx.android.extensions.LayoutContainer

class ViewHolder(override val containerView: View) : ViewHolder(containerView), LayoutContainer {
    fun setup(title: String) {
        itemTitle.text = "Hello World!"
    }
}

请注意，您需要打开实验标志才能使用LayoutContainer。

味道支持

Android扩展插件支持Android风格。假设你有一个free在你的build.gradle文件中命名的风味：

android {
    productFlavors {
        free {
            versionName "1.0-free"
        }
    }
}

因此，您可以free/res/layout/activity_free.xml通过添加此导入来导入布局的所有合成属性：

import kotlinx.android.synthetic.free.activity_free.*

在实验模式中，您可以指定任何变体名称（不仅味道），例如freeDebug或freeRelease将工作。

查看缓存

调用findViewById()可能会很慢，特别是在视图层次很大的情况下，所以Android扩展尝试findViewById()通过在容器中缓存视图来最小化调用。

默认情况下，Android的扩展增加了一个隐藏的缓存功能和存储领域，以每个容器（Activity，Fragment，View或LayoutContainer写在科特林实现）。该方法是相当小，所以它不会增加APK的大小。

在下面的例子中，findViewById()只调用一次：

class MyActivity : Activity()

fun MyActivity.a() { 
    textView.text = "Hidden view"
    textView.visibility = View.INVISIBLE
}

但在以下情况下：

fun Activity.b() { 
    textView.text = "Hidden view"
    textView.visibility = View.INVISIBLE
}

我们不知道这个函数是否只会被我们的来源的活动或简单的Java活动调用。因为这个原因，即使MyActivity前面例子的实例作为接收者传递，我们也不会在那里使用缓存。

更改视图缓存策略

您可以更改全局或每个容器的缓存策略。这也需要开启实验模式。

项目全局缓存策略在build.gradle文件中设置：

androidExtensions {
    defaultCacheImplementation = "HASH_MAP" // also SPARSE_ARRAY, NONE
}

默认情况下，Android扩展插件HashMap用作后备存储，但您可以切换到SparseArray实现，或者关闭缓存。当您仅使用Android扩展的Parcelable部分时，后者特别有用。

另外，您可以使用@ContainerOptions更改其缓存策略的容器进行注释：

import kotlinx.android.extensions.ContainerOptions

@ContainerOptions(cache = CacheImplementation.NO_CACHE)
class MyActivity : Activity()

fun MyActivity.a() { 
    // findViewById() will be called twice
    textView.text = "Hidden view"
    textView.visibility = View.INVISIBLE
}

Parcelable

从Kotlin 1.1.4开始，Android扩展插件提供了Parcelable实现生成器作为实验性功能。

启用Parcelable支持

如上所述应用kotlin-android-extensionsGradle插件并打开实验标志。

如何使用

用类来注释类@Parcelize，并Parcelable自动生成一个实现。

import kotlinx.android.parcel.Parcelize

@Parcelize
class User(val firstName: String, val lastName: String, val age: Int): Parcelable

@Parcelize需要在主构造函数中声明所有序列化的属性。Android扩展将在每个属性上发出警告，并在类体中声明一个后台字段。另外，@Parcelize如果某些主构造函数参数不是属性，则不能应用。

如果你的类需要更高级的序列化逻辑，你可以把它写在一个伴随类中：

@Parcelize
data class Value(val firstName: String, val lastName: String, val age: Int) : Parcelable {
    private companion object : Parceler<User> {
        override fun User.write(parcel: Parcel, flags: Int) {
            // Custom write implementation
        }

        override fun create(parcel: Parcel): User {
            // Custom read implementation
        }
    }
}

支持的类型

@Parcelize 支持多种类型：

原始类型（及其盒装版本）;
对象和枚举;
String，CharSequence;
Exception;
Size，SizeF，Bundle，IBinder，IInterface，FileDescriptor;
SparseArray，SparseIntArray，SparseLongArray，SparseBooleanArray，
所有Serializable（是的，Date也支持）和Parcelable实现;
所有支持的类型的集合：（List映射到ArrayList），Set（映射到LinkedHashSet），Map（映射到LinkedHashMap）;
- 也有一些具体的实现的：ArrayList，LinkedList，SortedSet，NavigableSet，HashSet，LinkedHashSet，TreeSet，SortedMap，NavigableMap，HashMap，LinkedHashMap，TreeMap，ConcurrentHashMap;
所有支持类型的数组;
所有受支持类型的可空版本。

自定义`Parceler`s

即使你的类型不被直接支持，你也可以Parceler为它写一个映射对象。

class ExternalClass(val value: Int)

object ExternalClassParceler : Parceler<ExternalClass> {
    override fun create(parcel: Parcel) = ExternalClass(parcel.readInt())

    override fun ExternalClass.write(parcel: Parcel, flags: Int) {
        parcel.writeInt(value)
    }
}

外部宗地可以使用@TypeParceler或@WriteWith注释应用：

// Class-local parceler
@Parcelable
@TypeParceler<ExternalClass, ExternalClassParceler>()
class MyClass(val external: ExternalClass)

// Property-local parceler
@Parcelable
class MyClass(@TypeParceler<ExternalClass, ExternalClassParceler>() val external: ExternalClass)

// Type-local parceler
@Parcelable
class MyClass(val external: @WriteWith<ExternalClassParceler>() ExternalClass)