.so文件的前世今生
早期的Android系统几乎只支持ARMv5的CPU架构,而现在它可以支持7种,几乎涵盖了市面上大部分的CPU架构。
Android系统目前支持的CPU架构主要包含以下7种:ARMv5,ARMv7 (从2010年起),x86 (从2011年起),MIPS (从2012年起),ARMv8,MIPS64和x86_64 (从2014年起),每一种都关联着一个相应的ABI。
二进制接口(ABI)
应用程序二进制接口(Application Binary Interface)定义了二进制文件(尤其是.so文件)如何运行在相应的系统平台上,从使用的指令集,内存对齐到可用的系统函数库。在Android中调用动态库文件(*.so)都是通过jni的方式。形如我们常见的:
void System.load(String pathName);
在Android系统上,每一个CPU架构对应一个ABI:armeabi,armeabi-v7a,x86,mips,arm64-v8a,mips64,x86_64。
Android平台生成.so文件
说了这么多,那么如何在Android平台上生成.so文件呢?
NDK环境搭建
关于ndk详细的理论请查看之前的讲解ndk详解,这里只做一个简单的环境搭建。
- 下载NDK
在Android Studio上下载即可。下载完后可以在structs目录查看。
- 打开项目根目录的local.properties文件
- 打开项目根目录的gradle.properties文件,添加
android.useDeprecatedNdk=true
这样ndk环境就搭建好了。
编写代码
1 . 创建一个Java类,以实现jni调用。
public class JniUtil { static { //括号的参数可以任意修改 System.loadLibrary("jniutil"); } //java调C/C++中的方法都需要用native声明且方法名必须和C/C++的方法名一样 public native String test(); }
2 . 根据JniUtil.class生成.h文件
打开Android Studio的Terminal,执行以下命令:
javah -d jni -classpath 编译后的class文件的绝对路径
执行上述命令后便会在app/src/main目录下自动创建一个包含.h文件的jni文件夹。
我们直接打开文件:
#include <jni.h> #ifndef _Included_com_othershe_jnitest_JniUtil #define _Included_com_othershe_jnitest_JniUtil #ifdef __cplusplus extern "C" { #endif JNIEXPORT jstring JNICALL Java_com_othershe_jnitest_JniUtil_test (JNIEnv *, jobject); #ifdef __cplusplus } #endif #endif
3 . 编写.c文件(jniutil.c)
这里的jniutil文件名需要和JniUtil类中System.loadLibrary(“jniutil”);的参数一致。
jniutil.c具体的编写可根据自己的业务实现,这里仅做测试:
#include "com_othershe_jnitest_JniUtil.h" JNIEXPORT jstring JNICALL Java_com_othershe_jnitest_JniUtil_test (JNIEnv *env, jobject obj) { return (*env)->NewStringUTF(env, "jni调用成功"); }
注:这里需要注意包名的统一。
4 . 配置项目app目录下的build.gradle文件
defaultConfig { applicationId "com.othershe.jnitest" minSdkVersion 14 targetSdkVersion 25 versionCode 1 versionName "1.0" ndk { moduleName "jniutil" abiFilters 'armeabi', 'x86', 'armeabi-v7a' //输出指定三种abi体系结构下的so库。 } }
其中ndk标签是新添加的,moduleName 的值同样为System.loadLibrary(“jniutil”);的参数。由于配置了abiFilters,则只会得到armeabi、x86、armeabi-v7a三种ABI对应的.so文件。
最后还需要在生成的jni文件夹下创建一个空的util.c文件,否则会有如下异常:
完成以上操作后,jni文件的目录如下:
生成.so文件
其实到这一步就已经完成了,那么我们怎么验证我们是否成功的创建了.so文件呢?现在我们来测试一下,写个TextView显示一下调用的C:
public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); TextView tv = (TextView)findViewById(R.id.tv); tv.setText(new JniUtil().getString()); } }
使用.so文件需要注意的地方
当你编译.so文件时,经常会出现一些错误,其中最多的是”UnsatisfiedLinkError”,”dlopen: failed”以及其他类型的crash或者低下的性能:
高版本编译的.so文件运行在低版本手机上
NDK平台不是向后兼容的,而是向前兼容的,推荐使用app的minSdkVersion对应的编译平台。
每个支持的CPU架构都需要一套对应的.so文件
这个就好比32位的软件没办法运行在64位的CPU上,必须为每一个CPU架构提供一套.so文件。