ruyibuild是一个辅助开发工具，不需要手动搭建复杂的环境和下载代码，只需要几条命名，就可以直接获取所需要的构建好的软件包。
ruyibuild根据配置文件自动下载需要编译的源码和构建脚本，启动一个docker容器中，在docker容器中运行构建脚本来完成构建
下面以ubuntu系统为例来进行说明
ruyibuild是由python编写而成，需要通过pip命令完成安装，
$ sudo apt install python3 python3-pip
由于需要用到docker容器，所以需要安装docker
$ sudo apt install docker docker.io -y
$ sudo groupadd docker
$ sudo usermod -a -G docker $(whoami)
$ sudo systemctl restart docker
$ sudo chmod o+rw /var/run/docker.sock
确保不用加sudo就可以直接执行docker命令
下载 ruyibuild.wheel , 执行pip安装
$ pip install <ruyibuild.wheel>
执行以下命令创建工作目录, 后续自动下载的源码以及构建生成的软件包都会在此目录下
$ ruyibuild init -d <directory> [-f <ruyicfg_directory>]
-d <directory> 表示要创建的工作目录，其中 <directory>可以是绝对路径也可以是相对路径
-f <ruyicfg_directory> 是可选参数，当需要从git仓库获取构建配置文件 config.yaml 文件而不想通过手动修改时，需要添加这个参数，其中 <ruyicfg_directory> 是 包含 config.yaml 文件所在git仓库的信息的yaml文件所在目录，格式如下：
config_file:
repo_url: https://gitee.com/jean9823/ruyibuild_script.git
branch: master
path: qemu/config_ubuntu.yaml
repo_url: config.yaml 文件所在git仓库地址
branch: config.yaml 文件所在git仓库分支
path: config.yaml 文件所在git仓库相对于根目录的位置，如果是存储在根目录，该栏位填写为 path: config_ubuntu.yaml
例如: 执行
$ ruyibuild init -d qemu -f /home/ruyicfg.yaml
就是在当前目录下创建工作目录 qemu , 并从 /home/ruyicfg.yaml 获取 ruyicfg.yaml 文件
工作目录下会生成四个目录：
build: 构建完成的相关文件会存放在该目录下
script: 存放执行构建的脚本
src: 存放需要构建的源码
./ruyibuild: 存放构建配置文件 config.yaml，如果命令设置的 -f 参数，该目录下还会生成一个git目录，用来存放从git仓库获取的构建配置文件config.yaml
可以根据自己的需求进行修改配置文件，文件内容如下：
docker:
repo_url: amd64/ubuntu
tag: "latest"
basic_repo:
repo_url: https://github.com/qemu/qemu.git
branch: master
build_script:
repo_url: https://gitee.com/jean9823/ruyibuild_script.git
branch: master
path: qemu/qemu_ubuntu.sh
配置文件分为三部分：
A) docker容器信息
docker: 需要使用的docker容器的镜像信息，包括：
repo_url: docker容器镜像地址
tag: docker容器镜像tag
B) 源码git仓库地址
basic_repo: 需要构建的源码git仓库信息，包括：
repo_url: git仓库地址
branch: 源码在仓库中的branch
C) build_script: 执行构建的脚本git仓库信息，包括：
repo_url: 脚本git仓库地址
branch: 脚本在git仓库中的branch
path: 脚本在git仓库中相对于根目录的位置，如果是存储在根目录，该栏位填写为 path: qemu_ubuntu.sh
脚本会统一存放在 https://github.com/ruyisdk/ruyici ，可以根据自己的需求选择合适的文件，或者也可以使用自己的脚本，关于脚本内容的要求后面会介绍
在工作目录下执行以下命令下载./ruyibuild/config.yaml配置的docker镜像，需要构建源码和构建脚本
$ ruyibuild update
在工作目录下执行以下命令运行容器并执行构建
$ ruyibuild generate [<name>]
如果不输入<name>，即执行以下命令
$ ruyibuild generate
会运行docker容器，并进入容器，容器名称是 ruyibuild-<workspace>, <workspace> 表示当前工作目录的文件夹的名称，例如当前工作目录是/home/tester/qemu, 运行的容器名称就是ruyibuild-qemu，执行这个命令后方便用户直接在docker容器中执行手动构建和debug
若要销毁该 docker 容器有2种方式：
一种方式是直接使用 docker 命令进行销毁
$ docker stop \<container name or container id> //停止容器运行
$ docker rm \<container name or container id> //删除容器
另一种方式是在当前工作目录下执行以下命令进行销毁
$ ruyibuild destroy
这里需要注意的是如果容器不用了，一定要删除，否则，在相同工作目录下执行 ruyibuild generate <name> 时会因为容器名称已经存在而报错
如果输入<name>，即执行以下命令
$ ruyibuild generate <name>
<name> 表示构建完成后，生成的软件压缩包的包名。
执行该命令后，先运行 docker 容器，容器名称一样是 ruyibuild-<workspace>，然后根据 config.yaml 中的 build_script 设置去工作目录下获取相应的脚本xxx.sh，并执行 sh xxx.sh <name>
构建结束后，不论构建成功还是失败，docker容器会自动销毁，如果构建成功，生成的软件压缩包会存放在工作目录下的output目录下，即在output/<name>.tar.gz就是构建出的软件压缩包，其余目录会被删除，如果构建失败，之前执行 ruyibuild init 生成的目录不会被删除，方便用户debug后再次直接执行 ruyibuild generate <name> 进行构建即可。
ruyibuid目前支持的命令如下：
$ ruyibuild help //帮助
$ ruyibuild version //查询版本
$ ruyibuild init <directory> [-f <ruyicfg_directory>] //创建工作目录
$ ruyibuild update //下载镜像和代码
$ ruyibuild generate [<name>] //运行docker容器，执行构建
$ ruyibuild destroy //销毁docker容器，当使用ruyibuild generate进入容器debug完成后，可以使用该命令销毁容器
容器和工作目录映射关系如下:
<workspace>/src：/home/src
<workspace>/build：/home/build
<workspace>/script：/home/script
从上面的对应关系，以及3.2中介绍的各个目录的作用，可以知道，在容器中:
构建脚本路径是/home/script
所要构建的源码路径是/home/src
构建执行结果路路径是/home/build/<name> , <name>同ruyibuild generate <name>
构建完成后，程序需要将构建结果从 <workspace>/build 中取出并打包放在 <workspace>/output 目录下
由于程序对于这些目录的要求，所以编写脚本时一定要注意这些目录，否则会导致构建无法正确执行，例如：
执行 cd /home/src 确保进入源码目录，再执行编译和构建
执行 ./configure 时，通过 --prefix=/home/build/\$1 来确保构建结果存放到容器中的 /home/build/<name>下，$1表示接收执行脚本命令 sh xxx.sh <name> 中的 <name>
下面是一个在 x86 ubuntu 容器中构建 qemu 的 shell 脚本的例子，供参考
#!/bin/bash
set -x
apt update -y
apt install -y python3 python3-pip build-essential git libglib2.0-dev libfdt-dev libpixman-1-dev zlib1g-dev ninja-build libslirp-dev
pip install meson
cd /home/src
./configure --target-list=riscv64-softmmu,riscv64-linux-user --prefix=/home/build/$1
make -j $(nproc)
make install