Android Robolectric 加载运行本地 So 动态库

原文发表于：http://rocko.xyz/2016/11/27/Android-Robolectric-加载运行本地-so-动态库/

前言

Robolectric 是 Android 的单元测试框架，运行无需 Android 真机环境直接运行在 JVM 之上，因此在 test case 运行速度效率上有了很大提高，接近于 Java JUnit test（JUnit test > Robolectric ≫ androidTest）。不过框架自己并不支持 so 本地库的加载使用，加载时会直接报错，由于实际上运行环境是电脑机器，而咱们打出的 so 文件是给手机上用的因此固然会报错。虽然在 GitHub 上不少人问过关于使用 so 的问题但基本都建议说不要在单元测试中去加载本地库，这在原则上是要这么作，但可能有些项目中作起来就有些困难了，好比在代码结构不够好、依赖耦合较大或者自己就对 so 库依赖很大的状况下。因此下面说说在项目中 Robolectric 要怎么解决须要加载运行本地 so 库这个问题。

动态库

动态库又称动态连接库（Dynamic-link library 缩写 DLL），是一个包含可由多个程序同时使用的代码和数据的库，DLL 不是可执行文件。动态连接提供了一种方法，使进程能够调用不属于其可执行代码的函数。函数的可执行代码位于一个 DLL 中，该 DLL 包含一个或多个已被编译、连接并与使用它们的进程分开存储的函数。DLL 还有助于共享数据和资源。多个应用程序可同时访问内存中单个DLL 副本的内容。DLL 是一个包含可由多个程序同时使用的代码和数据的库。Windows下动态库为 .dll 后缀（通常为 PE 格式），在 Linux 在为 .so 后缀（通常为 ELF 格式），macOS下为 .dylib 后缀（通常为 Mach-O 格式）。因为 CPU 架构和动态库文件格式的不一样于是在不一样平台下不能通用。其它细节的东西就不展开了由于也不会 :-)

而 Android 自己是 Linux 系统，因此用的动态库也是 .so 的文件，于是运行与 JVM 的 Robolectric 是不能直接加载使用的（Linux 某些状况下可用，下面提到）。

Robolectric 中使用动态库

咱们知道动态库通常都是打给特定平台、特定 CPU 架构用的，因此要解决在 Robolectric 下加载运行 so 动态库的问题的思路就是在不一样 Robolectric 运行平台下去处理加载不一样的动态库，因此你要在 Ronbolectriv 中使用的 so 动态库最好要有源码否则在 macOS 和 Windows 下就不就好处理了。

Note: 注意动态库名称已 lib 开头。

Linux 下 Robolectric 中使用动态库

Android 与 Linux 同气连枝，因此底层的东西不少是通用的，动态库也同样。咱们 Android 使用 so 时通常也要对不一样 CPU 架构的手机下使用不一样的 so 文件，譬如：armeabi-v7a、mips、x86。而咱们使用的 LInux 发行版通常都是 64 位的，因此原理上咱们使用 x86-64 的动态库是能够的，不过可能须要处理依赖库问题若是你的本地代码里有 include 其它依赖的话。若是没加进来 Robolectric 运行就会报以下的错误：

java.lang.UnsatisfiedLinkError: xxx/xxx.so xxx 动态库找不到。

xxx.so 就是你所使用 so 的依赖，好比把新浪微博 SDK 的 x86-64 的 libweibosdkcore.so 加载进来的话就会报 liblog.so 等找不到，由于 libweibosdkcore 中有对 Android liblog 等 so 库的依赖。那这个问题怎么解决呢。咱们想一想打包 so 库时用的是 ndk，须要使用 ndk-bundle 工具，咱们想一想，跟编译 apk 差很少，apk 打包须要 sdk 工具，compileSdk 里就是咱们编译的依赖，里面有 android.jar。因此咱们能够到 ndk-bundle 里找找，最后咱们发现不一样 CPU 架构下的 so 依赖库都是有的，像咱们通常的电脑 64 位 CPU 便可使用 arch-x86_64 下的 so 动态库，因此咱们只须要在加载咱们程序的 so 库以前加载这些必须的依赖便可。处理代码后面贴出。

注意 ndk-bundle 里的 so 也是只能在 Linux 下用的，若是用于其它平台会报错，缘由前面已说明。

java.lang.UnsatisfiedLinkError: xxx.so: unknown file type, first eight bytes: 0x7F 0x45 0x4C 0x46 0x02 0x01 0x01 0x00

macOS 下 Robolectric 中使用动态库

前面已提到，不一样平台下动态连接库是不通用的，因此必须对源码从新编译打包以移植到不一样平台下，若是你的 so 没有源码的话那在 macOS 和 Windows 下就行不通了。从新打包咱们能够按以下两步进行：

# 先生成 .o ，-I 后加进 Java jni 的编译依赖

cc -c -I/System/Library/Frameworks/JavaVM.framework/Headers *.cpp

# 打包成 .dylib

g++ -dynamiclib -undefined suppress -flat_namespace *.o -o something.dylib

某些依赖库能够到 /usr/lib 下找找，好比 libc 和 libstdc++ 。

Windows 下 Robolectric 中使用动态库

本人没有在 Windows 下开发因此这部分就略过了，思路是同样的。

Sample

下面是简单的处理代码示例。首先新建一个包含 jni 的工程，里面写个基本的本地库，以下：

