v3.5 已构建工程升级指南
从 v3.5 开始,Mac 和 Windows 平台的 AppDelegate
已移入引擎内部实现,可以通过重载 AppDelegate
的方式来兼容之前版本的用法;game.cpp
也进行了调整,已有工程需要重新构建进行升级。
工程升级
检查工程目录下 native/engine 目录是否存在。如果存在,需要删除文件夹,删除前需要做好备份(这个目录如果存在,重新构建时不会自动更新);不存在,则直接构建即可。
自定义代码迁移方法
之前在 AppDelegate 添加的代码,可以通过下文定制平台和 AppDelegate 进行升级;自定义的 game.cpp 可以通过接口更替即可升级。
平台与 AppDelegate 的定制方法
以 Mac 为例:
1、自定义AppDelegate(参考文件名:MyAppdelegate.h,MyAppdelegate.mm)
@interface MyAppDelegate : NSObject<AppDelegate>
// 定义需要重写的方法
- (void)applicationWillResignActive:(UIApplication *)application;
@end
@implementation MyAppDelegate
- (void)applicationWillResignActive:(UIApplication *)application {
// 注意:调用父类的方法
[super applicationWillResignActive:application]
}
@end
2、自定义平台(参考文件名:CustomMacPlatform.h)
#include "platform/BasePlatform.h"
#include "MyAppDelegate.h"
class CustomMacPlatform : public MacPlatform {
public:
// 重写平台初始化方法
int32_t init() override {
// 调用父类的方法
return MacPlatform::init();
}
// 这里进入 oc 的消息循环,直到程序退出
int32_t run(int argc, const char** argv) {
id delegate = [[MyAppDelegate alloc] init];
NSApplication.sharedApplication.delegate = delegate;
return NSApplicationMain(argc, argv);
}
}
3、加载自定义平台(参考文件名:main.mm)
#include "CustomMacPlatform.h"
int main(int argc, const char * argv[]) {
CustomMacPlatform platform;
if (platform.init()) {
return -1;
}
return platform.run(argc, (const char**)argv);
}
game.cpp 迁移方法
- 设置js加密秘钥:jsb_set_xxtea_key -> 设置
_xxteaKey
成员变量; 或 调用setXXTeaKey
- 设置调试: jsb_enable_debugger -> 设置
_debuggerInfo
结构, 或 调用setDebugIpAndPort
- 设置异常回调:setExceptionCallback -> 重写
handleException
接口 - 运行自定义脚本:jsb_run_script -> 调用
runScript
- 可以通过使用
engine
来添加需要监听的事件, ->getEngine()->addEventCallback(WINDOW_OSEVENT, eventCb);
- 自定义的游戏
CustomGame
,需要注册到引擎CC_REGISTER_APPLICATION(CustomGame)
进行加载; game
继承于cc::BaseGame
, 而cc::BaseGame
继承于CocosApplication
,因此可以重写部分实现,增加自定义逻辑;
Native 文件修改
- 替换引用的头文件:
#include "cocos/platform/Application.h"
—>#include "application/ApplicationManager.h"
- 使用方式变更:
cc::Application::getInstance()->getScheduler()
->CC_CURRENT_ENGINE()->getScheduler()
- 有自定义 jsb 接口的情况:
native_ptr_to_seval
替换为nativevalue_to_se
Android 升级指南
JAVA 修改
game/AppActivity.java 以及 game/InstantActivity.java 的
onCreate
方法中删除如下代码:java// Workaround in https://stackoverflow.com/questions/16283079/re-launch-of-activity-on-home-button-but-only-the-first-time/16447508 if (!isTaskRoot()) { // Android launched another instance of the root activity into an existing task // so just quietly finish and go away, dropping the user back into the activity // at the top of the stack (ie: the last state of this task) // Don't need to finish it again since it's finished in super.onCreate . return; }
app/AndroidManifest.xml 执行下列操作:
- 删除
application
标签中的下列代码:android:taskAffinity=""
- 在
application
标签中增加下列代码:android:exported="true"
- 删除
app/build.gradle 修改下列代码:
html"${RES_PATH}/assets" -> "${RES_PATH}/data"
CMakeLists.txt 修改
android/CMakeLists.txt
LIB_NAME 变更为 CC_LIB_NAME
PROJ_SOURCES 变更为 CC_PROJ_SOURCES
增加 set(CC_PROJECT_DIR ${CMAKE_CURRENT_LIST_DIR})
增加 set(CC_COMMON_SOURCES)
增加 set(CC_ALL_SOURCES)
删除下列代码:
cmake${CMAKE_CURRENT_LIST_DIR}/../common/Classes/Game.h ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/Game.cpp add_library(${LIB_NAME} SHARED ${PROJ_SOURCES}) target_link_libraries(${LIB_NAME} "-Wl,--whole-archive" cocos2d_jni "-Wl,--no-whole-archive" cocos2d ) target_include_directories(${LIB_NAME} PRIVATE ${CMAKE_CURRENT_LIST_DIR}/../common/Classes )
增加代码:
cmakecc_android_before_target(${CC_LIB_NAME}) add_library(${CC_LIB_NAME} SHARED ${CC_ALL_SOURCES}) # 此处添加用户依赖库 AAA target_link_libraries(${CC_LIB_NAME} AAA) # 此处添加用户自定义文件 xxx/include target_include_directories(${CC_LIB_NAME} PRIVATE ${CMAKE_CURRENT_LIST_DIR}/../common/Classes/xxx/include) cc_android_after_target(${CC_LIB_NAME})
common/CMakeLists.txt
cocos2d-x-lite/ 修改为 engine/native/
文件末尾增加代码:
cmakelist(APPEND CC_COMMON_SOURCES ${CMAKE_CURRENT_LIST_DIR}/Classes/Game.h ${CMAKE_CURRENT_LIST_DIR}/Classes/Game.cpp )