一个人用 Cocos Creator 做空项目练手想接安卓 SDK 练练手结果卡在第一步TS 和 Java 怎么通信这篇文章记录我从零跑通Cocos Creator → Android 原生层双向通信的完整过程包括踩的坑。接 AdMob、Firebase、支付、推送原理都一样先把这个闭环打通后面都是换汤不换药。一、先理清概念这里的 Java 不是后端很多人第一反应“接 SDK 还要写 Java 后端”不是后端。Android 原生层 Java/Kotlin跑在手机 App 里用来调第三方 SDK。Cocos 构建 Android 时会自动生成这个工程。Java 后端跑在服务器上处理 HTTP 请求、数据库。跟接 SDK 没关系。我们要写的是第一种。二、环境准备1. 依赖版本Cocos Creator 3.xJDK 11 或 17根据 Creator 版本要求Android StudioAndroid SDK NDKNDK 推荐 r18~r212. Creator 中配置路径文件 → 偏好设置 → 程序管理器设置 Android SDK 和 NDK 路径。3. 构建 Android 工程在 Creator 构建发布面板选 Android点击构建。成功后生成build/android/proj这个目录就是完整的 Android Studio 工程。三、用 Android Studio 打开原生工程打开 Android Studio →Open→ 选择build/android/proj。如果左侧看不到AppActivity.java点击Build → Select Build Variant...切换为Android视图。文件路径一般在native/engine/android/app/src/com/cocos/game/AppActivity.java四、JsbBridgeCocos 与安卓通信的桥Cocos 官方推荐用JsbBridge比传统的jsb.reflection反射方式更简单、更安全。核心就四个 API方向调用方APITS → JavaTSnative.bridge.sendToNative(event, arg)TS → JavaJavaJsbBridge.setCallback(...)的onScriptJava → TSJavaJsbBridge.sendToScript(event, arg)Java → TSTSnative.bridge.onNative (...) {}注意参数只能是字符串。复杂对象用JSON.stringify/JSON.parse。五、完整代码实战1. TS 端发消息给 Javaimport { native } from cc; // 点击按钮时调用 onClickTest() { console.log(asd); native.bridge.sendToNative(test_native, hello from ts); }2. Java 端监听 TS 消息并回传在AppActivity.java的onCreate中Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); SDKWrapper.shared().init(this); JsbBridge.setCallback(new JsbBridge.ICallback() { Override public void onScript(String event, String arg) { android.util.Log.d(MySDKTest, onScript: event / arg); if (test_native.equals(event)) { // ⚠️ UI 操作必须回主线程 runOnUiThread(new Runnable() { Override public void run() { android.widget.Toast.makeText( AppActivity.this, 收到TS消息: arg, android.widget.Toast.LENGTH_SHORT ).show(); } }); // 回调给 TS JsbBridge.sendToScript(test_script, hello from java); } } }); }3. TS 端监听 Java 回调import { native } from cc; start() { native.bridge.onNative (event: string, arg: string | null) { console.log(收到原生消息:, event, arg); if (event test_script) { // 隐藏按钮 this.someButton.active false; } }; }六、踩坑记录点击按钮“没反应”现象TS 端console.log(asd)正常打印Java 端onScript也进来了但手机没弹 ToastTS 也没收到回调日志System.err W at com.cocos.game.AppActivity$a.onScript(SourceFile:36) System.err W at com.cocos.lib.JsbBridge.callByScript(SourceFile:5)原因JsbBridge.onScript的回调运行在Cocos 的 GL 线程不是 Android 主线程。而Toast.show()必须在有Looper的线程上执行GL 线程没有所以抛异常java.lang.RuntimeException: Cant toast on a thread that has not called Looper.prepare()异常一抛后面的sendToScript压根没执行到所以 TS 端一直收不到回调表现就是“没反应”。解决所有 UI 操作Toast、Dialog、跳转 Activity、改 View都包一层runOnUiThreadrunOnUiThread(new Runnable() { Override public void run() { Toast.makeText(AppActivity.this, xxx, Toast.LENGTH_SHORT).show(); } });sendToScript不涉及 UI任意线程都能调。如何看 Java 异常堆栈Java 堆栈的格式是at 类名.方法名(文件名:行号)看到AppActivity$a.onScript(SourceFile:36)就说明AppActivity的匿名内部类的onScript方法第 36 行出问题。想看完整堆栈adb logcat -d | grep -A 30 -B 5 AppActivity七、重要防止代码被覆盖直接改build/android/proj/.../AppActivity.java下次在 Creator 里重新构建 Android 时会被覆盖。解决方案把改好的文件放到build-templates目录build-templates/android/app/src/com/cocos/game/AppActivity.java具体路径以你工程里AppActivity.java的实际路径为准。这样每次构建都会用你的版本。八、调试技巧1. 真机日志adb devices adb logcat | grep -iE MySDKTest|cocos|jsb2. Java 端打日志android.util.Log.d(MySDKTest, xxx);3. TS 端打日志console.log(xxx);4. 改 Java 后的流程只改了 JavaAndroid Studio 直接点绿色 Run不用回 Creator 构建。改了 TS/场景/资源先回 Creator 构建再用 Android Studio Run。九、这套模式可以直接套用到所有 SDK打通之后接任何安卓 SDK 都是同一个套路示例接登录 SDKTS 按钮请求登录 ↓ sendToNative(login, {}) JavaonScript 收到 login ↓ 调用微信/Google/Firebase SDK SDK 回调登录成功拿到 token ↓ sendToScript(login_result, {token: xxx}) TSonNative 收到 login_result ↓ 保存 token进入游戏示例接激励广告TSsendToNative(show_reward_ad, {}) Java加载并展示激励视频 SDK 回调用户看完 JavasendToScript(ad_reward, {reward: 100}) TS发奖励十、总结三个核心点TS → JavasendToNative(event, arg)Java 用setCallback的onScript接。Java → TSsendToScript(event, arg)TS 用onNative接。参数只能是字符串对象用JSON.stringify/JSON.parse。UI 操作必须回主线程。只要把这条链路跑通接 AdMob、Firebase、Google Play Billing、FCM 推送都只是换中间那段 Java 逻辑。一个人练手完全够空项目 JsbBridge 一个按钮就能把安卓 SDK 接入的完整流程摸透。