在命令行下用cmake交叉编译可在android中运行的so包

时间:2024-04-05 18:52:55

在命令行下用CMake交叉编译可在android中运行的so包

最近在写一个通过录屏生成gif的小应用,由于要用到NDK,所以开始去解这方面的知识,总的来讲也还算简单,不过对于之前从没接触过ndk的小白来说,一切都是需要摸索的,在一个不熟悉的领域有时候一个微小的问题也能让你摸个半天才能搞明白。我写博客的大部分原因就是为了记录下这些摸索的过程,以后要是忘记了还可以翻出来看,当然,要是还能帮到其他跟我一样的小白那就更好了。

下面进入正题,对于陌生的东西,当然是先google一翻了,随后发现Android Studio已经帮我们做了很多工作了,我们只需要做些简单的配置就可以做NDK开发了。大致有以下几步(具体的细节这里不讲):

  • 1、下载好NDK、CMake
  • 2、新建一个android工程
  • 3、在build.gradle文件中配置c文件相关的路径以及CMakelists.txt路径等等
  • 4、创建一个带native方法的java类
  • 5、再编写一个与上述类对应的c文件
  • 6、编写CMakeLists.txt文件

然后跑起来就差不多了,流程基本上就这样了,剩下的就是业务上的事了。

不过对于小白来说,照着教程做了一遍,工程跑起来了,预期结果也达到了,但还是一脸懵懂,不知道来龙去脉。用Android Studio的好处是高度智能化,开发者借助它可以快速地完成一些与业务无关的事,但也有一点我个人不喜欢,那就是不知道它到底做了些什么,像个黑盒子,只看到结果,看不到过程。所以几乎从一开始我就很想知道如果不依赖android studio 怎么才能把我要的so包编译出来呢?就好比不需要eclipse,直接在命令行下编译运行java程序一样。不得不说,为了搞明白这点事,我摸了很久,并且曾暂停了一段时间。下面就来说一下不用android studio怎么编译so包,说出来之后会觉得很简单,但没搞清楚之前却是让我非常抓狂。

在命令行下执行交叉编译有两种方式

  • 一是用NDK自带的工具链
  • 二是使用独立工具链

第一种简单点,第二种麻烦点,不过简单的却花了我更多的时间和精力,因为没有在网上找到现成的资料。本文讲第一种,使用独立工具链的方式请看 cmake使用独立工具链交叉编译可在android中运行的so包 一文。

注:本文的例子是在Ubuntu操作系统下完成的

一、按照JNI的实现方式建一个工程

JNI的实现大概有以下几步:

  • 编写带有 native 方法的 Java 类
  • 生成该类扩展名为 .h 的头文件
  • 创建该头文件的 C/C++ 文件,实现 native 方法
  • 将该 C/C++ 文件编译成动态链接库
  • 在Java 程序中加载该动态链接库

最后建好的工程目录如下图所示

在命令行下用cmake交叉编译可在android中运行的so包

MyJni类是一个带native方法的java类

Navive.c是实现native方法的本地类
内容如下:
在命令行下用cmake交叉编译可在android中运行的so包

仅打印了一句日志。

CMakeLists.txt的内容如下:
在命令行下用cmake交叉编译可在android中运行的so包

添加了一个myso的动态库,输出到c目录下的lib目录中(实际输出的名字叫:libmyso.so)

至此,如果不需要交叉编译的话进入build目录下执行下面两条命令就可以生成so包了(目前build只是个空目录)

$ cmake ..

$ make

不过这个so包只能在当前pc上使用,不能用在手机上(实际上这个例子按上面的方法执行是会报错的,因为用到了android的日志,会找不到头文件的,这里只是说明一下本地编译与交叉编译的区别)。如果要交叉编译就要配置交叉编译环境,这就是今天的重头戏。

二、配置交叉编译环境

写一个脚本来记录这些参数,在build目录下新建configuer.sh文件,内容如下:
在命令行下用cmake交叉编译可在android中运行的so包

这里对各个参数作个解释:

ANDROID_ABI 是cpu架构

ANDROID_PLATFORM是支持的最低android平台

ANDROID_NDK是ndk的根目录

CMAKE_TOOLCHAIN _FILE是工具链文件,这个参数非常重要,这里面还配置了很多其它参数。

ANDROID_TOOLCHAIN是C/C++编译器,可选Clang和gcc,官网推荐clang

最后还有两个点,代表上一级目录,即CMakeLists.txt所在的目录

在build目录下执行这个脚本,再执行make命令,可用于android的so包就出来了。
在命令行下用cmake交叉编译可在android中运行的so包

在命令行下用cmake交叉编译可在android中运行的so包



验证

下面来验证一下,看看这个so能否在android工程中使用。
创建一个android工程,将so包拷到jniLibs目录下,MyJni.java拷到对应的目录下。
在命令行下用cmake交叉编译可在android中运行的so包

在MainActivity中调用:

在命令行下用cmake交叉编译可在android中运行的so包

看一下日志:

在命令行下用cmake交叉编译可在android中运行的so包

可以看到已经成功调到了so包里的方法,第一句就是从Native.c文件输出的。第二句是在MainActivity里面输出的。

源码

https://github.com/MingHuang1024/CrossCompileForAndroidUseCommand

验证的那个android工程就不上了,如果要的话就联系我。



由于水平有限,如果文中存在错误之处,请大家批评指正,欢迎大家一起来分享、探讨!

博客:http://blog.csdn.net/MingHuang2017

GitHub:https://github.com/MingHuang1024

Email:[email protected]

微信:724360018