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

7,055 阅读6分钟

前言

最近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 扩展函数详解与应用