应用程序类 CocosApplication 源码分析

原创 已于 2025-11-10 21:36:05 修改 · 1.1k 阅读 · 13 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
cocos 架构分析

当前文章被收录于：

cocos 架构分析
18 篇文章 1 人学习

一分钟cocos架构分析系列

订阅专栏 查看详情
于 2025-11-10 21:35:07 首次发布

CocosApplication 是 Cocos Creator 引擎的核心组件之一，主要负责管理应用程序的生命周期和初始化引擎，它是 Cocos Creator 引擎与原生平台之间的桥梁。

CocosApplication 类的主要职责包括：

  1. 初始化引擎
  2. 管理应用程序生命周期（启动、暂停、恢复、关闭）
  3. 处理脚本执行和异常
  4. 创建和管理窗口
  5. 注册和处理引擎事件

CocosApplication 类构造和析构

构造函数

CocosApplication::CocosApplication() {
    _engine = BaseEngine::createEngine();
}

这是 CocosApplication 类的构造函数，它通过调用 BaseEngine::createEngine() 创建了一个引擎实例。这个引擎实例是整个 Cocos Creator 引擎的核心，负责管理游戏循环、渲染、资源加载等关键功能。

CocosApplication.cpp:31:35

析构函数

CocosApplication::~CocosApplication() {
    unregisterAllEngineEvents();
}

析构函数调用了 unregisterAllEngineEvents() 方法，用于注销所有注册的引擎事件，确保在应用程序关闭时正确清理资源。

CocosApplication.cpp:36:40

unregisterAllEngineEvents 方法

void CocosApplication::unregisterAllEngineEvents() {
    if (_engine != nullptr) {
        _engine->off(_engineEvents);
    }
}

这个方法用于注销所有引擎事件监听器，防止内存泄漏。它检查引擎实例是否存在，如果存在则移除所有事件监听。

CocosApplication.cpp:41:46

init 方法分析

init 方法是 CocosApplication 类中最重要的方法之一，负责初始化整个应用程序和引擎。让我们详细分析这个方法的实现：

int CocosApplication::init() {
    if (_engine->init()) {
        return -1;
    }
    unregisterAllEngineEvents();

    _systemWindow = CC_GET_MAIN_SYSTEM_WINDOW();

    _engineEvents = _engine->on<BaseEngine::EngineStatusChange>([this](BaseEngine * /*emitter*/, BaseEngine::EngineStatus status) {
        switch (status) {
            case BaseEngine::ON_START:
                this->onStart();
                break;
            case BaseEngine::ON_RESUME:
                this->onResume();
                break;
            case BaseEngine::ON_PAUSE:
                this->onPause();
                break;
            case BaseEngine::ON_CLOSE:
                this->onClose();
                break;
            default:
                CC_ABORT();
        }
    });

    se::ScriptEngine *se = se::ScriptEngine::getInstance();

    jsb_init_file_operation_delegate();

    se->setExceptionCallback(
        std::bind(&CocosApplication::handleException, this, // NOLINT(modernize-avoid-bind)
                  std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));

    jsb_register_all_modules();
#if CC_EDITOR
    auto isolate = v8::Isolate::GetCurrent();
    se->start(isolate);
#else
    se->start();
#endif

#if (CC_PLATFORM == CC_PLATFORM_IOS)
    auto logicSize = _systemWindow->getViewSize();
    IScreen *screen = _engine->getInterface<IScreen>();
    float pixelRatio = screen->getDevicePixelRatio();
    uint32_t windowId = _systemWindow->getWindowId();
    events::Resize::broadcast(logicSize.width * pixelRatio, logicSize.height * pixelRatio, windowId);
#endif
    return 0;
}

CocosApplication.cpp:47:90

