Anko学习

anko

Anko 是一个用 Kotlin 写的Android DSL (Domain-Specific Language)。 内部提供很多工具，详情可点https://github.com/Kotlin/anko
在这里我们主要涉及的是anko的layout部分，长久以来，Android视图都是用XML来完成布局的。用xml写布局有下面这些缺点：

• 不是类型安全的;
• 不是null-safe;
• 强迫你对每个layout编写几乎相同的代码;
• 在设备上解析XML费电费CPU;
• 最惨的是代码不可复用
  所以，如果可以，我们可以尝试用anko来绘制布局。

环境配置

因为anko版本发布的并不是很多，用户量也不是很多，所有网上能找到的资源是非常少的，所以配置的时候总会出现许许多多的问题。现在android studio默认已经集成了kotlin了，我们需要配置的就是anko support，也就是anko preview，用来预览anko写的ui布局的工具。

插件安装

as联网下载

我们可以从android studio内置的下载器中下载，从Preference->Plugins中搜索Anko Support，并进行下载。
[图片上传失败…(image-8ed987-1542512015800)]

官网下载导入

我们也能够从官网中下载指定的anko support版本，点击https://plugins.jetbrains.com/plugin/7734-anko-support，选择指定版本进行下载，然后在as导入。
[图片上传失败…(image-770d0a-1542512015800)]
在android选择项目的页面，选择configuration->plugins->install plugin from disk,选择相应的plugin包导入。

可能出现的问题

目前官网最新的anko support插件版本是0.10.5,如果我们的as版本是3.0，那么还是将会出现anko preview不能预览的情况，报错情况为

Anko Support threw an uncaught NoSuchMethodError

这个是因为as3.0的问题不支持anko support，这个时候我们只需要更新as的版本到3.1之后，anko support就能够使用了。

开始使用anko

首先需要先引入anko依赖库

implementation "org.jetbrains.anko:anko:0.10.5"

这个是anko给我们集成的一个包含anko所有功能的库，包含了

• anko commons： 一些常用的扩展函数，包括intent、dialog、log、resources等
• ankoLayout： anko布局
• ankoSqlite： anko优化的数据库操作
• anko Coroutines: anko对于kotlin协程的扩展

如果我们需要大部分的anko的功能，我们可以直接这么引入，否则我们需要单独引入每一个功能的依赖。

dependencies {
    // Anko Commons
    implementation "org.jetbrains.anko:anko-commons:$anko_version"

    // Anko Layouts
    implementation "org.jetbrains.anko:anko-sdk25:$anko_version" // sdk15, sdk19, sdk21, sdk23 are also available
    implementation "org.jetbrains.anko:anko-appcompat-v7:$anko_version"

    // Coroutine listeners for Anko Layouts
    implementation "org.jetbrains.anko:anko-sdk25-coroutines:$anko_version"
    implementation "org.jetbrains.anko:anko-appcompat-v7-coroutines:$anko_version"

    // Anko SQLite
    implementation "org.jetbrains.anko:anko-sqlite:$anko_version"
}

我们只需要从中引入我们所必须的库就ok了。在这里我们需要注意的是anko-sdk的引入需要和我们build.gradle中的minSdkVersion做下适配。

org.jetbrains.anko:anko-sdk15 ： 15 <= minSdkVersion < 19

org.jetbrains.anko:anko-sdk19 ： 19 <= minSdkVersion < 21

org.jetbrains.anko:anko-sdk21 ： 21 <= minSdkVersion < 23

org.jetbrains.anko:anko-sdk23 ： 23 <= minSdkVersion < 25

org.jetbrains.anko:anko-sdk25 ： 25 <= minSdkVersion 

如果没有按照要求做sdk适配，那么一旦运行在不符合的版本，将会直接崩溃～切记

AnkoComponent

我们可以在activity的onCreate、fragemnt的onCreateView中直接绘制ui，但是这样就让ui绘制代码�与activity、fragment代码有了耦合了。所有我们可以将Anko代码定义到另外一个class中，作为对应的UiClass，这就需要AnkoComponent。

