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

前言

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

今天咱们就来介绍一下今天的主角---Ankojava

1.Anko

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

  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 如何使用

添加依赖android

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

这里面包括上面四个部分,固然你也能够只依赖一个部分,以下:sql

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() 方法传递,就像这样:bash

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

然鹅你用Anko只须要这样:app

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

相关文章
相关标签/搜索