Android JNI 技术的应用
Android JNI技术的应用
JNI: JNI is the Java Native Interface. It defines a way for managed code (written in the Java programming language) to interact with native code (written in C/C++).
- 目前官方提供了两种应用方案
- NDK
- CMake
NDK
原生开发工具包 (NDK) 是一组可让您在 Android 应用中利用 C 和 C++ 代码的工具。 可用以从您自己的源代码构建，或者利用现有的预构建库。
目前的绝大多数需要用到JNI技术的第三方都是使用的NDK
NDK的配置文件
-
Android.mk
Android.mk文件位于项目 jni/ 目录的子目录中，用于向构建系统描述源文件和共享库。是构建so的必要配置文件 -
此文件用于描述应用需要的原生模块。 模块可以是静态库、共享库或可执行文件。
应用流程
-
创建JNI文件夹，可以创建系统推荐的JNI文件夹，操作如图
[图片上传失败...(image-44a3b0-1513673939929)]
也可以自己指定位置创建文件夹，之后可以在Gradle文件中把JNI路径指向该文件夹
android {
sourceSets.main {
jni.srcDir "jniPath"
}
}
-
创建及编写C++文件及与之关联的Java文件
C++ 里面jni方法名是由关联的Java文件的包名和类名+方法名组成的
example 1
package com.mark.test
public class TestJni {
public native String getString();
}
上面代码中的getString方法在C++中的关联方法名为
//Java_包名_类名_方法名
Java_com_mark_test_TestJni_getString
那么example 1中的getString()方法对应的C++文件如下
#include <jni.h>
extern "C"
JNIEXPORT jstring JNICALL
Java_com_mark_test_TestJni_getString(JNIEnv *env){
char *str = "hello world";
return env->NewStringUTF(str);
}
c++ 代码说明
- jstring： jni.h中定义的类型，对应java中的String
- JNIEXPORT： 在windows中对应__declspec(dllexport)标识，表示将该函数导出在外部可以调用
- JNICALL：在windows中的值为__stdcall，用于约束函数入栈顺序和堆栈清理的规则。
- JNIEnv:用于本地线程存储,提供了大量的JNI方法，并且是所有原生方法的第一个参数
-
配置编译文件
-
在JNI文件夹根目录下创建 Android.mk文件
以下是最基本的配置
# 指定当前文件的路径，必须在文件的开头定义 LOCAL_PATH := $(call my-dir) # 清除几乎全部 LOCAL_XXX 变量 include $(CLEAR_VARS) # 构建的模块名 LOCAL_MODULE := hello-test # 设置源文件 LOCAL_SRC_FILES := test.cpp # 帮助系统将所有内容连接到一起 include $(BUILD_SHARED_LIBRARY) -
在JNI文件夹根目录下创建 Application.mk文件
Application.mk文件是非必须文件，创建后，Gradle构建时会自动搜索并加载
我这里只定义了so文件构建的cpu架构类型，其他的可以看官方文档
APP_ABI := armeabi-v7a arm64-v8a -
配置Gradle文件
android { externalNativeBuild { ndkBuild { //设置Android.mk位置 path "jni/Android.mk" } } }
-
OK,包含JNI的项目完成
CMake
CMake是一个开源的、夸平台的用于构建、测试、打包软件的工具组
-
创建JNI文件夹及C++文件编写与NDK一样
-
配置编译文件
-
CMake.txt
在jni目录下或是项目根目录下创建名字为“CMakeLists.txt”的文件
在文件里写入
cmake_minimum_required()andadd_library()如下
# 设置最小编译版本 cmake_minimum_required(VERSION 3.4.1) add_library( # 库 名称 test-cmake # 库类型 SHARED # 源码地址 src/main/jni/test.cpp )
-
-
关联Gradle
externalNativeBuild {
cmake {
path "CMakeLists.txt"
}
}
OK,包含JNI的项目完成
项目GitBub地址
PS:文章只是JNI构建的最基础配置，更多的配置都在参考资料里给出文档地址，自己添加即可
如有问题 欢迎指正
