CocosCreator Native 快速开始

下载 SDK 包

js 插件说明

SDK 整体目录结构如下:

appsdk_dl.js

appsdk_dl.d.ts

使用说明：

1. 将lib-sdk目录下的appsdk_dl.js导入工程，并且勾选为插件，提示文件也在lib-sdk下的appsdk.d.ts。
2. 在进入游戏后调用GameHelper.init()，使用任何GameHelper方法前都必须保证调用完GameHelper.init()，并且是在GameHelper.init()的 callback 回调完后。
3. 目前GameHelper包含：公共功能模块、广告模块、统计模块、内购模块、登陆模块。使用任何功能优先在AppModule、AdsModule、GameStatistics、PayModule、LoginModule这些模块查找，如果没有最后再去AppApi查找。
4. 研发对接完后构建相应的平台资源，然后将资源导入相应的 Android、iOS 工程即可

WARNING

💡 如果是 CocosCreator 3.7.2 和 3.7.3、3.8.3 版本，请修改 JniCocosEntry.cpp 和 GameActivity.cpp 后再导出游戏资源，修改前最好备份一份源文件

具体路径
C:\ProgramData\cocos\editors\Creator\3.7.2\resources\resources\3d\engine\native\cocos\platform\android\jni\JniCocosEntry.cpp
JniCocosEntry.cpp 修改内容

line.41

JNIEXPORT void JNICALL Java_com_cocos_lib_CocosActivity_onCreateNative(JNIEnv *env, jobject obj, jobject activity) {
    cc::JniHelper::init(env, activity);
}

C:\ProgramData\cocos\editors\Creator\3.7.2\resources\resources\3d\engine\native\external\sources\android-gamesdk\GameActivity\game-activity\include\game-activity\GameActivity.cpp
GameActivity.cpp 修改内容

line.1394

extern "C" JNIEXPORT jlong JNICALL Java_com_google_androidgamesdk_GameActivity_loadNativeCode(
    JNIEnv *env, jobject obj, jobject javaGameActivity, jstring path, jstring funcName,
    jstring internalDataDir, jstring obbDir, jstring externalDataDir,
    jobject jAssetMgr, jbyteArray savedState) {
    GameActivity_register(env);
    jlong nativeCode = loadNativeCode_native(
        env, javaGameActivity, path, funcName, internalDataDir, obbDir,
        externalDataDir, jAssetMgr, savedState);
    return nativeCode;
}

line.1159

{"loadNativeCode", "(Landroid/app/Activity;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Landroid/content/res/AssetManager;[B)J", (void *)loadNativeCode_native},

构建游戏资源

使用 creator 构建 Android 或 iOS 游戏资源。注意选择相应的平台

构建完成后的资源如下

获取落地页

确定对接之后，我方会提供落地页地址，其中包括：SDK 工程、可运行样例、对接文档、自动化运行报告。

沙盒环境说明

WARNING

💡 前期为了方便 CP 方顺利对接，最开始的落地页给出的工程项目是沙盒环境的,当 CP 方对接完成需要最终发布的时候，我们会给正式环境的差异化文件， CP 方替换之后，即可打正式包

下载工程模板的压缩包

点击落地页中的下载工程

导入游戏资源到项目工程出包

• 将assets资源导入 Android 工程模板的assets目录下；或者 iOS 工程模板的Resources目录下

• 将libs资源导入 Android 的libs目录；或者 iOS 工程LibraryLib目录下

  • Android 出包时，如果libs下引擎库 so 文件，文件名不是libcocos2dcpp.so，请修改为libcocos2dcpp.so使用

• 然后运行相关工程，即可编译成功

  注意：此时只是能正常编译工程，运行会卡在启动页，请按照对接文档完成 SDK 的初始化，方可正常进入游戏