前言
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.