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
GameActivityThisGameActivity 实例(静态/实例方法要区分)
字符串转换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 签名
voidV
intI
longJ
booleanZ
float / doubleF / D
StringLjava/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