Android Studio 使用Gradle引入第三方库文件的总结

不知不觉,使用Android Studio开发App已有一段时间了,接触到了各式各样的第三方库文件的引入,也是时候总结一波了。

使用Android Studio开发Android应用时,避免不了需要借助Gradle引入各式各样的第三方库文件,帮助我们更好的开发App,常见的引入方式有:Jar文件,so文件,Library库文件,aar文件,远程jcenter、maven仓库文件。这几种引入方式各有利弊,对应的gradle配置也有所不同,本文根据平时的使用经验,做一个简单的总结,帮助大家更好的利用Gradle引入第三方库文件。

jar文件


将jar文件复制至app module目录下的libs文件夹下,然后打开app module目录下的build.gradle配置文件,在dependencies项中添加配置命令,这里有两种配置方式可供选择:

  • 一次性引入libs目录下所有jar文件
compile fileTree(include: ['*.jar'], dir: 'libs')
  • 单个逐一引入jar文件
compile files('libs/universal-image-loader-1.8.6-with-sources.jar')

so文件


  • Gradle 旧版本

将so文件(包含arm64等文件夹)复制app module下面的libs文件夹中,和jar文件类似,然后在build.gradle的android栏目下添加一个task:指定so文件的目录,并将其转化为Jar文件。命令如下:

task nativeLibsToJar(type: Zip, description: "create a jar archive of the native libs") {  
        destinationDir file("$projectDir/libs")  
        baseName "Native_Libs2"  
        extension "jar"  
        from fileTree(dir: "libs", include: "**/*.so")  
        into "lib"  
    }  
  
    tasks.withType(JavaCompile) {  
        compileTask -> compileTask.dependsOn(nativeLibsToJar)  
    }  
  • Gradle 新版本

新版Gradle实现了自动打包编译so文件的功能,并且为so文件指定了默认的目录app/src/main/jniLibs,当然默认是没有这个文件夹的,我们只需要新建一个jniLibs文件夹,并将so文件复制到该文件夹下,编译运行即可。

通常,为了更好地管理第三方库文件,或者更简单地将Eclipse项目转化为Android Studio项目,建议将jar文件和so文件放在一起,统一搁置在app/libs目录下,此时,我们只需要在build.gradle的android一栏中添加如命令,指定so文件的目录即可:

    sourceSets {
        main {
                jniLibs.srcDirs = ['libs']
        }
    }

通过这种方式,编译过后,将项目目录切换至Android试图,可以看到,app目录下多了一个jniLibs文件夹,里面包含了引入的so文件和jar包,如下图所示,表示集成成功。

Library库文件


将第三方Library库文件复制到项目根目录下,打开项目根目录下的settings.gradle文件,添加配置命令,如:

include ':app', ':PullToRefresh'

然后打开app module目录下的build.gradle,添加配置命令,如:

compile project(':PullToRefresh')

小技巧:推荐在项目根目录下新建一个文件夹,如extras文件夹,将所有Library库文件都复制到该文件下,方便统一浏览管理,这样上面两步对应的配置命令将变成:

include ':app', ':extras:PullToRefresh'

compile project(':extras:PullToRefresh')

aar文件


aar其实也是一个压缩文件,相比jar文件,它能够含带res资源文件等,aar文件的引入方式有两种:

  • Module形式引入

选择File菜单,或者打开Project Structure界面,添加新的Module(New Module...),选择Import .JAR/.AAR Package,选择目标aar文件导入。导入之后,在项目根目录下会自动生成一个新的文件夹放置aar文件及其配置文件,如:

aar文件引入方式一.png

然后打开app module目录下的build.gradle配置文件,在dependencies依赖项中添加配置即可:

compile project(':qiniu-android-sdk-7.2.0')

注意:这种引入方式无法查看aar文件中的代码和资源等文件。

  • libs目录中引入

将aar文件复制到app module目录下的libs文件夹中,然后打开app module目录下的build.gradle配置文件,在android一栏中添加依赖:

repositories {
    flatDir {
        dirs 'libs'
    }
}

然后再在dependencies一栏中添加:

compile(name:'qiniu-android-sdk-7.2.0', ext:'aar')

对应完整的app module目录下的build.gradle配置文件如:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "com.feng.demo"
        minSdkVersion 11
        targetSdkVersion 23
        versionCode 1
        versionName "1.0.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

    repositories {
        flatDir {
            dirs 'libs'
        }
    }

}

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.3.0'
    compile project(':extras:PullToRefresh')
    compile 'com.squareup.okhttp3:okhttp:3.2.0'
    compile(name:'qiniu-android-sdk-7.2.0', ext:'aar')
}

重新同步,编译工程,然后可以在app的build目录下生成对应aar的临时文件,可以看到aar文件中的jar文件、资源文件等,看上去更像是一个解压缩文件夹:

aar文件引入方式二.png

jcenter、maven仓库文件


在项目根目录的build.gradle文件中添加仓库,如:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.0'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

然后再各个Module的build.gradle配置文件的dependencies项中添加依赖,格式为`compile 'name:version'`,如:

compile 'com.squareup.okhttp3:okhttp:3.2.0'

总结


以上便是针对Android Studio引入第三方库文件的几种方式,它们各有利弊,总结来看,就是在包含内容、源码修改、版本更新三方面上的差异。Jar文件只包含java代码,不像aar等其他文件能够包含res资源文件;Library文件形式的引入可以让开发人员根据自己的需求修改库文件源码,以达到适应自己项目的目的;而远程仓库形式的引入可以实现版本的自动检测更新,保证自己项目使用的第三方库文件始终是最新版本。

当然,一个优秀的第三方库一般会提供多种方式的引入,考虑到Eclipse和AS用户,至少要包含Jar文件和Gradle构建这两种,其他一些供应者会根据自己的功能模式提供其他引入方式,比如七牛云存储便提供了aar的引入方式。大家可以根据自己的项目需求选择合适的引入方式,毕竟,适合自己的才是最好的。

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

推荐阅读更多精彩内容