在开始前，建议首先阅读 YAO 架构解析， 了解 YAO 的源码结构。

YAO 采用 golang 开发，可以在 Mac 或 Linux 环境中建立开发环境。

Golang

推荐使用 Docker 安装服务

MySQL Docker 镜像

YAO 相关的代码仓库

下载源码到项目目录

mkdir /your-project/root
git clone https://github.com/yaoapp/yao
git clone https://github.com/yaoapp/gou
git clone https://github.com/yaoapp/xun
git clone https://github.com/yaoapp/kun
git clone https://github.com/yaoapp/v8go

设置环境变量用于源码调试

export YAO_DEV="/your-project/root/yao"
export YAO_ENV="development"
export YAO_ROOT="/your-project/root/yao/tests"
export YAO_HOST="0.0.0.0"
export YAO_PORT="5099"
export YAO_LOG="/your-project/root/yao/tests/logs"
export YAO_JWT_SECRET="qo-2U+hoTRU"

# 启用 MySQL 数据库
export YAO_DB_DRIVER=mysql
export YAO_DB_PRIMARY="root:db-password@tcp(db-server:3308)/xiang?charset=utf8mb4&parseTime=True&loc=Local"
export YAO_DB_AESKEY="LX=T&f6refe"

进入 Yao 项目目录运行单元测试

cd /your-project/root/yao
make test

使用 Go 命令调试

cd /your-project/root/yao
go run .
go run . run xiang.sys.ping
go run . start

首次编译需安装相关工具

cd /your-project/root/yao
make tools

编译过程中会从 https://github.com/YaoApp/xgen.git 仓库拉取代码并构建 需提前安装 nodejs 16+

cd /your-project/root/yao
make release

制品为 dist/release/yao

cd /your-project/root/yao
make linux-release

制品为 dist/release/yao

不集成 XGen 界面引擎

make debug

制品为 dist/release/yao-debug

https://github.com/YaoApp/yao/blob/main/.github/workflows/release-linux.yml https://github.com/YaoApp/yao/blob/main/.github/workflows/release-macos.yml

编译环境 Dockerfile: https://github.com/YaoApp/dockerfiles/tree/main/build

docker run -it --rm yaoapp/yao-build:0.10.1-amd64 /bin/bash

docker run -it --rm -v /path/source:/source yaoapp/yao-build:0.10.1-amd64 /bin/bash

docker build --platform linux/amd64 -t yaoapp/yao-build:0.10.1-amd64 .