【译】Kotlin Android扩展(Kotlin Android(安卓)Extensions)(四)
转自:http://ranseti.top/article/extensions
本教程介绍如何使用Kotlin Android扩展来改进对Android开发的支持。
在本教程中,我们将介绍使用Kotlin Android Extensions插件所需的步骤,从而增强Android的开发体验。
View绑定
背景
每个Android开发人员都知道findViewById()函数。 毫无疑问,这是一个难以阅读和支持的潜在错误和恶劣代码的来源。 虽然有几个库可用于解决这个问题,但是这些库需要为每个暴露的View注释字段。
Kotlin Android Extensions插件使我们能够获得与其中一些库相同的体验,而不必添加任何额外的代码。
实质上,这允许以下代码:
// Using R.layout.activity_main from the 'main' source setimport 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(R.id.textView) textView.setText("Hello, world!") }}
使用Kotlin Android扩展
- 配置依赖关系
在本教程中,我们将使用Gradle,但使用IntelliJ IDEA项目结构或Maven也可以完成相同的任务。 有关设置Gradle以使用Kotlin的详细信息,请参阅使用Gradle。
Android扩展是IntelliJ IDEA和Android Studio的Kotlin插件的一部分。 你不需要安装额外的插件。
您只需在模块的build.gradle文件中启用Android扩展Gradle插件即可:
apply plugin: 'kotlin-android-extensions'
- 导入合成属性
一次性导入特定布局的所有小部件属性非常方便:
import kotlinx.android.synthetic.main..*
因此,如果布局文件名是activity_main.xml,我们会导入kotlinx.android.synthetic.main.activity_main。*。
如果我们想调用View的综合属性,我们也应该导入kotlinx.android.synthetic.main.activity_main.view。*。
一旦我们这样做,我们就可以调用相应的扩展,它们是以XML文件中的视图命名的属性。 例如,对于这个view:
将会有一个名为hello的属性:
activity.hello.text = "Hello World!"
- 实验模式(Experimental Mode)
Android扩展插件包含几个实验性功能,如LayoutContainer支持和Parcelable实现生成器。 这些功能尚未被视为生产准备,所以您需要打开build.gradle中的实验模式才能使用它们:
androidExtensions { experimental = true}
- LayoutContainer支持
Android扩展插件支持不同类型的容器。 最基本的是Activity,Fragment和View,但是通过实现LayoutContainer接口,你可以把(虚拟的)任何类转换成一个Android Extensions容器,例如:
import kotlinx.android.extensions.LayoutContainerclass ViewHolder(override val containerView: View) : ViewHolder(containerView), LayoutContainer { fun setup(title: String) { itemTitle.text = "Hello World!" }}
请注意,您需要打开实验标志才能使用LayoutContainer。
- Flavor支持
Android扩展插件支持Android风格。 假设你在build.gradle文件中有一个free的名字:
android { productFlavors { free { versionName "1.0-free" } }}
因此,您可以通过添加以下导入来导入free / res / layout / activity_free.xml布局的所有合成属性:
import kotlinx.android.synthetic.free.activity_free.*
在实验模式中,您可以指定任何变体名称(不仅味道),例如 freeDebug或freeRelease也可以工作。
- View 缓存(View Caching)
调用findViewById()可能会很慢,特别是在视图层次很大的情况下,所以Android扩展尝试通过在容器中缓存视图来最小化findViewById()调用。
默认情况下,Android扩展为在Kotlin中编写的每个容器(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-extensions Gradle插件并打开实验标志。
- 如何使用
使用@Parcelize对类进行注释,并自动生成一个Parcelable实现。
import kotlinx.android.parcel.Parcelize@Parcelizeclass User(val firstName: String, val lastName: String, val age: Int): Parcelable
@Parcelize需要在主构造函数中声明所有序列化的属性。 Android扩展将在每个属性上发出警告,并在类体中声明一个后台字段。 此外,如果某些主构造函数参数不是属性,则不能应用@Parcelize。
如果你的类需要更高级的序列化逻辑,你可以把它写在一个伴随类中:
@Parcelizedata class Value(val firstName: String, val lastName: String, val age: Int) : Parcelable { private companion object : Parceler { override fun User.write(parcel: Parcel, flags: Int) { // Custom write implementation } override fun create(parcel: Parcel): User { // Custom read implementation } }}
- 支持的类型
@Parcelize支持多种类型:
原始类型(及其盒装版本);
对象和枚举;
字符串,CharSequence;
例外;
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;
所有支持类型的数组;
所有受支持类型的可空版本。
- 自定义Parcelers
即使你的类型不被直接支持,你也可以为它编写一个Parceler映射对象。
class ExternalClass(val value: Int)object ExternalClassParceler : Parceler { override fun create(parcel: Parcel) = ExternalClass(parcel.readInt()) override fun ExternalClass.write(parcel: Parcel, flags: Int) { parcel.writeInt(value) }}
可以使用@TypeParceler或@WriteWith注释应用外部parcelers :
// Class-local parceler@Parcelable@TypeParceler()class MyClass(val external: ExternalClass)// Property-local parceler@Parcelableclass MyClass(@TypeParceler() val external: ExternalClass)// Type-local parceler@Parcelableclass MyClass(val external: @WriteWith() ExternalClass)
更多相关文章
- 箭头函数的基础使用
- NPM 和webpack 的基础使用
- Python list sort方法的具体使用
- 【阿里云镜像】使用阿里巴巴DNS镜像源——DNS配置教程
- Android(安卓)Java汉字转拼音总结
- 基于RTP和Android的视频传输的研究实现方法
- Android系列教程之八:ListView组件的使用
- Android(安卓)Context 使用时注意内存泄漏问题
- 基于“ViewHolder”技术提升Android(安卓)ListView中Item View加