使用Android Studio开发Android应用时,为了更好地开发App,需要引入各种第三方库文件。一个优秀的第三方库一般会提供多种方式的引入,考虑到Eclipse和AS用户,至少要包含Jar文件和Gradle构建这两种,其他一些供应者会根据自己的功能模式提供其他引入方式,比如七牛云存储便提供了aar的引入方式。大家可以根据自己的项目需求选择合适的引入方式。
1. 常见引入方式及比较
(1) 常见的引入方式
有:jar文件、aar文件、so文件、Library库文件和远程jcenter、maven仓库文件。
(2) 这几种引入方式各有利弊,主要是在包含内容、源码修改、版本更新三方面上的差异。
- Jar文件只包含java代码,不像aar等其他文件能够包含res资源文件;
- Library文件形式的引入可以让开发人员根据自己的需求修改库文件源码,以达到适应自己项目的目的;
- 远程仓库形式的引入可以实现版本的自动检测更新,保证自己项目使用的第三方库文件始终是最新版本。
(3) 对应的gradle配置
也有所不同:具体引入和配置方式见下面
1. 引入jar文件
(1) 将jar文件复制至app module目录下的libs文件夹(将项目目录切换至Project视图即可找到该目录)下
(2) 然后打开app module目录下的build.gradle配置文件,在dependencies项中添加配置命令,这里有两种配置方式可供选择:
- 一次性引入libs目录下所有jar文件
api fileTree(include: ['*.jar'], dir: 'libs')
- 单个逐一引入jar文件
api files('libs/***.jar')
2. aar文件引入
aar其实也是一个压缩文件,相比jar文件,它能够含带res资源文件等,aar文件的引入方式有两种:
(1) Module形式引入:这种引入方式无法查看aar文件中的代码和资源等文件。
-
选择File菜单,或者打开Project Structure界面,添加新的Module(New Module...),选择Import .JAR/.AAR Package,选择目标aar文件导入。导入之后,在项目根目录下会自动生成一个新的文件夹放置aar文件及其配置文件,如:
image.png - 然后打开app module目录下的build.gradle配置文件,在dependencies依赖项中添加配置即可:
compile project(':qiniu-android-sdk-7.2.0')
(2) 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的build目录下生成对应aar的临时文件,可以看到aar文件中的jar文件、资源文件等,看上去更像是一个解压缩文件夹:
image.png
3. so文件引入
新版Gradle实现了自动打包编译so文件的功能,并且为so文件指定了默认的目录app/src/main/jniLibs,当然默认是没有这个文件夹的,我们只需要新建一个jniLibs文件夹(),并将so文件(包含arm64等文件夹)复制到该文件夹下,编译运行即可。
image.png
通常,为了更好地管理第三方库文件,或者更简单地将Eclipse项目转化为Android Studio项目,建议将jar文件和so文件放在一起,统一搁置在app/libs目录下,此时,我们只需要在build.gradle的android一栏中添加如命令,指定so文件的目录即可:
sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}
通过这种方式,编译过后,将项目目录切换至Android试图,可以看到,app目录下多了一个jniLibs文件夹,里面包含了引入的so文件和jar包,如下图所示,表示集成成功。
image.png
4. Library库文件引入
- 将第三方Library库文件复制到项目根目录下,打开项目根目录下的settings.gradle文件,添加配置命令,如:
include ':app', ':PullToRefresh'
- 然后打开app module目录下的build.gradle,添加配置命令,如:
api project(':PullToRefresh')
为了方便统一浏览管理,推荐在项目根目录下新建一个文件夹(如extras文件夹),将所有Library库文件都复制到该文件下,这样上面两步对应的配置命令将变成:
include ':app', ':extras:PullToRefresh'
和api project(':extras:PullToRefresh')
5. 远程jcenter、maven仓库文件引入
(1) 方式一:针对所有module
- 在Project的build.gradle文件中添加仓库(针对所有module)
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.0'
}
}
allprojects {
repositories {
jcenter()
maven { url 'https://download.01.org/crosswalk/releases/crosswalk/android/maven2'}
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
两个位置的 repositories 的区别
- buildscript 里是 gradle 脚本执行所需依赖,分别是对应的 maven 库和插件
- allprojects 里是项目本身需要的依赖
- 然后在各个Module的build.gradle配置文件的dependencies项中添加依赖,格式为`api 'name:version'`或`implementation 'name:version'`,如:
implementation 'org.xwalk:xwalk_core_library:23.53.589.4'
(2) 方式二:针对单个module
- 在对应 module 的 build.gradle 中添加 respositories
- 然后在该Module的build.gradle配置文件的dependencies项中添加依赖:
implementation 'org.xwalk:xwalk_core_library:23.53.589.4'
- 最终该module的配置如下
android {
}
repositories {
maven { url 'https://download.01.org/crosswalk/releases/crosswalk/android/maven2'}
}
dependencies {
implementation 'org.xwalk:xwalk_core_library:23.53.589.4'
}
网友评论