AS借助Gradle引入第三方库

使用Android Studio开发Android应用时，为了更好地开发App，需要引入各种第三方库文件。一个优秀的第三方库一般会提供多种方式的引入，考虑到Eclipse和AS用户，至少要包含Jar文件和Gradle构建这两种，其他一些供应者会根据自己的功能模式提供其他引入方式，比如七牛云存储便提供了aar的引入方式。大家可以根据自己的项目需求选择合适的引入方式。

拓展：compile、api和implementation 的区别

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'
}