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查看本章视频教程。