首先配置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
}
<pre class="brush:php;toolbar:false;">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 <jni.h>
#include <string>
<p>extern "C" JNIEXPORT jstring JNICALL
Java_com_example_myapp_MainActivity_getStringFromCpp(
JNIEnv <em>env,
jobject /</em> this */) {
std::string hello = "Hello from C++";
return env->NewStringUTF(hello.c_str());
}</p><p>extern "C" JNIEXPORT jint JNICALL
Java_com_example_myapp_MainActivity_add(
JNIEnv <em>env,
jobject /</em> this */,
jint a,
jint b) {
return a + b;
}
</p>注意:
- extern "C"防止C++函数名被修饰,保证Java可调用
- JNIEnv*是JNI接口指针,用于调用JNI函数
- 参数jobject代表调用该方法的Java对象(非static方法)
4. 配置CMakeLists.txt
创建CMakeLists.txt文件来构建C++代码:
cmake_minimum_required(VERSION 3.18)
<p>project("native-lib")</p><p>add_library(
native-lib
SHARED
native-lib.cpp
)</p><p>find_library(
log-lib
log
)</p><p>target_link_libraries(
native-lib
${log-lib}
)
</p>然后在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);
<pre class="brush:php;toolbar:false;">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);
<pre class="brush:php;toolbar:false;">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++代码。











