用Kotlin的Anko库优雅开发Android应用--Anko库详细教程

前言

最近Kotlin的呼声又是日益高涨，前几天9012年Google IO正式将Kotlin从first _class提升为kotlin_first。我也是接触了一段时间的Kotlin，给我的感觉就是简约，快速。无需繁琐的findId，高阶函数的应用，再加上Kotlin的null 安全，更是将代码的崩溃率降到更低。

今天我们就来介绍一下今天的主角---Anko

1.Anko

Anko是JetBrains开发的一个强大的库,说起JetBrains ，那就牛逼了，Kotlin语言是他们开发的，最流行的的开发工具intellij idea都是他们开发的，AS也是基于IDEA的。好了，言归正传，Anko是Kotlin官方开发的一个让开发Android应用更快速更简单的Kotlin库,并且能让我们书写的代码更简单清楚更容易阅读。它包括多个部分

1. Anko Commons: a lightweight library full of helpers for intents, dialogs, logging and so on;
2. Anko Layouts: a fast and type-safe way to write dynamic Android layouts;
3. Anko SQLite: a query DSL and parser collection for Android SQLite;
4. Anko Coroutines: utilities based on the kotlinx.coroutines library.

1.1 如何使用

添加依赖

dependencies {
    implementation "org.jetbrains.anko:anko:$anko_version"
}
复制代码

这里面包括上面四个部分，当然你也可以只依赖一个部分，如下：

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"
}
复制代码

下面我们分别介绍这几个功能。

2 AnkoCommons

AnkoCommons对Android开发者来说是一个工具集，包括但不限于下面这几个

1. Intents
2. Dialogs and toasts
3. Logging
4. Resources and dimensions

2.1 Intents

前面已经提到，Commons 库是一个工具集，那Intents主要是帮助简化Activity之间的跳转。

传统的 Kotlin 启动新的 Activity 的方式是创建一个 Intent，同时可能传递一些参数，最后将创建的 Intent 通过 Context 的 startActivity() 方法传递，就像这样：

val intent = Intent(this, SomeOtherActivity::class.java)
intent.putExtra("id", 5)
intent.setFlag(Intent.FLAG_ACTIVITY_SINGLE_TOP)
startActivity(intent)
复制代码

然鹅你用Anko只需要这样：

startActivity(intentFor("id" to 5).singleTop())

如果想要传递多个参数，你也可以这样

startActivity<SomeOtherActivity>(
    "id" to 5,
    "city" to "Denpasar"
)
复制代码

当然还有一些关于Intent的其它操作，如：拨打电话等：如下

2.2 Dialogs and toasts

这个库主要是用来快速搭建Dialog和toast，具体包含以下几个

• Toast
• SnackBar
• Alert （Dialog）
• Selectors
• Progress dialogs

2.2.1 Toast

Anko为我们提供了更加简单的Toast使用，只需要一行代码即可实现

toast("Hi there!")
toast(R.string.message)
longToast("Wow, such duration")
复制代码

2.2.2 SnackBars

SnackBar是 Android Support Library 22.2.0 里面新增提供的一个控件,我们可以简单的把它理解成一个加强版的Toast，或者是一个轻量级的Dialog。 我们可以用下面代码快速创建snackbar。

view.snackbar("Hi there!")
view.snackbar(R.string.message)
view.longSnackbar("Wow, such duration")
view.snackbar("Action, reaction", "Click me!") { doStuff() }
复制代码

这里需要传入view对象，这个可以是布局中的任意一个view对象。

2.2.3 Alerts

Anko Alerts主要包括以下几个功能：

1. Android 默认dialog
2. Android Appcompat 中AlertDialog
3. 自定义Dialog

1.Android 默认dialog 通过以下代码就可以构建一个可以交互的Android 默认dialog。

alert("Hi, I'm Roy", "Have you tried turning it off and on again?") {
    yesButton { toast("Oh…") }
    noButton {}
}.show()
复制代码

代码比较简单，就不做解释。

2.Android Appcompat 中AlertDialog 另外Anko还提供了Appcompat的AlertDialog实现方式，如下：

alert(Appcompat, "Some text message").show()
复制代码

3.自定义Dialog 什么，不能自定义dialog吗？怎么会，自定义dialog也是非常的简单

alert {
    customView {
        editText()
    }
}.show()
复制代码

2.2.4 Selectors （包含列表的Dialog）

我们平时创建列表Dialog是这样的：

  val listItems = arrayOf("Russia", "USA", "Japan", "Australia")  //传数组
        val listDialog: AlertDialog.Builder = AlertDialog.Builder(this)
        listDialog.setItems(listItems) { p0, p1 ->
        	toast(p1)
        }
        val dialog: AlertDialog = listDialog.create()
        dialog.show()
        val window: Window = dialog.window
        val params: WindowManager.LayoutParams = window.attributes
        params.y = 45 * ScreenUtils.getScreenDensity().toInt()
        params.gravity = Gravity.TOP or Gravity.RIGHT
        params.width = ScreenUtils.getScreenWidth() / 2
        params.height = ViewGroup.LayoutParams.WRAP_CONTENT
        window.attributes = params
