Native bridge Android: JNI, Java ↔ C++/TypeScript và luồng xử lý
JNI từ gốc: JNIEnv, chữ ký phương thức, tham chiếu local/global. Gọi Java từ C++ (Cocos2d-x) và từ TypeScript (Creator 3.x reflection), gọi ngược Java → game, ba luồng (UI, game/GL, nền) và cách chuyển qua lại, giữ class khỏi R8/ProGuard, gỡ lỗi JNI thường gặp.
- “Build and maintain native bridges (JNI for Android ...)”
- “Experience building native bridges (JNI for Android, Objective-C/C++ for iOS)”
Mọi SDK (quảng cáo, thanh toán, đăng nhập, rung, chia sẻ) đều đi qua cầu nối native. Lỗi ở đây là crash native khó đọc hoặc lỗi “thỉnh thoảng không nhận thưởng”. Người phỏng vấn hỏi để biết bạn từng tự viết cầu nối hai chiều và xử lý luồng, hay chỉ dùng plugin có sẵn.
🎯 Mục tiêu học tập
- Đọc/viết chữ ký JNI, quản lý tham chiếu local/global
- Gọi Java từ C++ (2d-x) và từ TS (Creator)
- Gọi ngược từ Java về game an toàn
- Chuyển luồng đúng: UI ↔ game ↔ nền
- Cấu hình R8/ProGuard và gỡ lỗi JNI
🟢 JNI trong 10 phút
| Kiểu Java | Chữ ký | Ví dụ chữ ký phương thức |
|---|---|---|
| void | V | void showBanner() → ()V |
| boolean | Z | boolean isReady(String id) → (Ljava/lang/String;)Z |
| int / long | I / J | void vibrate(int ms) → (I)V |
| float / double | F / D | float getScale() → ()F |
| String | Ljava/lang/String; | String getDeviceId() → ()Ljava/lang/String; |
| int[] | [I | void setLevels(int[] a) → ([I)V |
JNIEnv*gắn với từng luồng; không lưu JNIEnv để dùng ở luồng khác.- Đối tượng Java trả về/ tạo trong native là local reference, tự giải phóng khi hàm native trả về Java. Nhưng trong vòng lặp dài ở native, phải
DeleteLocalRef, nếu không sẽ tràn bảng tham chiếu (local reference table overflow). - Muốn giữ đối tượng Java qua nhiều lần gọi:
NewGlobalRef, và nhớDeleteGlobalRef.
🟡 Cocos2d-x: C++ gọi Java và Java gọi C++
// C++ → Java (static method)
#include "platform/android/jni/JniHelper.h"
using cocos2d::JniHelper;
void NativeBridge::showRewarded(const std::string& placement) {
// Cách gọn (Cocos2d-x 3.17+): template tự suy ra chữ ký
JniHelper::callStaticVoidMethod("org/cocos2dx/cpp/AdBridge", "showRewarded", placement);
}
bool NativeBridge::isRewardedReady(const std::string& placement) {
// Cách thủ công: hiểu rõ để gỡ lỗi
cocos2d::JniMethodInfo t;
bool ok = false;
if (JniHelper::getStaticMethodInfo(t, "org/cocos2dx/cpp/AdBridge", "isRewardedReady", "(Ljava/lang/String;)Z")) {
jstring jp = t.env->NewStringUTF(placement.c_str());
ok = t.env->CallStaticBooleanMethod(t.classID, t.methodID, jp);
t.env->DeleteLocalRef(jp);
t.env->DeleteLocalRef(t.classID);
}
return ok;
}// Java → C++: khai báo native method, gọi từ Java khi SDK báo thưởng
package org.cocos2dx.cpp;
public class AdBridge {
public static native void nativeOnRewarded(String placement, int amount); // cài đặt ở C++
// SDK callback thường chạy trên UI thread → chuyển sang GL/game thread trước khi gọi native
static void onSdkRewarded(final String placement, final int amount) {
AppActivity.getInstance().runOnGLThread(() -> nativeOnRewarded(placement, amount));
}
}// C++: tên hàm phải khớp package + class + method (dấu chấm → gạch dưới)
extern "C" JNIEXPORT void JNICALL
Java_org_cocos2dx_cpp_AdBridge_nativeOnRewarded(JNIEnv* env, jclass, jstring jPlacement, jint amount) {
std::string placement = cocos2d::JniHelper::jstring2string(jPlacement);
// Đã ở GL thread nhờ runOnGLThread; nếu không chắc, chuyển tiếp lần nữa cho an toàn:
cocos2d::Director::getInstance()->getScheduler()->performFunctionInCocosThread([placement, amount] {
RewardService::instance().grant(placement, amount);
});
}Hàm này là ví dụ: bạn tự lưu tham chiếu Activity (static) trong onCreate, hoặc truyền Activity khi khởi tạo bridge. Cẩn thận rò rỉ Activity khi lưu static: xoá ở onDestroy.
🟡 Cocos Creator 3.x: TypeScript ↔ Java
// TypeScript → Java bằng reflection (static method, trả về giá trị nguyên thuỷ/ chuỗi)
import { native, sys } from 'cc';
export function vibrate(ms: number) {
if (sys.os === sys.OS.ANDROID && sys.isNative) {
native.reflection.callStaticMethod('com/cocos/game/DeviceBridge', 'vibrate', '(I)V', ms);
}
}
export function deviceRamMb(): number {
if (!(sys.isNative && sys.os === sys.OS.ANDROID)) return 4096;
return native.reflection.callStaticMethod('com/cocos/game/DeviceBridge', 'totalRamMb', '()I') as number;
}// Kênh hai chiều gọn hơn: JsbBridge (truyền 2 chuỗi; đóng gói JSON nếu cần nhiều tham số)
// TypeScript
import { native } from 'cc';
native.bridge.onNative = (event: string, payload?: string) => {
if (event === 'ad_rewarded') RewardService.grant(JSON.parse(payload!));
};
native.bridge.sendToNative('show_rewarded', JSON.stringify({ placement: 'double_coins' }));// Java (thư mục native/engine/android/app/src/... của project Creator — nhớ commit)
import com.cocos.lib.JsbBridge;
import com.cocos.lib.CocosHelper;
public class BridgeSetup {
public static void init() {
JsbBridge.setCallback(new JsbBridge.ICallback() {
@Override public void onScript(String event, String payload) { // từ TS gửi xuống
if ("show_rewarded".equals(event)) AdManager.showRewarded(payload);
}
});
}
// Gọi từ callback SDK (UI thread): chuyển về game thread rồi gửi lên script
public static void notifyRewarded(final String json) {
CocosHelper.runOnGameThread(() -> JsbBridge.sendToScript("ad_rewarded", json));
}
}Tên namespace đã đổi giữa các bản (2.x/ đầu 3.x dùng jsb.reflection, các bản 3.x sau dùng native.reflection; package Java org.cocos2dx.lib → com.cocos.lib). Khi phỏng vấn, nói rõ bạn dùng phiên bản nào và sẽ tra tài liệu tương ứng: đó là dấu hiệu của người làm thật.
🔴 Ba luồng và quy tắc chuyển
| Luồng | Ai chạy ở đây | Quy tắc |
|---|---|---|
| UI thread (main) Android | Activity, View, phần lớn callback SDK | Hiện UI SDK (quảng cáo, hộp thoại) ở đây: runOnUiThread |
| Game/ GL thread | Vòng lặp Cocos, script, node | Mọi thao tác node/ script ở đây: runOnGLThread (2d-x), CocosHelper.runOnGameThread (Creator) |
| Luồng nền | Mạng, IO, xử lý nặng | Không chạm UI hay node; trả kết quả qua hai luồng trên |
Triệu chứng sai luồng: crash “CalledFromWrongThreadException” (đụng View từ game thread), crash ngẫu nhiên trong engine (đụng node từ UI thread), hoặc callback “mất” vì script chưa sẵn sàng.
🟡 R8/ProGuard và gỡ lỗi
# proguard-rules.pro: giữ class/ method được gọi bằng tên qua JNI/ reflection
-keep class com.cocos.game.DeviceBridge { public static *; }
-keep class com.cocos.game.BridgeSetup { *; }
-keepclasseswithmembernames class * { native <methods>; } # giữ tên native method| Lỗi | Nguyên nhân thường gặp |
|---|---|
| NoSuchMethodError/ ClassNotFound khi release | R8 đổi tên/ xoá class; chữ ký sai; sai đường dẫn package |
| UnsatisfiedLinkError | Tên hàm C++ không khớp package/class; thư viện .so chưa nạp; thiếu ABI |
| local reference table overflow | Tạo jstring/ jobject trong vòng lặp không DeleteLocalRef |
| Crash ngẫu nhiên sau callback | Đụng node từ UI thread |
| Chạy debug được, release lỗi | R8, khác ABI, khác cấu hình build |
Công cụ: adb logcat lọc theo tag, bật CheckJNI trên bản debug (adb shell setprop debug.checkjni 1 với máy phù hợp/ emulator) để bắt lỗi JNI sớm, ndk-stack để đọc stack native.
🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)
🎤 Mô tả cách bạn gọi một hàm Java từ game và nhận kết quả bất đồng bộ trở lại.
🎤 Local reference và global reference khác nhau thế nào?
🎤 Bản debug chạy, bản release gọi native bị NoSuchMethodError. Vì sao?
🎤 Tại sao không được cập nhật node trực tiếp trong callback SDK Android?
🎤 JsbBridge khác reflection thế nào, bạn chọn cái nào?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Crash ngẫu nhiên.
Cách làm đúng: Luôn chuyển luồng rõ ràng.
Vì sao nguy hiểm: Tràn bảng tham chiếu.
Cách làm đúng: Xoá sau mỗi lần dùng.
Vì sao nguy hiểm: Release crash, debug chạy.
Cách làm đúng: Keep class/method gọi qua JNI/ reflection.
Vì sao nguy hiểm: Rò rỉ Activity.
Cách làm đúng: Xoá tham chiếu ở onDestroy, dùng WeakReference khi phù hợp.
Vì sao nguy hiểm: Khó bảo trì.
Cách làm đúng: Một lớp bridge tập trung, giao thức JSON có version.
Vì sao nguy hiểm: Game treo chờ phần thưởng.
Cách làm đúng: Timeout + trạng thái hiển thị.
- Chữ ký JNI: (tham số)kiểu trả về; String = Ljava/lang/String;
- Local ref tự giải phóng khi về Java; global ref phải xoá.
- 2d-x: JniHelper; Creator: native.reflection hoặc JsbBridge.
- UI thread cho SDK/ View; game thread cho node/ script; chuyển luồng bắt buộc.
- Keep rule R8 cho mọi thứ gọi bằng tên.
🧩 Tự kiểm tra (bấm để xem đáp án)
1. Chữ ký của static boolean isReady(String id):
A. (Ljava/lang/String;)Z
B. (String)boolean
C. (Z)Ljava/lang/String;
2. Callback SDK chạy trên UI thread muốn cập nhật node, cần:
A. Gọi trực tiếp
B. Chuyển về game/GL thread
C. Dùng setTimeout
3. UnsatisfiedLinkError thường do:
A. Tên hàm C++ không khớp package/class hoặc thư viện chưa nạp
B. Thiếu ảnh
C. Sai font
4. Giữ một jobject qua nhiều lần gọi native:
A. Lưu local ref
B. NewGlobalRef + DeleteGlobalRef khi xong
C. Không thể
5. Bản release lỗi NoSuchMethodError, bản debug không:
A. R8/ProGuard
B. Màn hình
C. Wi-Fi
🏋️ Bài tập thực hành
Viết bridge (Creator 3.x hoặc 2d-x) gồm: rung (TS→Java), lấy RAM/ model (TS→Java có trả về), mở hộp thoại native xác nhận thoát và trả kết quả về game (bất đồng bộ, đúng luồng), lắng nghe sự kiện pin yếu đẩy lên game. Build release có R8 bật và chứng minh mọi chức năng chạy.
💡 Gợi ý lời giải
📚 Tài nguyên học tập
- Android: JNI tipsJNIEnv, tham chiếu, luồng, lỗi thường gặpHướng dẫn
- Cocos Creator 3.8 Manual: Java ↔ JS communicationMục Advanced Topics → reflection, JsbBridgeTài liệu
- Android: Shrink, obfuscate (R8)Keep rule, mappingHướng dẫn
✅ Tự đánh giá hoàn thành
- Viết 6 chữ ký JNI
- Gọi Java từ C++ hoặc TS
- Gọi ngược về game đúng luồng
- Viết keep rule
- Làm bài tập DeviceBridge