你的下一个构建工具，何必是构建工具

[ansurfen]

Yock是一个为构建而生的框架，他有点类似于 nodejs 和 bazel ，底层基于一个解释器封装了一些功能。正如 nodejs 那样，yock 也基于封装过的 lua 实现了自己的包管理工具——ypm ，这意味着引入第三方库成为可能。

安装

注意: 无论是哪一种安装方式，下载完后都需要将 yock 挂载到本地环境中。在解压压缩包后，进入可执行文件的目录运行yock run install.lua完成这个过程。

Git Release (推荐，第一时间发布最新版本)

github: 选择合适的压缩包下载完解压运行 install.lua 即可。

包管理工具安装 (版本更新存在滞后)

包管理工具下载完后一般会自动解压，解压完后还是需要手动运行 install.lua ，因此强烈推荐用Git Release的形式。

npm: npm i @ansurfen/yock -g

pip: pip install yock

自己构建

git clone https://github.com/Ansurfen/yock.git
cd ctl

./build.bat/sh //正常构建
./build.bat/sh ffi //构建支持 libffi 的版本
./build.bat/sh dev //构建测试版本
./build.bat/sh oslinux//交叉编译，构建 linux 版本

环境搭建

如果你使用 vscode 作为开发环境，可以先安装 lua 语言代码提示的插件以获得更好的体验。

如果你使用 IDEA 等 JetBrain 系列工具进行开发，可以安装 EmmyLua 获得到同样的效果。

快速开始

当yock run install.lua执行成功后，就可以创建一个工作目录编写和测试 yock 脚本。运行ypm tidy补全代码定义，它会在工作目录下创建 include 目录，里面的源文件仅供插件提示使用。

-- main.lua
print("Hello World")
fmt.Printf("Hello %s!\n", "Yock")

创建 main.lua 文件，写下以上内容。使用yock run main.lua执行。如果一切顺利，你将在终端看到输出结果。至此，yock 的开发环境算是配置完成了。下一章开始将会介绍 yock 的具体使用。

你也可以访问https://ansurfen.github.io/YockNav/查看官方文档, 或者前往https://www.bilibili.com/video/BV1WM4y1H7Bc查看本章视频教程。