定义UIClass

class MemberCenterActivityUI : AnkoComponent<MemberCenterActivity> {
        override fun createView(ui: AnkoContext<MemberCenterActivity>) : View = with(ui){
        
    }

在我们定义了相应的uiclass之后，我们需要实现其中的oncreateView方法，这个类的返回就是一个View，就是我们anko绘制的布局。
添加上with(ui)，是为了让dsl代码块能够以this的形式持有AnkoContext，这个AnkoContext是一个非常有用的类

    val ctx: Context
    val owner: T
    val view: View

ctx就是上下文信息，owner就是uiclass依附的类的实例，在这个例子里面指的是MemberCenterActivity，我们可以通过owner调用MemberCenterActivity的任意public方法。

绘制布局

所有布局

            relativeLayout {
                imageView {
                    adjustViewBounds = true
                    scaleType = ImageView.ScaleType.CENTER_CROP
                    imageResource = R.drawable.bg_members
                }.lparams(width = matchParent, height = matchParent)
                statusBar = view {
                    id = statusBarHolder
                }.lparams {
                    height = statusBarHeight(ctx)
                    width = matchParent
                }
                toolbar {

                    id = toolbarId
                    backgroundColor = R.color.color_00000000

                    imageView {
                        imageResource = R.drawable.ic_arrow_back_white
                        onClick {
                            owner.finish()
                        }
                    }.lparams(height = wrapContent, width = wrapContent) {
                        padding = dip(5)
                    }

                    textView("会员中心") {
                        textColor = R.color.color_ffffff
                        textSize = R.dimen.dimens_18sp.toFloat()
                    }.lparams(width = wrapContent, height = wrapContent) {
                        gravity = Gravity.CENTER

                    }

                }.lparams(height = dip(50), width = matchParent) {
                    below(statusBar)
                }

                memberRv = recyclerView {
                    itemAnimator.changeDuration = 0
                    layoutManager = LinearLayoutManager(context)
                    adapter = MemberCenterAdapter(context, null)
                    memberAdapter = adapter as MemberCenterAdapter
                }.lparams(width = matchParent, height = matchParent) {
                    below(toolbarId)
                }
            }

每一个anko布局，最多只能有一个根节点，在这个例子中最外层的根节点就是relativelayout，这个组件的名称都是以小写字母开头的，就是anko给java的View多包装了一层，以便在dsl使用。

