首先配置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关键字。
立即学习“C++免费学习笔记(深入)”;
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_包名_类名_方法名
示例代码:
Android中JNI编程的那些事儿 中文WORD版
本文档主要讲述的是Android中JNI编程的那些事儿;JNI译为Java本地接口。它允许Java代码和其他语言编写的代码进行交互。在android中提供JNI的方式,让Java程序可以调用C语言程序。android中很多Java类都具有native接口,这些接口由本地实现,然后注册到系统中。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
下载
#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支持多种数据类型转换:
- jstring ↔ const char*:使用GetStringUTFChars和ReleaseStringUTFChars
- jintArray ↔ int[]:使用GetIntArrayElements获取指针
- 对象传递:通过GetObjectClass、GetMethodID调用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++代码。










