基于Android Studio使用gradle构建包含jni以及so的构建实例

简介

An Android Project with more than one module，the app module(some api developed by jni) depend on an Android Library which has native so.

该项目是一个使用Android Studio创建的，通过gradle编译的，存在多个模块的工程的gradle构建的事例。其中存在多个模块的工程中包含:

一个Android Library的模块，该模块使用了第三方的jar和so
一个Android Application模块，该模块引用上面的Android Library，自身包含jni的接口调用。

代码地址：

Github：https://github.com/bihe0832/Android-gradle-jni-so

体验方式

Demo 下载：

点击下载
扫码下载APK：

获取大写md5值的函数调用流程

运行工程：

准备工作

下面的两种方式都可以运行，不过运行之前要先根据自己的网络环境修改下面几个文件。
- 修改GradleTest下gradle/wrapper/gradle-wrapper.properties 关于使用的gradle-2.5-all.zip的地址的修改
- 修改GradleTest下build.gradle中对于使用的maven库的声明
- 修改MD5下gradle/wrapper/gradle-wrapper.properties 关于使用的gradle-2.5-all.zip的地址的修改
- 修改MD5下build.gradle中对于使用的maven库的声明
运行方式
- 使用Android Studio 逐个导入
- 直接在根目录运行build.sh

工程介绍

在项目中存在两个Android Studio的工程

GradleTest

GradleTest是核心工程，它里面包含了一个Android Library的模块gradletestlibrary和一个Android Application的模块app。

gradletestlibrary

一个Android Library的模块，他引入了第三方的so和jar(MD5工程的编译产出)，并对第三方的jar和so做了封装和调用。
app

一个Android Application的模块，他引用gradletestlibrary，同时里面包含jni的代码，通过native的方式调用gradletestlibrary提供的方法。

MD5

一个普通的Android 工程，他包含java和jni代码，最终打包后对外提供jar包和so。模拟第三方的jar和so提供给GradleTest使用。

关键代码结构

Android-gradle-jni-so
	│
	├─── build.sh 生成最终产出物的简单构建脚本，直接运行会生成最终的资源、apk和核心文件
	│
	├─── GradleTest 核心工程，一个存在多个Module的Android工程
	│		│
	│		├── app 基于Android Application的模块，引用gradletestlibrary，通过native的方式调用接口。
	│		│
	│		└── gradletestlibrary 基于Android Library的模块，引入MD5提供的jar和so
	│		
	├─── MD5 普通Android工程，他包含java和jni代码，最终打包后对外提供jar包和so
	│
   	└─── README.md 项目工程介绍

接口调用

下面用图示简单梳理demo中获取大写md5值的函数调用流程

获取大写md5值的函数调用流程

使用场景

说实话，这么设计一个工程是有点复杂，但是却存在实实际际的使用场景。上面的工程是自己根据一直以来SDK开发时实际经验总结，下面对该事例中的两个工程以及对应模块做个现实中的身份映射。

一点说明

首先、这个完整的架构是主要是提供给SDK的开发者或者大型项目存在公共代码库的情况下使用的。如果项目代码很少，确实不用搭建如此复杂的框架。

具体身份映射

MD5 ———— 映射SDK开发者或者项目公共库依赖的第三方库，例如SDK的开发者会用到一些第三方的数据统计、账号登陆SDK等
GradleTest ———— SDK开发者或者项目的工程
- gradletestlibrary SDK的具体实现，或者公共库的具体实现，最终可能也会以jar、甚至so的方式对外提供
- app 具体的应用工程，可能是SDK的开发者对外提供的配套demo，也可能是具体的开发者的应用工程，这就是一个普通的Android工程。

特别说明

本文档只是重点介绍整个项目的工程架构，对于具体的语法没有做说明，后续会逐步整理增加到博客。
- 目前gradle支持native构建需要使用特定的gradle版本和gradle tools版本以及NDK版本。具体相关说明可以参照Experimental Plugin User Guide中的说明。对于该项目来说，不要修改项目build.gradle中buildscript内对于gradle tools的版本的声明以及根目录gradle下gradle-wrapper.properties中对于gradle版本的说明。也就是说：
- 必须使用gradle-2.5-all 和 com.android.tools.build:gradle-experimental:0.2.+
- build.gradle 代码如下：
```
  buildscript {
			
      ……
			
      dependencies {
          classpath "com.android.tools.build:gradle-experimental:0.2.+"
      }
  }
```
- gradle-wrapper.properties 内容如下：
```
  #Tue Dec 15 16:08:58 CST 2015
  distributionBase=GRADLE_USER_HOME
  distributionPath=wrapper/dists
  zipStoreBase=GRADLE_USER_HOME
  zipStorePath=wrapper/dists
  distributionUrl=http\://services.gradle.org/distributions/gradle-2.5-all.zip
```

再次补充

当时写这个事例的时候gradle-experimental插件的0.2版本刚出，发现他对一些语法规则做了调整，不兼容Android gradle插件标准版的语法。也是因为这个原因当时写了对应的文档和事例。

前段时间再去看官方关于gradle experimental的介绍的时候惊诧的发现，最新版本的gradle-experimental插件的语法又部分改回了主流版本的语法规则，就悲催的发现这篇文章仅供参考了。因此这几天彻底重新调整了目录，方便后续编译。

那时年少

微信公共平台

前端开发

开发资源

终端开发

开发工具

经验总结

玩一玩

在路上

后台开发

标签

总结 8

公共平台 3

wordpress 1

API 1

web 9

资源 4

android 50

log 1

adb 6

学习资源 1

md5 1

bug 7

svn 2

命令 3

常用工具 8

Markdown 3

markdown 2

工具 30

经验 3

SDK 22

Android 13

NDK 1

jni 1

个人作品 7

终端 1

测试 7

签名 1

iMac 13

调试 1

学习 1

gradle 7

ant 1

旅行 8

php 1

git 2

mac 2

java 1

androir 1

sqlite 1

mysql 1

tags 53

apk 5

图片 1

规划 1

chrome 1

iOS 1

jekyll 1

ruby 1

schema 1

自动 3

appium 2

linux 1

webview 1

开发资源 1