init 方法详解

  1. 引擎初始化

    if (_engine->init()) {
    return -1;
}

    首先调用引擎的 init() 方法进行初始化。如果初始化失败，返回 -1 表示错误。

  2. 事件注销

    unregisterAllEngineEvents();

    在重新注册事件之前，先注销所有已有的引擎事件。

  3. 获取系统窗口

    _systemWindow = CC_GET_MAIN_SYSTEM_WINDOW();

    通过宏 CC_GET_MAIN_SYSTEM_WINDOW() 获取主系统窗口接口，用于后续的窗口操作。

  4. 注册引擎状态变化事件

    _engineEvents = _engine->on<BaseEngine::EngineStatusChange>([this](BaseEngine * /*emitter*/, BaseEngine::EngineStatus status) {
    switch (status) {
        case BaseEngine::ON_START:
            this->onStart();
            break;
        case BaseEngine::ON_RESUME:
            this->onResume();
            break;
        case BaseEngine::ON_PAUSE:
            this->onPause();
            break;
        case BaseEngine::ON_CLOSE:
            this->onClose();
            break;
        default:
            CC_ABORT();
    }
});

    注册引擎状态变化事件监听器。当引擎状态发生变化时（启动、暂停、恢复、关闭），会调用相应的处理方法。

  5. 获取脚本引擎实例

    se::ScriptEngine *se = se::ScriptEngine::getInstance();

    获取脚本引擎实例，用于执行 JavaScript 代码。

  6. 初始化文件操作委托

    jsb_init_file_operation_delegate();

    初始化文件操作委托，为 JavaScript 提供文件操作能力。

  7. 设置异常回调

    se->setExceptionCallback(
    std::bind(&CocosApplication::handleException, this, // NOLINT(modernize-avoid-bind)
              std::placeholders::_1, std::placeholders::_2, std::placeholders::_3));

    设置脚本引擎的异常回调函数，当 JavaScript 代码抛出异常时会调用 handleException 方法。

  8. 注册所有模块

    jsb_register_all_modules();

    注册所有 JavaScript 模块，使 JavaScript 代码可以访问 C++ 实现的功能。

  9. 启动脚本引擎

    #if CC_EDITOR
auto isolate = v8::Isolate::GetCurrent();
se->start(isolate);
#else
se->start();
#endif

    启动脚本引擎。在编辑器模式下需要传递 V8 的 isolate 实例。

  10. iOS 特定初始化

    #if (CC_PLATFORM == CC_PLATFORM_IOS)
auto logicSize = _systemWindow->getViewSize();
IScreen *screen = _engine->getInterface<IScreen>();
float pixelRatio = screen->getDevicePixelRatio();
uint32_t windowId = _systemWindow->getWindowId();
events::Resize::broadcast(logicSize.width * pixelRatio, logicSize.height * pixelRatio, windowId);
#endif

    对于 iOS 平台，进行特定的初始化操作，包括获取视图大小、像素比例，并广播窗口大小变化事件。

其他重要方法

run 方法

int32_t CocosApplication::run(int argc, const char **argv) {
    CC_UNUSED_PARAM(argc);
    CC_UNUSED_PARAM(argv);
    return _engine->run();
}

run 方法启动应用程序的主循环。它忽略传入的命令行参数，并调用引擎的 run() 方法启动游戏循环。

CocosApplication.cpp:91:96

pause 和 resume 方法

void CocosApplication::pause() {
    _engine->pause();
}

void CocosApplication::resume() {
    _engine->resume();
}

这两个方法分别用于暂停和恢复应用程序。它们直接调用引擎的相应方法。

CocosApplication.cpp:97:104

restart 方法

void CocosApplication::restart() {
    _engine->restart();
}

restart 方法用于重启应用程序，调用引擎的 restart() 方法。

CocosApplication.cpp:121:124

close 方法

void CocosApplication::close() {
    _systemWindow->closeWindow();
}

close 方法用于关闭应用程序窗口，调用系统窗口的 closeWindow() 方法。

CocosApplication.cpp:133:136

事件处理方法

onStart, onResume, onPause, onClose 方法

void CocosApplication::onStart() {
    // TODO(cc): Handling engine start events
}

void CocosApplication::onPause() {
    // TODO(cc): Handling pause events
}

void CocosApplication::onResume() {
    // TODO(cc): Handling resume events
}

void CocosApplication::onClose() {
    _engine->close();
}

这些方法是引擎状态变化事件的处理函数。当引擎状态变为启动、暂停、恢复或关闭时，会调用相应的方法。目前这些方法的实现是空的，需要在子类中重写以实现具体的功能。

CocosApplication.cpp:140:158

