v3.5 已构建工程升级 v3.6 指南

本文将详细介绍 Cocos Creator 原生构建工程从 3.5.0 ~ 3.5.x 升级到 3.6 的注意事项。修改仅针对项目工程下的 native 目录。

构建

使用新版本的引擎打开旧版本的工程，待升级完成之后，构建目标平台。为避免升级失败，请先备份好工程，然后依据下列步骤进行升级。

Android 平台

文件修改

• 删除文件：jni/main.cpp
• android/CMakeLists.txt：删除 ${CMAKE_CURRENT_LIST_DIR}/jni/main.cpp

编译修改

为减少包体大小，更改了 CMAKE_C_FLAGS_RELEASE、CMAKE_CXX_FLAGS_RELEASE 编译参数 visibility 的默认值：从 default 改成了 hidden。改完后 arm64-v8a 下的引擎动态库可以减少约 3.5M。针对这个修改，若 release 版本 jni 出现接口找不到，请先检查接口是否有添加 JNIEXPORT 的声明。例如：

• 旧代码

  void Java_com_google_android_games_paddleboat_GameControllerManager_onMouseConnected

• 修改后的代码

  JNIEXPORT void JNICALL Java_com_google_android_games_paddleboat_GameControllerManager_onMouseConnected

代码修改

• 有自定义 jsb 接口的工程：须删除与 NonRefNativePtrCreatedByCtorMap 相关的代码

• JSB 手动绑定的代码需要置空 _finalize 函数, 可参考JSB 2.0 绑定教程 C++ 对象的生命周期管理。

  代码示例如下：

  static bool js_cc_gfx_Size_finalize(se::State& s) // NOLINT(readability-identifier-naming)
  {
      auto iter = se::NonRefNativePtrCreatedByCtorMap::find(SE_THIS_OBJECT<cc::gfx::Size>(s));
      if (iter != se::NonRefNativePtrCreatedByCtorMap::end())
      {
          se::NonRefNativePtrCreatedByCtorMap::erase(iter);
          auto* cobj = SE_THIS_OBJECT<cc::gfx::Size>(s);
          JSB_FREE(cobj);
      }
      return true;
  }
  SE_BIND_FINALIZE_FUNC(js_cc_gfx_Size_finalize)

  改为

  static bool js_cc_gfx_Size_finalize(se::State& s) // NOLINT(readability-identifier-naming)
  {
      return true;
  }
  SE_BIND_FINALIZE_FUNC(js_cc_gfx_Size_finalize)

脚本编写注意事项

由于 Native 引擎的实现和非 Native 的引擎在实现上略有差异，开发者须了解这些差异，现整理如下：

• Readonly：在 Native 平台上，为减少内存使用，获取到的属性是新创建的对象。

  关于 Readonly 的说明可参考 开发注意事项 - ReaOnly