Kotlin Android Extensions的使用

工作中用到了,翻譯一下,原文地址:http://kotlinlang.org/docs/tutorials/android-plugin.html

作者:Yan Zhulanow

本教程介紹了Kotlin Android Extensions的使用彤委,用以提高對Android開發(fā)的支持。

在本教程中,我們將介紹Kotlin Android Extensions插件使用所需的步驟,從而提高Android的開發(fā)體驗苦始。

View Binding

背景介紹

每一個Android程序猿都非常了解findViewById() 方法。毫無疑問慌申,他會導(dǎo)致一些潛在的錯誤(如陌选,強(qiáng)轉(zhuǎn)異常)而且難以閱讀和維護(hù),非常令人討厭蹄溉。盡管有一些庫可以解決這個問題咨油,但是這些庫都需要為每一個view 添加注解。

Kotlin Android Extensions插件使我們能夠獲得與其中一些庫相同的體驗柒爵,但是無需添加任何額外的代碼役电。

例如下面的代碼

<pre>

// Using R.layout.activity_main from the 'main' source setimportkotlinx.android.synthetic.main.activity_main.*

classMyActivity:Activity(){overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)

// Instead of findViewById(R.id.textView)

textView.setText("Hello, world!")

}

}

</pre>

textView是Activity的擴(kuò)展屬性,它與activity_main.xml中聲明的類型相同(所以它是一個TextView)

Kotlin Android Extensions 的使用

配置

在本教程中餐弱,我們將使用Gradle宴霸,但使用IntelliJ IDEA項目結(jié)構(gòu)或Maven也可以完成相同的任務(wù)囱晴。有關(guān)設(shè)置Gradle以使用Kotlin的詳細(xì)信息膏蚓,請參閱使用Gradle

Android擴(kuò)展是IntelliJ IDEA和Android Studio的Kotlin插件的一部分畸写。你不需要安裝額外的插件驮瞧。

你所需要做的就是在你module下的build.gradle文件中添加如下代碼:

apply plugin:'kotlin-android-extensions'

導(dǎo)入合成的組件

它可以非常方便的一次導(dǎo)入所有合成的組件。

importkotlinx.android.synthetic.main.<layout>.*

假如layout是activity_main.xml枯芬,那我們就導(dǎo)入 kotlinx.android.synthetic.main.activity_main.*

如果我們想調(diào)用View的一些屬性论笔,我們還應(yīng)該導(dǎo)入 kotlinx.android.synthetic.main.activity_main.view.*.

這樣,我們就可以調(diào)用調(diào)用相應(yīng)的擴(kuò)展組件千所,這些擴(kuò)展組件是以XML文件中的View命名的屬性狂魔。(就是view的id)例如下面的view
<TextView
android:id="@+id/hello"
android:layout_width="fill_parent"
android:layout_height="wrap_content"/>
就會有一個叫hello的屬性:
<code>activity.hello.text = "Hello World!"</code>

實驗功能

Android Extensions 插件包括幾個實驗功能,比如Parcelable生成器淫痰,這些功能還沒有應(yīng)用到生產(chǎn)環(huán)境最楷,如果你想使用他們,需要打開實驗?zāi)J健T赽uild.gradle 中添加以下代碼
androidExtensions {
experimental = true
}

視圖界面的支持
Android Extensions 插件支持不同類型的視圖界面籽孙,最基本的就是acitivity烈评,fragment,view犯建。
事實上,你可以把任意一個類變成視圖界面,只要你實現(xiàn)LayoutContainer 接口
import kotlinx.android.extensions.LayoutContainer

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

注意谷扣,你需要打開實驗?zāi)J絹硎褂肔ayoutContainer

渠道支持
Android Extensions 插件支持Android 不同的渠道焙畔,比如你有一個free的渠道
android {
productFlavors {
free {
versionName "1.0-free"
}
}
}
你可以通過以下代碼導(dǎo)入 free/res/layout/activity_free.xml 所有生成的屬性
import kotlinx.android.synthetic.free.activity_free.*
在實驗?zāi)J较拢憧梢灾付ㄈ我庖粋€變體的名字犹菇,不僅僅是渠道德迹,例如freeDebug,F(xiàn)reeRelease

視圖緩存
調(diào)用findviewbyid() 很耗時揭芍,尤其是在復(fù)雜多層次的視圖界面里胳搞。所以Android Extensions 通過緩存視圖來減少findviewbyid()的調(diào)用。
下面的例子称杨,findviewbyid()只會被調(diào)用一次肌毅。
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
}

我們不知道這個函數(shù)是否只會被我們的來源的活動或簡單的Java活動調(diào)用。因此姑原,即使前面的示例中的MyActivity實例作為接收者傳遞悬而,我們也不使用緩存。

改變視圖緩存策略
你可以全局或者針對某個界面的改變視圖的緩存策略锭汛,這也需要打開實驗?zāi)J?br> 全局的視圖緩存策略可以在build.gradle 中設(shè)置
androidExtensions {
defaultCacheImplementation = "HASH_MAP" // also SPARSE_ARRAY, NONE
}
默認(rèn)情況下笨奠,Android Extensions 插件使用HashMap儲存,您也可以切換到SparseArray唤殴,或者關(guān)閉儲存般婆, 當(dāng)您僅使用Android擴(kuò)展的Parcelable部分時,后者(SparseArray)特別有用朵逝。
同時蔚袍,你也可以使用注解@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 Extensions 插件提供了Parcelable 實現(xiàn)生成器作為實驗功能配名。
首先啤咽,啟用Parcelable 支持 Apply the kotlin-android-extensions ,然后打開實驗功能宇整。

