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的必要配置文件

  • Application.mk

    此文件用于描述应用需要的原生模块。 模块可以是静态库、共享库或可执行文件。

应用流程

  • 创建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文件

      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官方说明文档

      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() and add_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构建的最基础配置,更多的配置都在参考资料里给出文档地址,自己添加即可

如有问题 欢迎指正

参考资料

    原文作者:Mark_Liu
    原文地址: https://www.jianshu.com/p/40e9d79c0e52
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