 imageView {
        ....
        }.lparams(width = matchParent, height = matchParent){
        .....
        }

控件直接包含的区域是添加控件的直接参数的，比如说imageView的src，scaleType，TextView的text，textSize，textColor等。而lparams是用来定义组件的大小，布局、位置属性的，包括height、width、gravity等等。
当然，我们也可以不指定lparams，这样的话，它会有默认的宽高,即wrap_content。

inline fun <T: View> T.lparams(
            width: Int = android.view.ViewGroup.LayoutParams.WRAP_CONTENT,
            height: Int = android.view.ViewGroup.LayoutParams.WRAP_CONTENT
    ): T {
        val layoutParams = FrameLayout.LayoutParams(width, height)
        this@lparams.layoutParams = layoutParams
        return this
    }

整个imageView域是有返回值的，返回的就是这个imageView实体，我们也可以理解成这个域创建了imageView实体并返回。

anko扩展View

当我们想要用自定义View或者anko没有支持的View，我们可以扩展ankoView

inline fun ViewManager.mapView() = mapView(theme = 0) {}

inline fun ViewManager.mapView(init: MapView.() -> Unit): MapView {
    return ankoView({ MapView(it) }, theme = 0, init = init)
}

这个mapView就是我们想要扩展的View，这个是官网给的例子，下面我们来扩展fresco的simpledraweeView

inline fun ViewManager.simpleDraweeView(theme: Int = 0) = simpleDraweeView(theme) {}
inline fun ViewManager.simpleDraweeView(theme: Int = 0, init: SimpleDraweeView.() -> Unit) : SimpleDraweeView {
    return ankoView({ SimpleDraweeView(it) }, theme, init)
}

这样我们就能在anko dsl中直接使用simpleDraweeView了

onclick

anko中已经给我们添加了onclick方法，我们可以在每个View中添加onClick，并且指定其实现，anko将会给这个View设置listener

fun android.view.View.onClick(
        context: CoroutineContext = UI,
        handler: suspend CoroutineScope.(v: android.view.View?) -> Unit
) {
    setOnClickListener { v ->
        launch(context) {
            handler(v)
        }
    }
}

一些小点

• 用了anko之后，我们如果需要对于id的诉求只有一个，那就是在relativelayout中指定位置时，需要通过id，才指定below、above、left、right的位置，对于id的设置，我们需要自己定义Id的int值，我们得保证它不会重复。
• 对于imageView，不再有src属性，因为anko内部其实是动态代码创建view，所有对于这个src，替代的就是在代码中指定的imageResouce
• 对于color，需要的就是color的值，而非项目中的colorId
• 对于textView，它的textSize指定为f，而非sp
• 如果我们想要用recyclerView，那么我们需要引入anko的依赖库，或者直接扩展ankoView
• 对于dp计算，anko内部给我们实现了dip方法计算。

anko preivew

对于anko support，虽然可能它的代码效率比较高，但是它在预览的时候并没有办法做到像在xml里面实时预览，只有在代码build之后才能够看到预览页面，而且每次修改都必须要进行rebuild，这个是一个非常让人无法接受的点，刚开始效率肯定会低，但是随着代码的熟练，效率还是会有所提升的，毕竟anko的ui绘制效率要笔xml高。可以通过command+f9进行build。

ankoComponent元素的调用

我们免不了需要在activity，framgent等类中更新uiClass的元素的状态。所以了解uiClass与activity，fragment及viewHolder的绑定及调用还是有必要的。

绑定

activity

activity绑定ankoComponent可以通过下面这种方式来绑定

MemberCenterActivityUI().setContentView();

fragment

val view = MemberCenterFragmentUI().createView(AnkoContext.create(ctx, MemberCenterFragment()))

在onCreateView中返回这个View，就和fragment进行绑定了。

viewHolder

MemberCenterItemUI().createView(AnkoContext.create(context, parent)

自定义View

在自定义View中，对于anko来说是一个比较不方便的使用，因为在anko support的支持预览的前提是使用AnkoComponent，而自定义View的View绑定却不通过AnkoComponent，也有可能是我现在没发现，目前发现的支持绑定的方式为：

  constructor(context: Context) : super(context) {
        initView()
    }
 private fun initView() = AnkoContext.createDelegate(this).apply {
	...init anko view
}

在java的自定义View中，是通过构造函数调用inflate方法，来将xml设置到该自定义View中。
在anko中，利用AnkoContext.createDelegate(this).apply来替代inflate。

我们可以先通过AnkoComponent来预览界面，然后预览完成之后再将anko代码放在AnkoContext.createDelegate(this).apply中。

调用

对于三者的调用其实都是一致的，我们只需要缓存AnkoComponent类的实例就能够通过这个实例引用其内部的ui组件。

//in activity
mainUI = MemberCenterActivityUI()
    mainUI.setContentView(this)
    
 TextUtils.isEmpty(chargeTip?.chargeButtonDesc).yes {
                mainUI.bottomMemberOpenDesc.visibility = View.GONE
            }.no {
                mainUI.bottomMemberOpenDesc.visibility = View.VISIBLE
                mainUI.bottomMemberOpenDesc.text = chargeTip?.chargeButtonDesc
            }
            TextUtils.isEmpty(chargeTip?.chargeButtonUrl).yes {
                mainUI.btnOpenViewIcon.visibility = View.GONE
            }.no {
                mainUI.btnOpenViewIcon.visibility = View.VISIBLE
                KKGifPlayer
                        .with(this)
                        .load(chargeTip?.chargeButtonUrl)
                        .playPolicy(KKGifPlayer.PlayPolicy.Auto_Always)
                        .into(openViewIcon)
            }