使用
使用@Parcelize 注解這個類芋膘,Parcelable就會自動實現(xiàn)
import kotlinx.android.parcel.Parcelize
@Parcelize
class User(val firstName: String, val lastName: String, val age: Int): Parcelable

@Parcelize 需要所有的屬性在主構(gòu)造方法中聲明,如果在類中聲明的話贴彼,Android Extensions 會發(fā)出警告器仗。此外童番,如果某些主構(gòu)造函數(shù)參數(shù)不是屬性剃斧,則不能應(yīng)用@Parcelize幼东。
如果你的類需要更高級的序列化邏輯,你可以把它寫在一個內(nèi)部類中:

@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支持廣泛的類型:
--基本類型,包括封箱的類型(Integer)
--Objects and enums;
--String, CharSequence;
--Exception;
--Size, SizeF, Bundle, IBinder, IInterface, FileDescriptor;
--SparseArray, SparseIntArray, SparseLongArray, SparseBooleanArray;
--所有的 Serializable (是的球散,Date 也支持) 和所有實現(xiàn) Parcelable 的類;
--所有支持類型的集合: 比如 List (mapped to ArrayList), Set (mapped to LinkedHashSet), Map (mapped to LinkedHashMap);
--還包括一些具體實現(xiàn)的集合: ArrayList, LinkedList, SortedSet, NavigableSet, HashSet, LinkedHashSet, TreeSet, SortedMap, NavigableMap, HashMap, LinkedHashMap, TreeMap, ConcurrentHashMap;
--所有支持類型的數(shù)組
--所有支持類型為null的情況.

自定義Parcelers
假如你的類型不能直接支持散庶,你可以寫一個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注釋應(yīng)用外部parcelers
// 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)

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末悲龟,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子丑婿,更是在濱河造成了極大的恐慌没卸,老刑警劉巖秒旋,帶你破解...
    沈念sama閱讀 216,744評論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件迁筛,死亡現(xiàn)場離奇詭異,居然都是意外死亡筒占,警方通過查閱死者的電腦和手機(jī)翰苫,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,505評論 3 392
  • 文/潘曉璐 我一進(jìn)店門奏窑,熙熙樓的掌柜王于貴愁眉苦臉地迎上來埃唯,“玉大人鹰晨,你說我怎么就攤上這事∥∈担” “怎么了哩牍?”我有些...
    開封第一講書人閱讀 163,105評論 0 353
  • 文/不壞的土叔 我叫張陵丸边,是天一觀的道長荚孵。 經(jīng)常有香客問我,道長收叶,這世上最難降的妖魔是什么骄呼? 我笑而不...
    開封第一講書人閱讀 58,242評論 1 292
  • 正文 為了忘掉前任判没,我火速辦了婚禮蜓萄,結(jié)果婚禮上澄峰,老公的妹妹穿的比我還像新娘嫉沽。我一直安慰自己,他們只是感情好俏竞,可當(dāng)我...
    茶點故事閱讀 67,269評論 6 389
  • 文/花漫 我一把揭開白布绸硕。 她就那樣靜靜地躺著,像睡著了一般出嘹。 火紅的嫁衣襯著肌膚如雪咬崔。 梳的紋絲不亂的頭發(fā)上娶聘,一...
    開封第一講書人閱讀 51,215評論 1 299
  • 那天,我揣著相機(jī)與錄音甚脉,去河邊找鬼狡耻。 笑死,一個胖子當(dāng)著我的面吹牛猴凹,可吹牛的內(nèi)容都是我干的夷狰。 我是一名探鬼主播,決...
    沈念sama閱讀 40,096評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼郊霎,長吁一口氣:“原來是場噩夢啊……” “哼沼头!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起书劝,我...
    開封第一講書人閱讀 38,939評論 0 274
  • 序言:老撾萬榮一對情侶失蹤进倍,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后购对,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體猾昆,經(jīng)...
    沈念sama閱讀 45,354評論 1 311
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,573評論 2 333
  • 正文 我和宋清朗相戀三年骡苞,在試婚紗的時候發(fā)現(xiàn)自己被綠了垂蜗。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,745評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡解幽,死狀恐怖贴见,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情亚铁,我是刑警寧澤蝇刀,帶...
    沈念sama閱讀 35,448評論 5 344
  • 正文 年R本政府宣布螟加,位于F島的核電站徘溢,受9級特大地震影響吞琐,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜然爆,卻給世界環(huán)境...
    茶點故事閱讀 41,048評論 3 327
  • 文/蒙蒙 一站粟、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧曾雕,春花似錦奴烙、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,683評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至搔弄,卻和暖如春幅虑,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背顾犹。 一陣腳步聲響...
    開封第一講書人閱讀 32,838評論 1 269
  • 我被黑心中介騙來泰國打工倒庵, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人炫刷。 一個月前我還...
    沈念sama閱讀 47,776評論 2 369
  • 正文 我出身青樓擎宝,卻偏偏與公主長得像,于是被迫代替她去往敵國和親浑玛。 傳聞我的和親對象是個殘疾皇子绍申,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,652評論 2 354

推薦閱讀更多精彩內(nèi)容