Docker搭建loongarch64新世界交叉编译环境

本文跟龙芯2K0300相关。

前提是参照https://gitee.com/open-loongarch/docs-2k0300文档下载好交叉编译工具链。

背景

为啥这么麻烦？因为我目前使用的Linux发行版是UnionTech OS Desktop 20 Home，glibc版本是2.28，运行/opt/loongarch64-linux-gnu-gcc13.3/bin/loongarch64-linux-gcc会报错：

/opt/loongarch64-linux-gnu-gcc13.3/bin/loongarch64-linux-gcc: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found (required by /opt/loongarch64-linux-gnu-gcc13.3/bin/loongarch64-linux-gcc)

步骤

使用Docker搭建环境来规避glibc版本问题，也不算太麻烦，配置如下：

1. 首先起码给open-loongarch一个独立的文件夹吧，然后将u-boot和linux-6.12等项目git clone到这个文件夹里面。

2. 在open-loongarch文件夹里面添加两个文件：

   Dockerfile:

   FROM debian:12
   
   # 更新包列表并安装 sudo 等
   RUN apt-get update && apt-get install -y sudo make gcc flex bison bc libelf-dev libssl-dev bsdmainutils git
   
   # 创建 uid 为 1000 的用户，用户名为 loong，并添加到 sudoers 中（允许无密码使用 sudo）
   RUN useradd -m -u 1000 -s /bin/bash loong && echo "loong ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
   
   # 切换到 loong 用户
   USER loong
   
   WORKDIR /home/loong
   

   docker-compose.yml:

   services:
     toolchain:
       build: .
       user: "1000:1000"
       tty: true
       stdin_open: true
       network_mode: "host"
       volumes:
       - /opt/loongarch64-linux-gnu-gcc13.3:/opt/loongarch64-linux-gnu-gcc13.3
       - .:/home/loong/workspace/open-loongarch
       working_dir: /home/loong/workspace/open-loongarch
   

   理论上发行版的个人账号UID是1000，docker容器使用用户1000来跑的好处是权限跟宿主机的用户一致，构建的时候不会生成一堆root所有的文件，而且镜像加上了sudo，可以使用sudo来跑一些诸如apt install的命令。

3. 运行docker compose run toolchain即可创建并进入到容器，如果不想每次run都创建一个容器，可以加上--rm参数，或者先docker compose up -d然后再docker compose exec toolchain bash。

后记

如果是需要阅读u-boot或者linux的源码，并且依赖clangd，那么在容器里面运行bear或者linux源码里面的./scripts/clang-tools/gen_compile_commands.py脚本生成的compile_commands.json，其中的file字段就不太对了，解决方法也简单，Dockerfile里面的用户名改成跟你宿主机的名字一样，并且确保挂载映射的路径跟宿主机的一致就可以。