辅助方法

setDebugIpAndPort 方法

void CocosApplication::setDebugIpAndPort(const ccstd::string &serverAddr, uint32_t port, bool isWaitForConnect) {
    // Enable debugger here
    jsb_enable_debugger(serverAddr, port, isWaitForConnect);
}

设置调试器的 IP 地址和端口，启用调试功能。

CocosApplication.cpp:159:164

runScript 方法

void CocosApplication::runScript(const ccstd::string &filePath) {
    jsb_run_script(filePath);
}

执行指定路径的脚本文件。

CocosApplication.cpp:166:169

handleException 方法

void CocosApplication::handleException(const char *location, const char *message, const char *stack) {
    // Send exception information to server like Tencent Bugly.
    CC_LOG_ERROR("\nUncaught Exception:\n - location :  %s\n - msg : %s\n - detail : \n      %s\n", location, message, stack);
}

处理脚本引擎抛出的异常，记录错误信息。

CocosApplication.cpp:170:176

setXXTeaKey 方法

void CocosApplication::setXXTeaKey(const ccstd::string &key) {
    jsb_set_xxtea_key(key);
}

设置 XXTEA 加密密钥。

CocosApplication.cpp:177:180

createWindow 方法 (Windows/Linux/Mac 平台)

#if CC_PLATFORM == CC_PLATFORM_WINDOWS || CC_PLATFORM == CC_PLATFORM_LINUX || CC_PLATFORM == CC_PLATFORM_QNX || CC_PLATFORM == CC_PLATFORM_MACOS
void CocosApplication::createWindow(const char *title, int32_t w,
                                    int32_t h, int32_t flags) {
    _systemWindow->createWindow(title, w, h, flags);
}

void CocosApplication::createWindow(const char *title,
                                    int32_t x, int32_t y, int32_t w,
                                    int32_t h, int32_t flags) {
    _systemWindow->createWindow(title, x, y, w, h, flags);
}
#endif

为 Windows、Linux 和 Mac 平台定义了创建窗口的方法。

CocosApplication.cpp:181:193

总结

CocosApplication 是 Cocos Creator 引擎与原生平台交互的核心文件之一。它定义的 CocosApplication 类负责管理应用程序的生命周期，初始化引擎，处理脚本执行和异常，以及创建和管理窗口。

init 方法是这个类中最重要的方法，它完成了以下关键任务：

  1. 初始化引擎
  2. 注册引擎状态变化事件
  3. 初始化脚本引擎
  4. 设置异常处理
  5. 注册所有 JavaScript 模块
  6. 启动脚本引擎
  7. 处理平台特定的初始化（如 iOS）

通过这些功能，CocosApplication 类为 Cocos Creator 引擎提供了一个稳定的基础，使得开发者可以专注于游戏逻辑的实现，而不需要关心底层的平台细节。

