Castle 开源项目零基础入门指南

1 核心模块地图：架构设计与技术栈解析

通过Castle的模块化架构，您可以快速定位各功能模块的实现逻辑。以下是项目核心目录的功能解析：

目录路径	功能描述	技术栈标签
cdb/	结构化数据库核心实现，包含数据解析与存储逻辑	Haxe、SQL解析
src/lvl/	关卡编辑系统，处理地图渲染与图层管理	2D图形、图层系统
src/js/node/webkit/	桌面应用交互层，实现窗口与菜单控制	Node.js、WebKit
www/	Web服务前端资源，包含UI界面与静态资源	HTML/CSS、Bootstrap

Castle采用数据-视图-控制分离设计，核心逻辑在[cdb/Parser.hx]中实现，关卡编辑功能通过[src/lvl/LayerGfx.hx]渲染图层数据。

💡 实用技巧：开发新功能时，建议先通过list_code_definition_names工具分析目标目录的顶层定义，快速掌握模块接口设计。

2 快速上手流程：零基础环境配置

🔧 环境检查
确保系统已安装Haxe 4.2.0+和Node.js 14+，通过以下命令验证：

haxe --version && node --version

🔧 依赖安装
克隆仓库并安装项目依赖：

git clone https://gitcode.com/gh_mirrors/ca/castle
cd castle && haxelib install castle.hxml

🔧 示例运行
启动Web服务与桌面编辑器：

haxe castle.hxml && node bin/castle.js

环境兼容性说明：Linux系统需额外安装libwebkit2gtk-4.0-dev，macOS用户建议使用Homebrew管理依赖。

💡 实用技巧：测试功能可运行src/test/TestCastle.hx，通过test-hl.hxml配置文件指定测试环境。

3 个性化配置指南：多环境适配方案

开发环境

• 调试模式：修改castle.hxml添加-debug参数，启用运行时日志输出
• 资源热重载：在www/js/app.js中设置watch: true，实现前端资源实时更新

测试环境

• 测试数据集：使用src/test/res/data.cdb作为测试数据库，通过TestCastle.hx验证数据解析逻辑
• 自动化测试：执行haxe test-js.hxml运行JavaScript环境测试套件

生产环境

• 性能优化：在src/Main.hx中设置minify: true，压缩输出代码
• 路径配置：通过Resolver.hx自定义资源加载路径，适应不同部署环境

常见问题解决方案：若出现数据库连接失败，检查cdb/SqlConnection.hx中的连接字符串配置；图层渲染异常可清理www/img/cache目录缓存。

图1：Castle关卡编辑器主界面，展示图层管理与场景编辑功能

图2：生物属性数据库管理界面，支持数据条目增删改查

💡 实用技巧：通过www/css/style.css自定义界面主题，修改--primary-color变量可快速切换配色方案。