项目目录结构

框架依赖

Cocos2d-x 版本: 3.7 项目编辑器：Cocos Studio 3.10 Lua 版本: 5.1

框架概述

本框架是一个基于 quick-cocos2dx lua 的游戏开发框架，主要包含以下两个核心模块：

• cocosExtend: Cocos2d-x lua 引擎扩展模块，包含丰富的UI组件和功能扩展
• utils: 通用工具类模块，提供各种实用工具函数和功能

目录结构

framework/
├── Init.lua                # 框架初始化入口文件
├── ReadMe.md               # 框架说明文档
├── cocosExtend/            # Cocos2d-x 引擎扩展模块
│   ├── Component.lua       # 组件系统基类
│   ├── CocosExtend.lua     # Cocos2d-x 功能扩展
│   ├── UI组件/
│   │   ├── CompEditBox.lua        # 输入框组件
│   │   ├── CompLayout.lua         # 布局组件
│   │   ├── CompLazyList.lua       # 懒加载列表组件
│   │   ├── CompMask.lua           # 遮罩组件
│   │   ├── CompPickerView.lua     # 选择器组件
│   │   ├── CompRichText.lua       # 富文本组件
│   │   ├── CompScrollBar.lua      # 滚动条组件
│   │   ├── CompTextOverflow.lua   # 文本溢出组件
│   │   ├── CompTextUnderLine.lua  # 文本下划线组件
│   │   ├── CompTimeDown.lua       # 倒计时组件
│   │   ├── CompToggle.lua         # tab开关组件
│   │   ├── CompActionCustom.lua   # 自定义动作组件
│   │   ├── CompAutoScaleToWidth.lua # 自动缩放组件
│   │   ├── CompCloseShield.lua    # 屏蔽组件
│   │   ├── CompDebug.lua          # 调试组件
│   │   ├── CompMusicEffect.lua    # 音效组件
│   │   ├── CompRedPoint.lua       # 红点组件
│   │   ├── CompSchedule.lua       # 定时器组件
│   │   ├── CompSpineAction.lua    # Spine动画组件
│   │   └── CompTouchListener.lua  # 触摸监听组件
│   │   └── CompTouchLayer.lua     # 滑动监测组件
│   └── 工具类/
│       ├── Bezier.lua             # 贝塞尔曲线工具
│       ├── EventCenterBubbleUp.lua # 事件冒泡中心
│       ├── HtmlTextParser.lua     # HTML文本解析器
│       └── Pool.lua               # 对象池
└── utils/                  # 通用工具模块
    ├── Debugger.lua        # 调试工具
    ├── LuaProfiler.lua     # Lua性能分析器
    ├── LuaPromise.lua      # Promise实现
    ├── SHA256.lua          # SHA256加密
    ├── TraditionalChinese.lua # 繁体中文表
    ├── Utils.lua           # 通用工具函数
    ├── bitExtend.lua       # 位运算扩展
    ├── qrencode.lua        # 二维码生成
    ├── struct.lua          # 结构体数据结构
    └── utf8_simple.lua     # UTF8编码工具

模块说明

cocosExtend 模块

• Cocos2d-x 功能扩展 (CocosExtend.lua): 提供Cocos2d-x引擎的功能扩展
• 组件系统: 基于 Component.lua 开发的组件系统
• 输入框组件 (CompEditBox): 提供输入框功能
• 布局组件 (CompLayout): 提供灵活的布局功能
• 惰性加载列表 (CompLazyList): 优化长列表性能的懒加载实现
• 遮罩组件 (CompMask): 提供遮罩效果
• 选择器 (CompPickerView): 提供滚动选择功能
• 富文本 (CompRichText): 支持富文本显示
• 滚动条 (CompScrollBar): 自定义滚动条功能
• 文本处理 (CompTextOverflow/CompTextUnderLine): 文本溢出和下划线功能
• 动作系统: 包含自定义动作和Spine动画支持
• 音效系统: 提供音效管理功能
• 红点系统: 提供完整的红点提示功能
• 触摸系统: 提供触摸事件处理
• 调试功能: 提供调试辅助工具
• 定时器: 提供定时器功能
• 贝塞尔缓动: 提供贝塞尔曲线缓动动效

点我查看 LuaComponent 详细介绍

utils 模块

• 调试工具 (Debugger): 提供调试功能
• 性能分析 (LuaProfiler): Lua代码性能分析工具
• 异步处理 (LuaPromise): Promise模式实现
• 加密工具 (SHA256): SHA256加密算法实现
• 字符处理: 包含繁体检测、UTF8处理等功能
• 通用工具 (Utils): 提供常用工具函数
• 特殊功能: 二维码生成、位运算扩展等

使用说明

1. 框架初始化通过 Init.lua 进行
2. 组件系统基于 Component.lua 开发
3. 扩展开发主要关注 Component.lua 和 CocosExtend.lua
4. 组件支持类 JS 方式声明属性