C++如何进行JNI编程_在Android项目中调用C++原生代码的方法

首先配置NDK环境并在build.gradle中启用ABI过滤;接着在Java类中声明native方法并静态加载so库;然后在cpp目录下创建C++文件,使用extern "C"和JNI函数命名规范实现对应逻辑;之后编写CMakeLists.txt配置编译脚本并关联到gradle;最后在onCreate等方法中直接调用native函数完成字符串返回、整数相加或数组求和等操作,实现Java与C++的数据交互与处理。

在Android开发中,JNI(Java Native Interface)是让Java代码与C/C++原生代码交互的关键机制。使用JNI可以提升性能敏感部分的执行效率,复用已有C++库,或实现底层系统操作。以下是C++进行JNI编程并在Android项目中调用原生代码的完整方法。

1. 配置NDK环境

确保你的Android项目支持原生开发:

  • 安装Android NDK(Native Development Kit),可通过Android Studio的SDK Manager安装
  • app/build.gradle中启用NDK支持

示例配置:

android {
    ...
    defaultConfig {
        ...
        ndk {
            abiFilters "armeabi-v7a", "arm64-v8a", "x86", "x86_64"
        }
    }
    buildFeatures {
        prefab false
    }
}

2. 声明Java层的native方法

在Java或Kotlin类中声明要调用的原生方法,使用native关键字。

例如,在MainActivity.java中:

public class MainActivity extends AppCompatActivity {
    static {
        System.loadLibrary("native-lib"); // 加载so库,对应libnative-lib.so
    }
public native String getStringFromCpp();
public native int add(int a, int b);

}

静态代码块加载名为native-lib的共享库,编译后生成libnative-lib.so

3. 创建C++源文件

src/main/cpp/目录下创建C++文件,如native-lib.cpp

实现对应的JNI函数,函数名需遵循命名规范:
Java_包名_类名_方法名

示例代码:

#include 
#include 

extern "C" JNIEXPORT jstring JNICALL Java_com_example_myapp_MainActivity_getStringFromCpp( JNIEnv env, jobject / this */) { std::string hello = "Hello from C++"; return env->NewStringUTF(hello.c_str()); }

extern "C" JNIEXPORT jint JNICALL Java_com_example_myapp_MainActivity_add( JNIEnv env, jobject / this */, jint a, jint b) { return a + b; }

注意:

  • extern "C"防止C++函数名被修饰,保证Java可调用
  • JNIEnv*是JNI接口指针,用于调用JNI函数
  • 参数jobject代表调用该方法的Java对象(非static方法)

4. 配置CMakeLists.txt

创建CMakeLists.txt文件来构建C++代码:

cmake_minimum_required(VERSION 3.18)

project("native-lib")

add_library( native-lib SHARED native-lib.cpp )

find_library( log-lib log )

target_link_libraries( native-lib ${log-lib} )

然后在build.gradle中关联CMake脚本:

android {
    ...
    externalNativeBuild {
        cmake {
            path file('src/main/cpp/CMakeLists.txt')
            version '3.18.1'
        }
    }
}

5. 调用native方法

在Java代码中直接调用声明的native方法,就像普通方法一样:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
TextView tv = findViewById(R.id.sample_text);
tv.setText(getStringFromCpp()); // 显示 "Hello from C++"

int result = add(5, 3); // result = 8

}

6. 处理复杂数据类型(进阶)

JNI支持多种数据类型转换:

  • jstringconst char*:使用GetStringUTFCharsReleaseStringUTFChars
  • jintArrayint[]:使用GetIntArrayElements获取指针
  • 对象传递:通过GetObjectClassGetMethodID调用Java方法

例如读取int数组:

extern "C" JNIEXPORT jint JNICALL
Java_com_example_myapp_MainActivity_sumArray(
        JNIEnv *env,
        jobject /* this */,
        jintArray arr) {
    jint *elems = env->GetIntArrayElements(arr, nullptr);
    jsize size = env->GetArrayLength(arr);
jint sum = 0;
for (int i = 0; i < size; ++i) {
    sum += elems[i];
}

env->ReleaseIntArrayElements(arr, elems, 0); // 释放资源
return sum;

}

基本上就这些。掌握JNI编程需要理解Java与C++之间的类型映射、内存管理以及函数注册机制。只要按照规范定义函数名、正确处理数据转换,就能顺利在Android中集成C++代码。