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 运行就会报如下的错误:


  1. 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 下用的,如果用于其它平台会报错,原因前面已说明。


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

macOS 下 Robolectric 中使用动态库

前面已提到,不同平台下动态链接库是不通用的,所以必须对源码重新编译打包以移植到不同平台下,如果你的 so 没有源码的话那在 macOS 和 Windows 下就行不通了。重新打包我们可以按如下两步进行:


  1. # 先生成 .o ,-I 后加进 Java jni 的编译依赖 
  2.  
  3. cc -c -I/System/Library/Frameworks/JavaVM.framework/Headers *.cpp 
  4.  
  5. # 打包成 .dylib 
  6.  
  7. g++ -dynamiclib -undefined suppress -flat_namespace *.o -o something.dylib  

某些依赖库可以到 /usr/lib 下找找,比如 libc 和 libstdc++ 。

Windows 下 Robolectric 中使用动态库

本人没有在 Windows 下开发所以这部分就略过了,思路是一样的。

Sample

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

正常流程


// native-lib.cpp 

  1.  
  2.  
  3. #include <jni.h> 
  4. #include <string> 
  5.  
  6. extern "C" 
  7. jstring 
  8. Java_xyz_rocko_rsnl_nativeinterface_NativeSample_stringFromJNI( 
  9.        JNIEnv *env, 
  10.        jobject /* this */) { 
  11.  
  12.    // 简单返回个字符串 
  13.    std::string hello = "Hello from Native."; 
  14.    return env->NewStringUTF(hello.c_str()); 
  15. }  

然后在 Application 启动时会加载这个本地库:

// NativeLibsApplication.java


  1. public class NativeLibsApplication extends Application { 
  2.  
  3.  // Used to load the 'native-lib' library on application startup. 
  4.  static { 
  5.    System.loadLibrary("native-lib"); 
  6.  } 
  7. }  

此时运行 Robolectric 的 test case 就发生如下报错:


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

处理后的流程

首先流程应该在我们的代码里避免可以直接加载 so 动态库,然后 Robolectric 在启动时自己去加载需要的动态库。

// NativeLibsApplication.java


  1. public class NativeLibsApplication extends Application { 
  2.  
  3.  @Override public void onCreate() { 
  4.    super.onCreate(); 
  5.    loadNativeLibraries(); 
  6.  } 
  7.  
  8.  /** 
  9.   * 简单让子类可自己实现 
  10.   */ 
  11.  protected void loadNativeLibraries() { 
  12.  
  13.     // 代码里真正加载本地库的地方,当然你自己的可以处理地更解耦一点。 
  14.    NativeLibrariesManager.loadNativeLibraries(); 
  15.  } 
  16. }  

然后我们的 Robolectric 里自定义自己的 Application,里面根据需要在不同运行平台下自己加载需要的本地动态库,首先复制我们给 Robolectric 用的本地库到 test 的 libs 文件夹里,按不同平台分类,如下图:

Linux 下的我们从 ndk-bundle 里复制我们需要的 .so,然后我们自己的本地库打一个 x86-64 的即可,注意 compileSdkVersion 选上高一点支持 x86-64 的版本。

然后重新移植打出 macOS 下的动态库,简单写个打包脚本如下:

