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

@author ASCE1885的 Github 简书 微博 CSDN 知乎
本文由于潜在的商业目的,不开放全文转载许可,谢谢!

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容