Java Native Interface
自动关联目录:Java Native Interface
JNI 是 Android 上 C++ 与 Java 互调的桥梁。UE 里它的典型用途是:接第三方 SDK(支付、推送、登录)、调用平台能力(震动、电池、权限),以及让 Java 侧回调游戏逻辑。
两个方向
| 方向 | 做法 |
|---|---|
| C++ → Java | 拿到 JNIEnv,查类与方法 ID,调用 |
| Java → C++ | Java 声明 native 方法,C++ 侧实现并注册 |
C++ 调 Java
#if PLATFORM_ANDROID
#include "Android/AndroidApplication.h"
#include "Android/AndroidJNI.h"
JNIEnv* Env = FAndroidApplication::GetJavaEnv();
jclass Cls = FAndroidApplication::FindJavaClass("com/game/MyBridge");
jmethodID Method = FJavaWrapper::FindMethod(
Env, Cls, "showToast", "(Ljava/lang/String;)V", false);
FJavaWrapper::CallVoidMethod(Env, FJavaWrapper::GameActivityThis, Method,
*FJavaClassObject::GetJString(Env, Text));
#endif| 要点 | 说明 |
|---|---|
FAndroidApplication::GetJavaEnv() | 取当前线程 JNIEnv |
| 方法签名 | 如 (Ljava/lang/String;)V,写错会 NoSuchMethodError |
GameActivityThis | GameActivity 实例(静态/实例方法要区分) |
| 字符串转换 | FJavaClassObject::GetJString / FJavaHelper::FStringFromJavaString |
Java 调 C++
public class MyBridge {
public static native void onPayResult(int code);
}extern "C" JNIEXPORT void JNICALL
Java_com_game_MyBridge_onPayResult(JNIEnv* Env, jclass Cls, jint Code)
{
// 注意:这里不在游戏线程
AsyncTask(ENamedThreads::GameThread, [Code]() { /* 回到游戏线程 */ });
}回调不在游戏线程——这是最容易踩的坑。所有引擎 API 调用必须切回游戏线程(AsyncTask(ENamedThreads::GameThread, ...))。
常见签名
| Java 类型 | JNI 签名 |
|---|---|
void | V |
int | I |
long | J |
boolean | Z |
float / double | F / D |
String | Ljava/lang/String; |
int[] | [I |
| 任意类 | L包名/类名; |
生命周期注意
| 问题 | 说明 |
|---|---|
| 局部引用泄漏 | 循环里创建的 jobject 要 DeleteLocalRef |
| 全局引用 | 需要长期持有用 NewGlobalRef / DeleteGlobalRef |
| 线程附着 | 非 Java 线程要 AttachCurrentThread / DetachCurrentThread |
| 异常 | JNI 调用后检查 ExceptionCheck,否则后续行为未定义 |
工程实践
| 建议 | 说明 |
|---|---|
| 用 UPL 注入 Java 代码 | 不要手改生成的 Gradle 工程 |
| 把 JNI 调用收拢到少数几个文件 | 加 PLATFORM_ANDROID 保护,其他平台编不过 |
| 用插件封装第三方 SDK | 便于复用与升级 |
| 所有回调切回游戏线程 | 否则崩溃或状态错乱 |
常见坑
| 坑 | 说明 |
|---|---|
| 方法签名写错 | 运行时 NoSuchMethodError,编译期不报 |
| 在 JNI 回调里直接调引擎 API | 线程不对,应切回游戏线程 |
| 忘记释放局部引用 | 引用表溢出(512 上限) |
| Java 类被混淆 | 混淆后找不到类/方法,要 keep |
直接在 GameActivity.java 里改 | 升级引擎会冲突,应用 UPL |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/87a1b898.html
更新于:2026年11月16日