详解Android JNI的基本使用（CMake）

发布日期： 2026-01-12 阅读量： 作者： 用户投稿

简介

什么是JNI

JNI的全称是Java Native Interface：Java本地开发接口，它提供了若干的API实现了Java和其他语言的通信(主要是C和C++)，目的就是Java可以调用C或C++开发的函数，C或C++也能调用Java的方法。这样有很多有点，其一就是效率，C/C++是本地语言，比java更高效；其二就是可以复用已经存在的C/C++代码；其三是Java反编译比C语言容易，一般加密算法都是用C语言编写，不容易被反编译。

什么是NDK和CMake

NDK全称是Native Development Kit，NDK提供了一系列的工具，帮助开发者快速开发C(或C++)的动态库，并能自动将so和Java应用一起打包成apk。NDK集成了交叉编译器，并提供了相应的mk文件隔离CPU、平台、ABI等差异，开发人员只需要简单修改mk文件(指出“哪些文件需要编译”、“编译特性要求”等)，就可以创建出so。

CMake是一个比make更高级的编译配置工具，它可以根据不同平台、不同的编译器，生成相应的Makefile或者vcproj项目。
通过编写CMakeLists.txt，可以控制生成的Makefile，从而控制编译过程。CMake自动生成的Makefile不仅可以通过make命令构建项目生成目标文件，还支持安装（make install）、测试安装的程序是否能正确执行（make test，或者ctest）、生成当前平台的安装包（make package）、生成源码包（make package_source）、产生Dashboard显示数据并上传等高级功能，只要在CMakeLists.txt中简单配置，就可以完成很多复杂的功能，包括写测试用例。如果有嵌套目录，子目录下可以有自己的CMakeLists.txt。

使用流程

1、在java文件中创建本地方法
2、build项目后自动生成“.h”文件
3、创建.cpp文件，实现.h文件中的方法
4、配置Cmake文件，生成“.so”文件

笔者项目目录如下：

测试实例

public class MyJNI {
  private static final String TAG=MyJNI.class.getName();
  @Test
  public void test(){
    JNITest jniTest=new JNITest();
    Log.d(TAG,jniTest.nativeCalculate(2)+"");
  }
}

1、调用native方法nativeCalculate，传入参数2。
1、获取java对象number，初始值为0。
2、调用java方法javajavaCalculate，传入number值，获得返回值10。
3、将返回值加上参数2，返回，获得12。

最终效果如下：

创建本地方法

public class JNITest {

  private int number = 0;

  public int javaCalculate(int num){
    number=num+10;
    return number;
  }
  public native int nativeCalculate(int num);

  static {
    System.loadLibrary("jni_test");
  }
}

自动生成“.h文件”

首先make Project，然后进入到app\build\intermediates\classes\debug目录下。

在终端输入命令javah com.example.xujiajia_sx.jnitest.JNITest（即带有native方法的类）

效果如下：

自动生成的“.h”文件如下，可以根据自己要求对其重命名或者增减内容。

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_example_xujiajia_sx_jnitest_JNITest */

#ifndef _Included_com_example_xujiajia_sx_jnitest_JNITest
#define _Included_com_example_xujiajia_sx_jnitest_JNITest
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:   com_example_xujiajia_sx_jnitest_JNITest
 * Method:  nativeCalculate
 * Signature: (I)I
 */
JNIEXPORT jint JNICALL Java_com_example_xujiajia_1sx_jnitest_JNITest_nativeCalculate
 (JNIEnv *, jobject, jint);

#ifdef __cplusplus
}
#endif
#endif

创建cpp文件实现native方法

笔者cpp文件如下：

#include "jni_test.h"

JNIEXPORT jint JNICALL
Java_com_example_xujiajia_1sx_jnitest_JNITest_nativeCalculate(JNIEnv *env, jobject obj,jint num) {
  //获取obj中对象的class对象
  jclass clazz = env->GetObjectClass(obj);
  //获取clazz中的number字段的id
  jfieldID id_number = env->GetFieldID(clazz, "number", "I");
  jmethodID id_java_calculate=env->GetMethodID(clazz, "javaCalculate", "(I)I");
  //次获取java中number的值
  jint number = env->GetIntField(obj, id_number);
  jint result=env->CallIntMethod(obj,id_java_calculate,number);

  env->SetIntField(obj,id_number,result+num);
  //再次获取java中number的值并返回
  return env->GetIntField(obj, id_number);
}

主要逻辑是获取到java中number的值，然后调用javaCalculate()方法，接着再加上这个native方法的参数num。

设置Cmake文件，生成”.so”文件

首先，在build.gradle中添加Cmake配置：

android {
  ...
  defaultConfig {
    ...
    externalNativeBuild {
      cmake {
        cppFlags ""
        //生成多个版本的so文件
        abiFilters 'armeabi','armeabi-v7a','x86'
      }
    }
  }
  buildTypes {
    ...
  }
  externalNativeBuild {
    cmake {
      path "CMakeLists.txt"
    }
  }
}

编写Cmake文件：

#CMakeLists.txt
cmake_minimum_required(VERSION 3.4.1)

add_library( # Sets the name of the library.
    jni_test

    # Sets the library as a shared library.
    SHARED

    # Provides a relative path to your source file(s).
    src/main/jni/jni_test.cpp)

include_directories(src/main/jni/)

find_library( # Sets the name of the path variable.
    log-lib

    # Specifies the name of the NDK library that
    # you want CMake to locate.
    log )

target_link_libraries( # Specifies the target library.
      # 制定目标库.
      jni_test

      # Links the target library to the log library
      # included in the NDK.
      ${log-lib} )

配置完cmake，rebuild项目，即可以运行test。“.so”文件生成如下：

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

上一篇: Android图片处理工具类BitmapUtils

详解Android JNI的基本使用（CMake）

随便看看

南昌壹佳企网络通信有限公司