复制代码

但是我们用Anko是这样的：

val countries = listOf("Russia", "USA", "Japan", "Australia")  //传list
selector("Where are you from?", countries, { dialogInterface, i ->
    toast("So you're living in ${countries[i]}, right?")
})
复制代码

看起来只是简化了dialog的创建过程。

2.2.5 Progress dialogs

不显示进度的 Loading Dialg

pressDialog("Please wait a minute.", "Downloading…")
indeterminateProgressDialog("Fetching the data…")
复制代码

2.3 Logging

打印log辅助工具。

Android SDK 提供 android.util.Log 类来提供一些 logging 方法，，这些方法都很实用，但是我们每次必须传递一个 Tag 参数，同时这个 Tag 信息必须是 String 类型的，这就略显麻烦。不过现在我们可以通过 AnkoLogger 类摆脱这些恼人的问题：

class SomeActivity : Activity(), AnkoLogger {
    fun someMethod() {
        info("Info message")
        debug(42) // .toString() method will be called automatically
    }
}
复制代码

默认的 Tag 名是当前的类名( 本例中的是SomeActivity），但是通过重写 AnkoLogger 的 loggerTag 属性我们是可以来更改的，而且每个方法有两个版本：plain and lazy (inlined)

1.Lazy：

info("String " + "concatenation")
info { "String " + "concatenation" }
复制代码

2.plain:

class SomeActivity : Activity() {
    private val log = AnkoLogger(this.javaClass)
    private val logWithASpecificTag = AnkoLogger("my_tag")

    private fun someMethod() {
        log.warning("Big brother is watching you!")
    }
}
复制代码

上面两种方法分别是不同Tag的实现方式。

AnkoLogger中loggerTag 属性具体对照如下：

2.4 Resources and dimensions

你可以在你的项目中使用Anko Resources and dimensions来简化你的代码，例如Color、Dimen等，颜色透明度直接色值.opaque就可以，尺寸的话直接使用dip(dipValue)、sp(spValue)就可以。在这里面还有一个就是applyRecursively()用来控制子View的操作，如：

  verticalLayout {
        textView{
            text = "EditText01"
            backgroundColor = 0xff000.opaque
            textSize = 14f
        }
        textView {
            text = "EditText02"
            backgroundColor = 0x99.gray.opaque
            textSize = 23f
        }
    }.applyRecursively {//如果是ViewGroup的话可以使用applyRecursively来为每个Child View进行设置
        view -> when(view){
            is TextView -> view.textColor = Color.RED
        }
    }
复制代码

3.Anko Layouts

通常我们使用xml文件写我们的布局，但是他有一些缺点如不是类型安全，不是空安全，解析xml文件消耗更多的CPU和电量等等。而Anko Layout可以使用DSL(Domain Specific Language)动态创建我们的UI，并且它比我们使用Java动态创建布局方便很多主要是更简洁，它和拥有xml创建布局的层级关系，能让我们更容易阅读。（官方说的优点）

举个栗子：

verticalLayout {
    val name = editText()
    button("Say Hello") {
        onClick { toast("Hello, ${name.text}!") }
    }
}
复制代码

上面的代码是不是很简单易懂，当然，默认的控件并不能满足我们的需求，例如我们会更改字体的颜色及大小，会设置宽度和高度，会设置margin，padding值，那么该如何实行呢，当然也很简单，因为它的逻辑和xml书写布局是一个套路。例如以下实现

val textView=textView("我是一个TextView"){
                textSize = sp(17).toFloat()
                textColor=0xff000.opaque
            }.lparams{
                margin=dip(10)
                height= dip(40)
                width= matchParent
            }
复制代码

配合上前面Common库是不是很简单呢？

这里我们不需要setContentView。直接写在onCreate方法中就行。

在上面创建UI过程中，我们直接把创建UI的代码写在onCreate方法中了，当然，还有一种写法。我们创建一个内部类实行AnkoComponent接口，并重写createView方法，该方法返回一个View，也就是我们创建的布局。修改如下

class MyActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?, persistentState: PersistableBundle?) {
        super.onCreate(savedInstanceState, persistentState)
        MyActivityUI().setContentView(this)
    }
}

class MyActivityUI : AnkoComponent<MyActivity> {
    override fun createView(ui: AnkoContext<MyActivity>) = with(ui) {
        verticalLayout {
            val name = editText()
            button("Say Hello") {
                onClick { ctx.toast("Hello, ${name.text}!") }
            }
        }
    }
}
复制代码

现在我们编译运行，发现效果和布局文件写的界面是一样的。但是它的性能是有优势的，其实吧并没有发觉性能优势。不管怎样，这种DSL确实便于阅读，也很容易上手，在上面的代码中，你可能注意到了dip(10),它表示将10dp转换为像素的意思，是Anko的扩展函数，说的扩展函数，如果阅读过Anko的源码我们发现里面大量的使用扩展函数，这也是Kotlin语言的优势之一。