// make_macOS_dylib.sh


  1. #!/usr/bin/env bash 
  2.  
  3. OUTPUT=../../../build/intermediates/dylibs 
  4. mkdir -p ${OUTPUT} 
  5.  
  6. # .o file 
  7. cc -c -I/System/Library/Frameworks/JavaVM.framework/Headers *.cpp -o ${OUTPUT}/libnative-lib.o 
  8.  
  9. # .dylib file 
  10. g++ -dynamiclib -undefined suppress -flat_namespace ${OUTPUT}/*.o -o ${OUTPUT}/libnative-lib.dylib  

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

然后我们自定义 Application 处理加载这些动态库:

// RobolectricApplication.java


  1. public class RobolectricApplication extends NativeLibsApplication { 
  2.  
  3.  static { 
  4.    ShadowLog.stream = System.out; //Android logcat output. 
  5.  } 
  6.  
  7.  @Override protected void loadNativeLibraries() { 
  8.    //Disable super class load so file. 
  9.    //super.loadNativeLibraries(); 
  10.    Log.d(TAG, "=====>> Robolectric start native libraries."); 
  11.  
  12.    String libsBasePath = 
  13.        new File(new File("").getAbsolutePath() + "/src/test/libs").getAbsolutePath(); 
  14.    String os = System.getProperty("os.name"); 
  15.    os = !TextUtils.isEmpty(os) ? os : ""; 
  16.    List<File> soFileList = new ArrayList<>(); 
  17.    String systemArchPath = libsBasePath + "/framework/"; 
  18.    //!!! 64 位机器下处理 
  19.    if (os.contains("Mac")) { 
  20.      //load system library if need 
  21.      String macSysSoBasePath = systemArchPath + "macOS/"; 
  22.      soFileList.addAll(addLibs(macSysSoBasePath)); 
  23.      // App so... 
  24.      String macAppSoPath = libsBasePath + "/macOS_x86-64/"; 
  25.      // mac下so要使用macOS专用库 
  26.      soFileList.addAll(addLibs(macAppSoPath)); 
  27.    } else if (os.contains("Linux")) { 
  28.      //load system library if need 
  29.      String linuxSysSoBasePath = systemArchPath + "arch_x86-64/"; 
  30.      soFileList.addAll(addLibs(linuxSysSoBasePath)); 
  31.      // App so... 
  32.      String linuxAppSoPath = libsBasePath + "/linux_x86-64/"; 
  33.      soFileList.addAll(addLibs(linuxAppSoPath)); 
  34.    } else if (os.contains("Windows")) { 
  35.      // ignore 
  36.    } 
  37.  
  38.    for (File soFie : soFileList) { 
  39.      System.load(soFie.getAbsolutePath()); 
  40.    } 
  41.  } 
  42.  
  43.  private List<File> addLibs(@NonNull String path) { 
  44.    File[] basePathFiles = new File(path).listFiles(); 
  45.    List<File> pathFilesList = new ArrayList<>(); 
  46.    if (basePathFiles != null && basePathFiles.length > 0) { 
  47.      pathFilesList.addAll(Arrays.asList(basePathFiles)); 
  48.    } 
  49.    return pathFilesList; 
  50.  } 
  51. }  

现在就可以加载了,运行如下 test case,结果如下图,成功了。


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

End

Linux 下使用最快速方便,只需要打包程序的 so 时顺便打包出 x86-64 的 so ,然后复制 ndk-bundle 的 so 加上需要的依赖即可。macOS 和 Windows 下就需要自己打包出各自平台下的动态库才可使用,如果代码里有 Android 自带 so 依赖的话那就需要自己去重新移植编译打包 ndk-bundle 里的动态库了。

作者:Rocko

来源:51CTO

时间: 2017-08-03

Android Robolectric加载运行本地So动态库的相关文章

loaded-在xcode6 上加载动态库

问题描述 在xcode6 上加载动态库 在xcode6 上加载自己创建的动态库时会出现 "dyld: Library not loaded: @rpath/.... Reason: image not found"这个问题除了把 Linked FrameWorks and Libraries的所在动态库选项改为 option 外有没有其他解决办法呢?

动态库是什么?怎么检查动态库是否正确?

问题描述 动态库是什么?怎么检查动态库是否正确? 什么是软件动态库?软件安装号之后如何检查动态库是否正确?手机软件安装之后会有动态库吗? 解决方案 动态链接库,也就是我们看到的DLL文件,如果少了DLL文件的话软件是运行不了的!,,手机这快我就不知道了 解决方案二: 動態連結函式庫(Dynamic-link library,缩写为DLL)是**微软公司在微软视窗操**作系统中实现共享函数库概念的一种实作方式.这些函式庫函数的扩展名是.DLL..OCX(包含ActiveX控制的函式庫)或者.DRV

设计简单的Android图片加载框架_Android

目前Android 发展至今优秀的图片加载框架太多,例如: Volley ,Picasso,Imageloader,Glide等等.但是作为程序猿,懂得其中的实现原理还是相当重要的,只有懂得才能更好地使用.于是乎,今天我就简单设计一个网络加载图片框架.主要就是熟悉图片的网络加载机制. 一般来说,一个优秀的 图片加载框架(ImageLoader) 应该具备如下功能: 图片压缩 内存缓存 磁盘缓存 图片的同步加载 图片的异步加载 网络拉取 那我们就从以上几个方面进行介绍: 1.图片压缩(有效的降低O

Android远程获取图片并本地缓存_Android

对于客户端--服务器端应用,从远程获取图片算是经常要用的一个功能,而图片资源往往会消耗比较大的流量,对应用来说,如果处理不好这个问题,那会让用户很崩溃,不知不觉手机流量就用完了,等用户发现是你的应用消耗掉了他手机流量的话,那么可想而知你的应用将面临什么样的命运. 另外一个问题就是加载速度,如果应用中图片加载速度很慢的话,那么用户同样会等到崩溃. 那么如何处理好图片资源的获取和管理呢? *异步下载 *本地缓存 1.异步下载: 大家都知道,在android应用中UI线程5秒没响应的话就会抛出无响应异

【短视频SDK】如何导入Android的AAR?动态库so文件到底怎么样放呢?

开发者在拿到短视频Android的SDK的时候会有些觉得不太一样,为什么SDK提供的是AAR文件和几个so文件呢?我们常见的SDK不是都是jar包吗?文本试图将AAR是什么,如何导入出现的问题进行一个归纳总结,希望开发者读完能够解决这种类型的问题. 1.什么是AAR文件?如何导入AAR文件? 1.1 什么是AAR文件? 开发者在开发的时候大家都遵循组件化的思路写代码,比如我们在写一个圆形的自定义组件的时候,这个组件是一个独立的组件,但是他可能不仅仅包含Java代码,还有很多资源甚至是底层so文件

android布局加载imagebutton问题详细求解

问题描述 android布局加载imagebutton问题详细求解 android布局中ImageButton怎么设置图片底色为透明,只保留图片上的画面. 解决方案 设置背景为透明色啊,background 解决方案二: background="#0000000" 解决方案三: android:background="#00000000" 一共8个"0" 解决方案四: android:id="@+id/button" andr

android异步获取图片并且本地存储的后续问题

问题描述 android异步获取图片并且本地存储的后续问题 我已经实现了头像图片的异步加载以及头像图片的下载及本地保存.实现方法及源代码请见我的博文:图片的异步加载及图片本地缓存 现在出现了一个后续的问题由于是头像,所以我使用了用户的ID作为头像的名称,例如现在我有3个好友分别是user1,user2,user3,以及我自己myUser.那么第一次读取过后我本地的头像就为user1.jpguser2.jpguser3.jpgmyUser.jpg.好了问题来了,当我的好友们的头像发生变化的时候,我

android关于加载 2049*1376 图片问题

问题描述 android关于加载 2049*1376 图片问题 <?xml version="1.0" encoding="utf-8"?> android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" android:background="@

android imageview加载网络图片无图片

问题描述 android imageview加载网络图片无图片 MainActivity.java package study_imageput.com.study_apktointent; import android.app.Activity; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.os.Bundle; import android.widget.ImageV