框架组件(二)Data Binding 1-起步

该系列文章是对Android推出的架构组件相关文章,按作者自己理解来翻译的,同时标记有作者自己一些简单笔记。如果读者发现文中有翻译不准确的地方,或者理解错误的地方,请不吝指教。

源自Google官方
Data Binding Library
一文的翻译与归纳

其他相关链接:
Android Jetpack Components

[TOC]

前言

Data Binding 库是一个 support library,允许你通过声明的方式将数据绑定到 UI 组件,而不是通过编码的方式。

我们通常会将控件定义在 activity 中来调用 UI 框架方法。举个例子,以下代码展示了通过 findViewById() 方法来找到 TextView 控件,并将 viewModeluserName绑定到该控件上。

TextView textView = findViewById(R.id.sample_text);
textView.setText(viewModel.getUserName());

下面的列子展示了如何使用 Data Binding 库直接给布局文件中的控件设置文本。而这个过程不需要编写任何Java代码,请注意复制表达式使用 @{} 语法:

<TextView
    android:text="@{viewmodel.userName}" />

起步

学习如何让你的开发环境集成 Data Binding 库,以及 Android Studio 配置 Data Binding 库的代码。

Data Binding 是一个灵活且兼容的支持库,所以在4.0(API 14)及以上版本都可以使用它。

我们推荐使用最新的 Android Gradle 插件,但是 Data Binding 库支持1.5.0以上版本。这里可以获取关于如何更新 Android Gradle 插件的信息。

Build 环境

为了使用 data binding ,我们需要在 Android SDK Manager 中下载 Support Repository 相关库。

需要在 app 模块的 build.gradle 中添加 dataBinding 节点,表明应用使用 data binding。如下例子所示:

android {
    ...
    dataBinding {
        enabled = true
    }
}

注意:如果你的 app 依赖的库使用了 data binding,那么你必须为 app 模块配置 data binding,即使你的 app 模块没有直接使用 data binding。

Android Studio 对 data binding 的支持

Android Studio 支持许多用于编辑 data binding 代码的功能。以下是几个主要功能的说明:

  • 语法高亮
  • 标记表达式语言语法错误
  • XML代码自动补全
  • 引用提示和快捷文档

布局编辑器中预览面板显示 data binding 表达式中提供的默认值。在下面例子中,预览面板将在 TextView 中显示 my_default 的值。

<TextView android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.firstName, default=my_default}"/>

如果你只需要在项目设计阶段显示默认值,你可以使用 tools 属性替代表达式默认值,可以参考 Tools Attributes Reference

用于绑定类的新 data binding 编译器

3.1.0-alpha06 版本的 Android Gradle 插件包含一个新的 data binding 编译器来生成绑定类。新的编译器增量创建绑定类,提升了build处理速度。更多关于绑定类的信息,可以参考生成的绑定类

以前版本 data binding 编译器在编译代码的同一步骤中生成绑定类,可能会由于未找到绑定类的错误,导致你的代码编译失败。新的 data binding 编译器会在构建应用前生产绑定类,从而避免了这些错误。

要使用新的 data binding 编译器,需要在gradle.properties中添加如下配置:

android.databinding.enableV2=true

你也可以通过以下参数在gradle命令中启用新编译器:

-Pandroid.databinding.enableV2=true

注意:Android 插件3.1 版本中新 data binding 编译器不向后兼容。你需要手动启用此功能来利用增量编译生成所有绑定类。但是,Android 插件3.2中的新编译器与先前版本生成的绑定类兼容,3.2版本默认使用新的编译器。

启用新编译器后,会有以下几点变化:

  • Android gradle 插件会在编译你的代码之前生成为你的布局生成绑定类。
  • 如果一个布局包含在多个资源配置中,data binding 库使用android.view.View作为共享相同ID的默认类型,而不会用view 类型。
  • module 的绑定类会被编译到相应的 aar 文件中。依赖 module 的 app 不再需要重新生成绑定类。
  • 一个模块的绑定适配器不能更新所依赖模块的适配器行为。绑定适配器只影响自身模块与模块使用者的代码。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,204评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,091评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,548评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,657评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,689评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,554评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,302评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,216评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,661评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,851评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,977评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,697评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,306评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,898评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,019评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,138评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,927评论 2 355

推荐阅读更多精彩内容