cocos2dx lua api 文档

在开始之前，请确保 Code IDE 和引擎已经安装完毕。接下来，我们将详细介绍如何建立一个游戏工程。

选择 Workspace 目录

首次打开 Code IDE 时，需要选择一个 Workspace 目录。Workspace 即工作空间，用于保存开发环境的配置信息。你可以在其中添加一个或多个工程。既可以创建多个 Workspace 来管理不同的工程，也可以使用一个 Workspace 管理所有工程。

进入 Lua 开发环境

进入 Code IDE 主界面后，会显示欢迎界面。在此界面，你可以选择开发 Lua 游戏或 JavaScript 游戏。点击“Lua”按钮，即可进入 Lua 开发环境。

设置引擎路径

若未设置好引擎路径，会弹出引擎设置框。点击下拉列表中的“custom”，然后设置引擎的根目录。需要注意的是，1.2.0 之前和之后的版本界面有所不同：

• 1.2.0 之前的版本：界面布局和操作方式与后续版本存在差异。
• 1.2.0 以及之后的版本：Code IDE 还支持 Cocos 产品自带的 Frameworks。如果你从官网下载并安装了 Cocos 产品，就可以使用其自带的引擎和模拟器。安装 Cocos 产品后，在商城里下载 CocosFramework 并完成安装，你就可以选择 Framework Mode，此时 IDE 会自动识别 Framework 和模拟器路径。使用 Frameworks 的优势在于集成了 JS 和 Lua，并且自带预编译好的库，能够显著提升编译和打包的速度。

新建 Cocos Lua 项目

启动新建项目流程

在界面左边的项目管理器空白区域，右键单击并选择“新建 Cocos Lua 项目”，即可开始新建项目。

项目基本信息设置

在第一个页面，需要设置项目的名称和保存路径。项目默认保存在 Workspace 文件夹下，你也可以手动指定其他保存目录。需要注意的是，在同一个 Workspace 中，项目名称不能重复。

游戏参数设置

在第二个页面，首先要设置游戏的屏幕方向，可选择横屏或竖屏。在桌面平台模拟器的设置项中，你可以设置模拟器上显示的标题和初始窗口大小。若电脑屏幕分辨率较低，可适当调小窗口大小，以确保模拟器启动时整个窗口能完整显示在屏幕内。最后的“添加 C++ 代码”选项决定了新工程是否生成对应的 C++ 源码，你可以根据实际需求选择，也可以在后续需要时再添加，这里我们暂不选择，点击“确定”开始新建工程。

查看新建项目

新建项目完成后，你可以在工程管理界面看到新建的工程。

运行示例代码

新建的工程中包含一段示例代码，可直接运行。选中工程，然后点击工具栏上的调试按钮，新游戏即可启动。

后续操作

接下来，你就可以开始《编写游戏逻辑》了。

小提示

Python 环境配置

新建项目需要在 Code IDE 中配置好 Python 环境。如果已经正确安装 Python，IDE 会自动配置好路径；若出现找不到 Python 的错误，则需要手动配置。

Working Set 的作用

Working Set 是一种项目分组机制，你可以根据需要将项目中的项目放入不同的 Working Set 中，以便于管理。

打开已有 Lua 工程

如果你已有一个非 Code IDE 建立的 Lua 工程，可以参考《如何打开已有的 Lua 游戏工程(未完成)》这个文档。