android 函数库,Android Studio 实现开源函数库的离线依赖－greenDAO 3 为例

@author ASCE1885的 Github 简书 微博 CSDN 知乎

本文由于潜在的商业目的，不开放全文转载许可，谢谢！

nami.png-599.1kB

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. 目录中看到之前下载的所有依赖，如下所示：

image_1b0ierpic128a1baa1lru10hu9fd9.png-155kB

根据依赖的包名，我们可以找到对应的 jar 包。以 greenDAO 3 为例，最终我们看到开发者需要引入工程中的依赖有两个：

greendao-3.2.0.jar

greendao-api-3.2.0.jar

而 greenDAO 3 所需的 gradle 插件及其依赖就有点多了，如下所示，可以看到这个插件使用 Kotlin 编写的，插个题外话，最近很多开源项目中，这种编译时注解的处理器很多都改用 Kotlin 编写，除了 greenDAO 3，新兴的 ORM 框架 DBFlow 的注解处理器也是用 Kotlin 编写的。

image_1b0i79k4a1e5d1shmk3fsm31dva16.png-127.3kB

依赖库下载完成后，接下来就要修改配置的方式了，开发者用到的 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 开发中综合性能较高的一个框架，如下图所示：

image_1b0i70rjlhs112251hdv17fshot9.png-39.5kB

当然，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 前端移动开发领域高质量文章，主要包括业界最新动态，前沿技术趋势，开源函数库与工具等。