@author ASCE1885的 Github 简书 微博 CSDN 知乎
本文由于潜在的商业目的,不开放全文转载许可,谢谢!
Android 应用开发中,经常需要将第三方开源函数库作为依赖引入工程中,通常情况下官方提供的都是在线依赖方式,如下所示是引入 greenDAO 3 的配置:
buildscript {
repositories {
mavenCentral()
}
dependencies {
// greenDAO 所需的 gradle 插件
classpath 'org.greenrobot:greendao-gradle-plugin:3.2.0'
}
}
// 应用 greenDAO 插件
apply plugin: 'org.greenrobot.greendao'
dependencies {
// greenDAO 函数库
compile 'org.greenrobot:greendao:3.2.0'
}
可以看到,引入 greenDAO 3 需要下载两种类型的依赖:
- greenDAO 3 所需的 gradle 插件及其依赖
- 开发者用到的 greenDAO 3 函数库
如果是个人开发,那么使用这种在线依赖的方式并没有什么大问题,但如果是团队开发,每个成员都要在自己电脑上下载一次这些依赖项,如果网速快还好说,可能只需等个几分钟,但如果网速比较慢,有时需要等上半天,这显然是降低团队效率的事。因此,团队开发中,要么搭建私有的 maven 仓库提高下载速度,要么直接将在线依赖方式改为离线依赖的方式,省去下载的耗时。
为了实现离线依赖,首先当然需要有人将这些依赖下载到本地,然后上传到版本控制系统例如 git 中,那么如何下载呢?我们当然可以到 maven 仓库中一个一个依赖地去查找并下载,但推荐的方式是走一遍在线依赖下载的方式,让 gradle 帮我们去下载到本地的缓存中。以 Mac 系统为例,但 gradle 按照在线依赖的配置下载完成后,我们可以在 /Users/你的用户名/.gradle/caches/modules-2/files-2.
目录中看到之前下载的所有依赖,如下所示:
根据依赖的包名,我们可以找到对应的 jar 包。以 greenDAO 3 为例,最终我们看到开发者需要引入工程中的依赖有两个:
- greendao-3.2.0.jar
- greendao-api-3.2.0.jar
而 greenDAO 3 所需的 gradle 插件及其依赖就有点多了,如下所示,可以看到这个插件使用 Kotlin 编写的,插个题外话,最近很多开源项目中,这种编译时注解的处理器很多都改用 Kotlin 编写,除了 greenDAO 3,新兴的 ORM 框架 DBFlow 的注解处理器也是用 Kotlin 编写的。
依赖库下载完成后,接下来就要修改配置的方式了,开发者用到的 greenDAO 3 函数库的修改很简单,只需将对应的 jar 包拷贝到相应 Module 的 libs 目录中,并将 build.gradle 中的
dependencies {
// greenDAO 函数库
compile 'org.greenrobot:greendao:3.2.0'
}
改为如下所示即可:
dependencies {
compile files('libs/greendao-3.2.0.jar') // orm框架
compile files('libs/greendao-api-3.2.0.jar')
}
greenDAO 3 的 gradle 插件的引入,在线方式是在工程的 build.gradle 文件中添加如下配置:
buildscript {
repositories {
mavenCentral()
}
dependencies {
// greenDAO 所需的 gradle 插件
classpath 'org.greenrobot:greendao-gradle-plugin:3.2.0'
}
}
改成离线依赖也很简单,修改为指向本地工程目录即可,下面的配置我们假设插件及其依赖包放在工程根目录的 thirdparty/orm/plugin
文件夹中。
buildscript {
dependencies {
// greenDAO 所需的 gradle 插件
classpath fileTree(include: ['*.jar'], dir: 'thirdparty/orm/plugin')
}
}
本文之所以以 greenDAO 3 为例,是因为它是目前 Android 开发中综合性能较高的一个框架,如下图所示:
当然,greenDAO 虽然性能最高,但 2.x.x 版本使用起来并不是很方便,需要在项目中单独引入一个 Java Module 来实现代码的生成;在 3.x.x 版本中,greenDAO 3 使用 gradle 插件的方式来实现代码生成,使用上方便了很多,但存在一个主要的问题是:目前对于 Android Studio 多 Modules 的支持不够好,如果要在多个 Module 中都使用 greenDAO 3 的话,那么每个 Module 需要单独建立一个数据库,不支持同一个数据库在不同 Module 之间共用。
我的新书《Android 高级进阶》开始正式发售了,欢迎选购!
欢迎关注我的微信公众号 ASCE1885,专注与原创或者分享 Android,iOS,ReactNative,Web 前端移动开发领域高质量文章,主要包括业界最新动态,前沿技术趋势,开源函数库与工具等。