这里就简单介绍下Layout的使用和优点。但是我想各位看官在实际开发中也不一定会用，因为不可视化用起来实在难以接受。不过这种见仁见智吧。

4.Anko SQLite: a query DSL and parser collection for Android SQLite;

Anko SQLite是一个查询解析SQLite的领域专用语言

SQLite 存在的不足：

1. 过多需要实现的模板代码；
2. 通过字符串实现 SQL 命令，容易出错，且编译时无法检查；
3. 每次需要手动关闭数据库；
4. 线程和同步访问的问题；

随着你应用的数据库越来越复杂，暴露出来的问题也会越多。所以也难怪很多人会选择 ORM 或者 NoSQL，但这带来的方便性是以增加应用大小和方法数为代价的。

如果你打算使用 Kotlin 来开发 Android 应用，那么现在通过 Anko SQLite 就可以很方便的进行 SQLite 操作了。比如可以告别麻烦的 Cursor 和 ContentValue、内置安全机制，保证数据库在执行所有代码后能够关闭。

通过继承 ManagedSQLiteOpenHelper 类来实现数据库帮助类，推荐做法就是按照官方的实现：

class DatabaseHelper(ctx: Context) : ManagedSQLiteOpenHelper(ctx, "LibraryDatabase", null, 1) {
  companion object {
    private var instance: DatabaseHelper? = null

    @Synchronized
    fun Instance(context: Context): DatabaseHelper {
      if (instance == null) {
        instance = DatabaseHelper(context.applicationContext)
      }
      return instance!!
    }
  }

  override fun onCreate(database: SQLiteDatabase) {
    createTable(Book.TABLE_NAME, true, Book.COLUMN_ID to INTEGER + PRIMARY_KEY, Book.COLUMN_TITLE to TEXT, Book.COLUMN_AUTHOR to TEXT)
  }

  override fun onUpgrade(database: SQLiteDatabase, oldVersion: Int, newVersion: Int) {
    dropTable(Book.TABLE_NAME, true)
  }
}
复制代码

访问数据库的推荐做法是通过依赖注入，或者为 Context 添加一个 extension:

val Context.database: DatabaseHelper
  get() = DatabaseHelper.Instance(applicationContext)
复制代码

下面这是一个简单的 model 类：

data class Book(val id: Int, val title: String, val author: String) {
  companion object {
    val Book.COLUMN_ID = "id"
    val TABLE_NAME = "books"
    val COLUMN_TITLE = "title"
    val COLUMN_AUTHOR = "author"
  }
}
复制代码

当数据库准备好后，就可以通过 use 方法来进行操作了。比如：

database.use {
    insert(Book.TABLE_NAME, Book.COLUMN_ID to 1, Book.COLUMN_TITLE to "2666", Book.COLUMN_AUTHOR to "Roberto Bolano")
}
复制代码

最后，让我们来比较一下常见库的大小：

要注意这里 Anko SQLite 的依赖大小其实是包含了 Kotlin Runtim (method count: 6298, DEX size: 1117 KB) 和 Anko Commons module (method count: 982, DEX size: 174 KB) 的。因此如果你是通过 Kotlin 来开发，Anko SQLite 增加的大小其实并没有图表显示得那么多。

因此，如果你在使用 Kotlin 做开发并且数据库的复杂度不高，首推 Anko SQLite。但如果数据库结构非常复杂，DAO 和 SQL 查询可能会变得很痛苦，这时候 ORM 和 NoSQL 就是首选方案了。

5.Anko Coroutines: utilities based on the kotlinx.coroutines library.

Kotlin协程 协程本质上是一个轻量级的线程，支持我们用同步写法写异步请求，而不用Callback。

doAsync(UI) {
    val data: Deferred<Data> = bg {
		// Runs in background
		getData()
    }

    // This code is executed on the UI thread
    showData(data.await())
}
复制代码

我们可以用bg（）在新的线程去做耗时操作，等返回结果再在UI线程进行操作。

具体协程教程我们可以看一下官方文档

Kotlin协程

6.总结

Anko是Kotlin官方开发的一个让开发Android应用更快速更简单的Kotlin库,并且能让我们书写的代码更简单清楚更容易阅读。 主要包含了以下几个部分。

1. Anko Commons: a lightweight library full of helpers for intents, dialogs, logging and so on;
2. Anko Layouts: a fast and type-safe way to write dynamic Android layouts;
3. Anko SQLite: a query DSL and parser collection for Android SQLite;
4. Anko Coroutines: utilities based on the kotlinx.coroutines library.

Anko库用起来非常的简单方便，里面设计到DSL和扩展函数。

关于DSL可以看下这篇文章

Kotlin 之美—DSL篇

关于扩展函数可以看下这篇文章

Kotlin 扩展函数详解与应用