构建llvm toolchain使用指导¶

本章节内容会介绍 oebuild 如何快速构建llvm交叉编译链的方法

Note

在开始构建前，请确保构建主机满足以下条件：

至少有 50G 以上的空闲磁盘空间，建议预留尽可能多的空间。
至少有 8G 内存，建议使用内存、CPU数量更多的机器，增加构建速度。

第 1 步: 初始化工作目录¶

oebuild 的工作目录与 openEuler Embedded 版本是相关联的，构建不同版本的 openEuler Embedded，需要创建相对应的工作目录。因此，推荐以openEuler Embedded版本号命名工作目录，例如 workdir_master。当前，可以通过执行以下命令，创建工作目录：

oebuild init [-u URL] [-b BRANCH] [DIRECTORY]
- -u <URL>：yocot-meta-openeuler 仓库地址，默认为 yocto-meta-openeuler。
- -b <BRANCH>：yocot-meta-openeuler 版本分支，默认为 master。如需构建其它版本，直接使用该参数指定对应分支，例如：-b openEuler-22.03-LTS-SP2。
- <DIRECTORY>：需要创建的工作目录。注意，要确保当前用户拥有当前目录的读写权限，否则会报错：Permission denied；且不能指定当前目录中已有的目录，否则会报错：mkdir <directory> failed。
```
# 例如：
# 初始化 master 版本的工作目录
$ oebuild init workdir_master

# 初始化 openEuler-22.03-LTS-SP2 版本的工作目录
$ oebuild init -b openEuler-22.03-LTS-SP2 workdir_2203-sp2
```

成功创建工作目录后，切换到工作目录 执行以下命令，下载目标版本的项目源码：

oebuild update yocto

下载完成后，工作目录如下：

$ tree -L 1 workdir_master/
workdir_master/
├── oebuild.log
└── src
oebuild.log：oebuild 的操作日志。

src：目标版本依赖的软件包源码目录，包括 yocto-meta-openeuler。

第 2 步: 创建定制化的构建配置文件¶

在 oebuild 工作目录下，执行以下命令，创建定制化的构建配置文件：

oebuild generate --llvm [--llvm_lib LLVM_LIB] [-d DIRECTORY]
- --llvm：表示构建llvm交叉编译链。
- --llvm_lib <LLVM LIB>：表示LLVM编译链需要的aarch64的编译链库，目前llvm只支持构建aarch64架构。
- -d <DIRECTORY>：构建目录，用于存放构建产物。
- 当不输入任何参数时，会进入命令行菜单选择界面。
```
oebuild generate
```
  具体界面如下图所示:
1. 此时在”choice build target”中选择”LLVM TOOLCHAIN”表示构建LLVM交叉编译链
2. 在aarch64 lib dir下输入aarch64交叉编译链的路径（可省略）
3. 在directory输入编译目录名，至此按q，退出，按y确认即可生成编译目录
或者直接在命令行输入命令
```
# 例如：
$ oebuild generate --llvm -d llvm-toolchain
```
执行成功后，会在 oebuild 的工作目录下创建出 build 目录，如：
```
$ tree build/
build/
└── llvm-toolchain
    └── toolchain.yaml
```
toolchain.yaml 即为交叉编译链在编译目录下的配置文件。

第 3 步：设置aarch64 lib路径¶

由于目前llvm只支持aarch64架构的OS镜像，并且仍然依赖aarch64的交叉编译链，因此需要先设置aarch64交叉编译链的地址，如果本地没有，则可以在yocto-meta-openeuler的发行版中去下载，选择好”openEuler Embedded Toolchains vxxx”版本，仅下载arm64le相关的即可，一般完整的一个编译链类型由多个分割文件组成，这是由于gitee发布二进制对文件大小有约束所致，下载完成后将分割文件进行拼接，然后解压即可得到完成的交叉编译链，例如：

需要下载的文件如图示：

然后执行以下命令：

$ ls -al
1_openeuler_gcc_arm64le.tar.gz
2_openeuler_gcc_arm64le.tar.gz
3_openeuler_gcc_arm64le.tar.gz
4_openeuler_gcc_arm64le.tar.gz
$ cat 1_openeuler_gcc_arm64le.tar.gz 2_openeuler_gcc_arm64le.tar.gz 3_openeuler_gcc_arm64le.tar.gz 4_openeuler_gcc_arm64le.tar.gz > openeuler_gcc_arm64le.tar.gz
$ tar zxf openeuler_gcc_arm64le.tar.gz
$ ls -al
1_openeuler_gcc_arm64le.tar.gz
2_openeuler_gcc_arm64le.tar.gz
3_openeuler_gcc_arm64le.tar.gz
4_openeuler_gcc_arm64le.tar.gz
openeuler_gcc_arm64le.tar.gz
openeuler_gcc_arm64le

得到aarch64交叉编译链后，设置llvm的aarch64 lib路径

oebuild toolchain setlib xxxx/openeuler_gcc_arm64le

第 4 步：更新环境¶

在构建交叉编译链中，是需要将交叉编译链所在目录的全部文件都拷贝到编译目录中的，因此执行以下命令进行拷贝操作

oebuild toolchain upenv

第 5 步：下载源码¶

这里是下载llvm交叉编译链所需要的相关代码，下载的源码会放在open_source目录下

oebuild toolchain downsource

第 6 步：执行构建¶

在第2步生成配置文件中，我们有选定交叉编译链流程，在这一步中，我们可以直接执行自动构建，也可以直接构建某个交叉编译链，也可以进入编译环境进行实时交互

直接执行自动构建
```
oebuild toolchain auto
```
直接构建llvm
```
oebuild toolchain llvm
```

进入编译环境，然后构建llvm

oebuild toolchain
cd open_source/llvm-project
./build.sh -e -o -s -i -b release -I clang-llvm-17.0.6
cd clang-llvm-17.0.6
mkdir lib64 aarch64-openeuler-linux-gnu
cp -rf /path/to/gcc/openeuler_gcc_arm64le/lib64/gcc lib64/
cp -rf /path/to/gcc/openeuler_gcc_arm64le/aarch64-openeuler-linux-gnu/include aarch64-openeuler-linux-gnu/
cp -rf /path/to/gcc/openeuler_gcc_arm64le/aarch64-openeuler-linux-gnu/sysroot aarch64-openeuler-linux-gnu/
cd bin
ln -sf ld.lld aarch64-openeuler-linux-gnu-ld

构建完成后，在编译目录下的open_source/llvm-project/clang-llvm-17.0.6存放这构建产物