Data binding Library官网文档翻译1 - 概述

前言

Data binding库出了有些年头了,网上相关的学习资料也已经很丰富了。但是本人在学习的时候感觉大部分博客,只停留在了具体的使用方法上,很多前因后果,细节问题都没有讲细致,所以只好硬着头皮看了一遍官网的文档。在这里根据自身理解,翻译一下官网的文档,希望对别的同学有帮助。本人英文水平也不好,肯定会有很多翻译的不准确的地方,欢迎大家批评指正。(本文基于2018年7月21日的官网最新文档内容)转载请注明出处,https://www.jianshu.com/p/fa3b65986fe3

附上官网链接,应该不用翻墙就可以看了。

1. Get started

学习如何配置Data Binding 库的开发环境,包括支持在Android Studio中的data binding 的代码。

Data binding库非常灵活,并且拥有很好的兼容性。它是一个支持库,Android 4.0(API 14)以上的设备上都可以使用。

尽管1.5.0版本以上的Android Plugin for Gradle都支持Databinding库。但是我们还是建议你在工程中使用最新版本的Android Plugin for Gradle。具体信息可以参考update the Android Plugin for Gradle.

2. 创建环境

使用databinding库之前,我们要先在Android SDK manager里面下载Support Reposity。此外,还要在Module :app级的build.gradle文件中增加如下代码:

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

注意:如果app module依赖的别的libraries使用了databinding,就必须在app module级别去配置databinding,即使没有直接使用databinding。

3. Android Studio中对databinding的支持

Android Studio支持了许多用于databinding相关代码的编辑功能。比如以下功能:

  • 语法高亮
  • 标记表达式语言语法错误
  • XML代码补全
  • 参考,包括导航(例如导航到声明)和快速文档

注意 :数组和泛型类型(如Observable类)可能会错误地显示错误。(看来这一块儿Databinding还有一些bug)

此外如果你向下面的代码中那样,提供了默认值,那么Layout Editor中的preview窗口就会将它展示出来。

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

如果你只需要在你的工程的设计阶段展示默认值的话,你可以转而使用 tools attributes(属性), 具体可以参考Tools Attributes Reference

4. 新的data binding编译器

3.1.0-alpha06版本的Android Gradle plugin提供了一个新的用于生成binding class的databinding编译器。新的编译器在大部分场景下都会加快生成binding class的速度。针对binding class的相关内容可以参考Generated binding classes

以前版本的编译器在编译你的managed ode的同事生成binding class。如果managed code编译失败,则可能会收到多个错误报告binding classes aren't found。新编译器通过在编译managed code之前生成binding class来防止这些错误。

在gradle.properties文件中使用如下代码就可以启用新编译器

android.databinding.enableV2=true

也可以通过添加如下参数,在gradle 命令中启用新编译器

-Pandroid.databinding.enableV2=true

注意:Android Plugin3.1版本中的新databinding编译器不向后兼容。您需要启用此功能并使用增量编译生来成所有binding class。但是,Android Plugin3.2版本中的新编译器与先前版本生成的绑定类兼容。3.2版本中的新编译器默认开启。也就是说如果你使用的plugin版本是3.1,可能需要清理原有的binding class,然后使用新编译器来生成。或者也可以升级版本到3.2,就可以与老版本的binding class兼容了。

当我们启用了新编译器之后还会带来以下变化:

  • Android Gradle plugin会在编译你的managed code之前,生成你的layouts的对应bingding classes。
  • 如果一个layout被include到多个目标资源配置中,databinding库会默认使用android.view.View作为共享同一个资源id的view的type。
  • library modules的binding class会被编译和打包进相应的Android Archive (AAR)文件中。依赖这些library modules的app modules不需要再额外生成binding classes了。更多关于AAR文件的内容,可以参考Create an Android Library
  • Binding Adapters只能影响自己module里的代码和自己module中的使用者(大致意思应该是不同module之间的adapters,不会互相影响。一个module中的代码只能使用自己module的adapters,adapters也只能影响自己module中的代码)。

后三点因为本人水平有限,感觉翻译的可能不对或者有歧义,需要的同学可以看下面的原文。

  • If a layout is included in more than one target resource configuration, the data binding library uses android.view.View as the default view type for all views that share the same resource id but not view type.
  • Binding classes for library modules are compiled and packaged into the corresponding Android Archive (AAR) file. App modules that depend on those library modules no longer need to regenerate the binding classes. For more information about AAR files, see Create an Android Library.
  • A module’s binding adapters can no longer change the behavior of adapters of the module’s dependencies. Binding adapters only affect code in its own module and consumers of the module.
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 162,408评论 4 371
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,690评论 2 307
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 112,036评论 0 255
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,726评论 0 221
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 53,123评论 3 296
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 41,037评论 1 225
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,178评论 2 318
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,964评论 0 213
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,703评论 1 250
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,863评论 2 254
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,333评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,658评论 3 263
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,374评论 3 244
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,195评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,988评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 36,167评论 2 285
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,970评论 2 279

推荐阅读更多精彩内容