标签
#游戏 #cocos2d #架构 #源代码管理 #游戏引擎
VC6雷霆战机C++完整源码解析与游戏开发实践
weixin_29041443的博客
09-11 457
雷霆战机》是一款经典的2D横版射击游戏，其开发采用Visual C++ 6.0（VC6）平台，结合Win32 API与GDI图形接口，是学习Windows本地游戏开发的优秀实践案例。本章将介绍游戏的开发背景、VC6开发环境搭建流程，以及游戏核心功能模块的划分逻辑。通过本章学习，读者将理解游戏的整体架构设计思路，包括窗口创建、主循环控制、图形绘制、输入响应与对象管理等关键环节，并为后续章节的深入开发打下坚实基础。
深入解析微信飞机大战cocos2d-x源码及实战指南
weixin_42612405的博客
05-09 1399
在当今的游戏开发领域，Cocos2d-x作为一个流行的开源框架，为开发者提供了一个高效的多平台游戏开发解决方案。通过理解Cocos2d-x的基本架构，我们可以快速入门并深入探究其功能。Cocos2d-x 是Cocos2d游戏引擎的C++版本，支持iOS、Android、Windows和Web等多个平台。它采用了场景-层-精灵的层次结构，易于理解和使用。此外，Cocos2d-x还具有性能优化良好、组件化开发和丰富的文档资源等特点，这使得它成为许多游戏开发者的首选。
cocos creator 小游戏源码
12-13
可以直接发布到微信，做成微信小游戏。是跟着教程做的小游戏，需要来
完全自创cocos2d游戏源码
07-20
游戏设计大赛时写的游戏源代码，完全自创，有三种模式，用到粒子效果、物理引擎等，相关游戏已经在android市场发布，游戏叫做Crazy Blocks，可供相互学习
cocos creater 3.8 获取IMEI和设备id（亲测）
z409655136的博客
07-27 1030
获取IEMI需要开启权限获取设备id无需权限，所以建议获取设备id首先构建项目，构建出安卓代码。找到安卓代码里面的位置，我的文件地址是（\项目地址\build\jsb-link\frameworks\runtime-src\proj.android-studio\app\src\org\cocos2dx\javascript）我这里是获取设备id的，无需开启权限，
cocoscreator3.7.2接入bugly
xuyid的专栏
05-12 2205
1.先去bugly官网阅读文档2.andorid接入选择自动集成。
千款小游戏源码，直接打包微信小游戏、iOS、Android！赶紧收藏
奎特尔星球
02-20 2214
很多人还不知道 Cocos Store 资源商城，它是国内最大的小游戏资源平台。上面有大量免费游戏源码可以下载，比如下图的《赛博朋克》，项目中包含大量模型、贴图，还有游戏源代码，通过Cocos引擎可以直接在浏览器上玩。本文就带你从Cocos引擎的下载、安装、到游戏源码运行，Let's Go！！！01 下载 Cocos Dashboard打开浏览器，进入 Cocos Store 资源商城，找到比如 ...
CocosCreator3.8源码分析
破竹的博客
02-02 3944
3.1 V8的API定义了几个基本概念：句柄（handle）、作用域（scope）、上下文环境（Context）、模板（Templates）。上下文环境Context就是脚本的运行环境，JavaScript的变量、函数等都存在于上下文环境Context中。Context可以嵌套，即当前函数有一个Context，调用其它函数时如果又有一个Context，则在被调用的函数中javascript是以最近的Context为准的，当退出这个函数时，又恢复到了原来的Context。
cocos激战突围闯关小程序游戏源码下载，支持上架抖音微信小游戏等（开源代码，可二开）附教程
huizanyun的博客
09-08 760
这款代码是网上付费下载的，本人对技术不太懂，不会二次开发，比如换换皮肤等等，所以免费赠送给大家做学习和二开使用，相信好的东西在懂技术的人手里，才能发挥出他最大的价值。可以自己二开更多关卡，注意，这个源码是单机版，没有后台，源码导入开发工具直接发布即可。游戏规则默认的，需要修改游戏规则，需要自己在代码里面修改，需要有一定的开发技术。里面的人物和画面图片都可以在源码文件里面自己修改，自己修改成狗，猪都可以哦。这个源码的游戏引擎是cocos，需要自己下载。详细请看源码里面的教程哦。
深入CocosApplication源码：掌握游戏引擎生命周期与启动流程优化
weixin_29534421的博客
08-09 311
在游戏开发中，应用程序生命周期管理是连接游戏逻辑与底层平台的核心机制，它定义了应用从启动、运行到销毁的完整过程。其原理在于通过统一的入口点协调渲染、资源、输入等子系统，确保各模块有序初始化和协作。这一设计对于构建高性能、跨平台的游戏应用至关重要，能够有效解决启动性能、内存管理和多平台适配等工程挑战。具体到Cocos Creator引擎，CocosApplication类正是这一理念的实践，它作为引擎与原生平台间的桥梁，通过封装平台差异性的生命周期钩子，为开发者提供了标准化的控制点。理解其内部启动流程和游戏循
15款Cocos2d-x游戏源码
Game Developer
11-24 6745
From: http://blog.okbase.net/iphone/archive/4619.html
Cocos Creator实现左右跳游戏，附完整源码
代码小牛的博客
09-28 2511
​1. 玩法说明 烟雨红尘 www.zuxs.net 游戏开始后，点击屏幕左右两侧，机器人朝左上方或右上方跳一步，如果下一步有石块，成功得1分，否则游戏结束。 2. 模块介绍 游戏场景分为2个：主页场景（home）、游戏场景（game）。 ​ 主页场景（home）作为游戏入口，没有其他功能，单纯提供游戏入口。 ​ 游戏场景（game）实现游戏玩法以及游戏逻辑控制...
Vibe Coding 实战：用 MonkeyCode 一个下午做出可玩的小游戏
2404_89164415的博客
08-18 89
第一步：描述玩法。
德迅云安全游戏盾：筑牢游戏服务器安全防线的技术实践与策略指南
shangguan_001的博客
08-17 204
在游戏行业攻防对抗日趋激烈的当下，网络安全已经成为游戏企业稳定运营、留存用户、保障营收的核心基石，安全防护能力直接决定游戏产品的生命周期与市场竞争力。传统粗放式、通用化的防护方案已无法适配行业发展需求，专属化、智能化、轻量化的游戏防护体系成为行业必然趋势。德迅云安全游戏盾凭借成熟的底层技术架构、全生命周期场景适配能力、海量实战落地经验，完美解决了游戏服务器DDoS、CC攻击防护难题，平衡了安全防护、用户体验与运营成本三大核心需求，为游戏企业提供了一站式、可落地的安全防护解决方案。
Unity3D RPG 入门项目（九）头像框、迷你小地图
2301_80252792的博客
08-17 196
本文系统介绍了游戏开发中3D角色头像、小地图及UI系统的实现方案。采用RenderTexture离线渲染配合分层摄像机实现动态头像框，对比分析普通Mask与自定义Shader遮罩的优劣；详细讲解了角色血蓝经验UI的数据绑定与按需刷新机制，以及基于循环计算的角色升级逻辑；提出正交相机小地图设计方案，包含比例尺换算、点击寻路功能实现；重点阐述Layer分层渲染技术对主场景、头像、小地图的隔离作用，包括NPC标记的单向渲染处理。整套方案涵盖从底层渲染到上层交互的全流程实现，适用于RPG项目的2D/3D混合UI开发
游戏开发架构选型：第1篇｜什么是架构？从进球事件看 MVC 的局限
优梦创客的专栏
08-16 75
本文探讨游戏开发中架构选型的核心问题，通过足球游戏“进球事件”对比MVC、MVVM和事件驱动三种架构的优劣。MVC的两种变体（上帝Controller和经典MVC）均存在耦合问题：前者集中依赖，后者导致Model承担隐式调度。MVVM因Unity缺乏原生绑定支持而落地困难，且调试复杂。事件驱动通过发布/订阅模式实现松耦合，新增功能零侵入，支持静态类型安全和条件分支。架构的核心价值在于隔离变化，确保代码长期可维护性。后续将结合定量分析进一步对比架构选择。
游戏线上事故怎么复盘：事实时间线、根因分析、行动项与效果验证
最新发布
m0_59437018的博客
08-20 323
摘要： 游戏线上事故复盘应遵循系统化方法，聚焦问题解决而非追责。首先应快速止损并恢复服务，确保玩家体验；随后通过时间线重建、证据收集进行系统性分析，区分直接触发原因、促成因素和检测缺口；最终制定可验收的具体行动项（含责任人、截止时间及验证方式），并通过演练或数据验证改进效果。关键要避免泛泛而谈"加强测试"，而应落实到流程优化、监控增强等具体防护措施，形成预防-检测-恢复的闭环管理。复盘质量体现在能否将事故转化为长期质量保障能力的提升。
Unity3D(Unity)跨平台游戏引擎简介
Zhang Phil
08-15 408
Unity3D是一款功能强大的跨平台游戏引擎，由Unity Technologies开发。它整合了渲染引擎、物理系统、动画工具等核心组件，支持2D/3D游戏开发及VR/AR等实时交互应用。主要特点包括：可视化编辑器、C#脚本编程、丰富的资源商店和强大的跨平台发布能力（支持移动端/主机/PC等20+平台）。Unity显著降低了开发门槛，特别适合中小团队，在移动游戏和独立游戏领域应用广泛。虽然存在包体优化等挑战，但其高效的工作流程和完整的生态体系使其成为游戏开发的主流选择之一。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值