正常流程

// native-lib.cpp

#include <jni.h>
#include <string>

extern "C"
jstring
Java_xyz_rocko_rsnl_nativeinterface_NativeSample_stringFromJNI(
       JNIEnv *env,
       jobject /* this */) {

   // 简单返回个字符串
   std::string hello = "Hello from Native.";
   return env->NewStringUTF(hello.c_str());
}

而后在 Application 启动时会加载这个本地库：

// NativeLibsApplication.java

public class NativeLibsApplication extends Application {

 // Used to load the 'native-lib' library on application startup.
 static {
   System.loadLibrary("native-lib");
 }
}

此时运行 Robolectric 的 test case 就发生以下报错：

java.lang.UnsatisfiedLinkError: no native-lib in java.library.path

处理后的流程

首先流程应该在咱们的代码里避免能够直接加载 so 动态库，而后 Robolectric 在启动时本身去加载须要的动态库。

// NativeLibsApplication.java

public class NativeLibsApplication extends Application {

 @Override public void onCreate() {
   super.onCreate();
   loadNativeLibraries();
 }

 /**
  * 简单让子类可本身实现
  */
 protected void loadNativeLibraries() {

    // 代码里真正加载本地库的地方，固然你本身的能够处理地更解耦一点。
   NativeLibrariesManager.loadNativeLibraries();
 }
}

而后咱们的 Robolectric 里自定义本身的 Application，里面根据须要在不一样运行平台下本身加载须要的本地动态库，首先复制咱们给 Robolectric 用的本地库到 test 的 libs 文件夹里，按不一样平台分类，以下图：

Linux 下的咱们从 ndk-bundle 里复制咱们须要的 .so，而后咱们本身的本地库打一个 x86-64 的便可，注意 compileSdkVersion 选上高一点支持 x86-64 的版本。

而后从新移植打出 macOS 下的动态库，简单写个打包脚本以下：

// make_macOS_dylib.sh

#!/usr/bin/env bash

OUTPUT=../../../build/intermediates/dylibs
mkdir -p ${OUTPUT}

# .o file
cc -c -I/System/Library/Frameworks/JavaVM.framework/Headers *.cpp -o ${OUTPUT}/libnative-lib.o

# .dylib file
g++ -dynamiclib -undefined suppress -flat_namespace ${OUTPUT}/*.o -o ${OUTPUT}/libnative-lib.dylib

libnative-lib.dylib 就是咱们要的。

而后咱们自定义 Application 处理加载这些动态库：

// RobolectricApplication.java

public class RobolectricApplication extends NativeLibsApplication {

 static {
   ShadowLog.stream = System.out; //Android logcat output.
 }

 @Override protected void loadNativeLibraries() {
   //Disable super class load so file.
   //super.loadNativeLibraries();
   Log.d(TAG, "=====>> Robolectric start native libraries.");

   String libsBasePath =
       new File(new File("").getAbsolutePath() + "/src/test/libs").getAbsolutePath();
   String os = System.getProperty("os.name");
   os = !TextUtils.isEmpty(os) ? os : "";
   List<File> soFileList = new ArrayList<>();
   String systemArchPath = libsBasePath + "/framework/";
   //!!! 64 位机器下处理
   if (os.contains("Mac")) {
     //load system library if need
     String macSysSoBasePath = systemArchPath + "macOS/";
     soFileList.addAll(addLibs(macSysSoBasePath));
     // App so...
     String macAppSoPath = libsBasePath + "/macOS_x86-64/";
     // mac下so要使用macOS专用库
     soFileList.addAll(addLibs(macAppSoPath));
   } else if (os.contains("Linux")) {
     //load system library if need
     String linuxSysSoBasePath = systemArchPath + "arch_x86-64/";
     soFileList.addAll(addLibs(linuxSysSoBasePath));
     // App so...
     String linuxAppSoPath = libsBasePath + "/linux_x86-64/";
     soFileList.addAll(addLibs(linuxAppSoPath));
   } else if (os.contains("Windows")) {
     // ignore
   }

   for (File soFie : soFileList) {
     System.load(soFie.getAbsolutePath());
   }
 }

 private List<File> addLibs(@NonNull String path) {
   File[] basePathFiles = new File(path).listFiles();
   List<File> pathFilesList = new ArrayList<>();
   if (basePathFiles != null && basePathFiles.length > 0) {
     pathFilesList.addAll(Arrays.asList(basePathFiles));
   }
   return pathFilesList;
 }
}

如今就能够加载了，运行以下 test case，结果以下图，成功了。

@Test public void testLoadNativeLibrariesSuccess() throws Exception {
      String nativeExcepted = "Hello from Native.";
      String result = NativeSample.stringFromJNI();
      Log.d(TAG, "result: " + result);
      assertEquals(nativeExcepted, result);
}

End

Linux 下使用最快速方便，只须要打包程序的 so 时顺便打包出 x86-64 的 so ，而后复制 ndk-bundle 的 so 加上须要的依赖便可。macOS 和 Windows 下就须要本身打包出各自平台下的动态库才可以使用，若是代码里有 Android 自带 so 依赖的话那就须要本身去从新移植编译打包 ndk-bundle 里的动态库了。

项目实例源码：RobolectricSupportNativeLibs

参考

Core Java APIs and the Java Runtime on OS X