• Lua 引擎支持
    • 目标
    • 主要特征
      • 一些控件暂时无法支持:
    • 使用说明
      • 第一次构建项目
      • 自动构建
      • 运行游戏

    Lua 引擎支持

    作者:Dualface

    目标

    让 Lua 开发者可以使用 Cocos Creator 来搭建场景和 UI,并在 Lua 游戏中正常显示和操作。

    主要特征

    当前支持的功能如下所示:

    • Sprite - 精灵:图像显示
    • Canvas - 画布:主要用于自动布局
    • Widget - 部件:可以配合 Canvas 设置自动布局和各种对齐方式
    • Button - 按钮:响应玩家操作
    • EditBox - 编辑框:用于玩家输入文字
    • ParticleSystem - 粒子系统:显示粒子效果
    • TileMap - 地图:显示使用 Tiled 编辑的地图
    • Animation - 动画:仅支持帧动画
    • Label (System Font) - 文字标签:仅支持系统字体
    • Component with Lifetime events - 组件及其生命周期管理

    一些控件暂时无法支持:

    • ProgressBar
    • Layout
    • ScrollView

    使用说明

    从 Cocos Creator v1.3 版本开始,Lua 工程支持将以插件形式加入到 Creator 中,首先您需要下载 Creator-for-Lua 插件并执行安装程序:

    • Creator For Lua v1.1.3 Windows 版下载
    • Creator For Lua v1.1.3 Mac 版下载

    第一次构建项目

    1. 新建一个 Lua 工程

      使用命令 cocos new -l lua GAME-NAME 新建一个 Lua 工程。

    2. 在 Creator 中搭建好您的场景,然后从主菜单里选择 工程 -> Lua Support -> Setup Target Project,打开 Lua 项目设置界面

      lua project

    3. 点击 Project Path 旁边的 按钮选择你的 Lua 工程目录

    4. 点击 Copy Support Library 按钮(这个步骤只需要对每一个新 Lua 工程做一次)
    5. 点击 Build 按钮

    自动构建

    默认情况下,并没有启用自动构建功能。所以修改场景后要更新 Lua 代码,需要重新点击 Build 按钮,或者选择菜单 工程 -> Lua Support -> Build Now

    更省事儿的做法是在对话框中选中 Auto Build 选项。这样每次保存场景,就会自动更新 Lua 代码啦。

    运行游戏

    完成初次构建后,或者每次重新构建完成后,在你的 Lua 工程路径下使用 cocos run 命令,即可看到场景效果:

    play scene