关于rust交叉编译的问题

rust交叉编译

依赖项目https://github.com/cross-rs/cross

安装

$ cargo install cross

该项目需要依赖docker或者podman

获取镜像的时候由于是直接拉ghcr.io/cross-rs/*的镜像，所以国内配置的镜像是无法使用的，这个时候需要配置docker的代理服务才行

查看docker服务配置文件位置

$ sudo systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)

依据上面命令输出，修改文件/lib/systemd/system/docker.service配置HTTP代理，代理的参数值需要依据自己代理而调整

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:20171"
Environment="HTTPS_PROXY=http://127.0.0.1:20171"

重启服务

$ sudo systemctl daemon-reload
$ sudo systemctl restart docker

执行交叉编译

使用的时候需要把cargo替换为cross命令

$ cross build -r --target x86_64-pc-windows-gnu

执行的时候会自动拉取一个镜像ghcr.io/cross-rs/x86_64-pc-windows-gnu:{version}，version参数的值是默认依据cross的版本号定的，比如执行命令如下，发现版本号是0.2.5，则对应的获取镜像是ghcr.io/cross-rs/x86_64-pc-windows-gnu:0.2.5

$ cross --version
cross 0.2.5
[cross] note: Falling back to `cargo` on the host.
cargo 1.68.0 (115f34552 2023-02-26)

编译时候的报错解决

该错误一般会出现在rust以及第三方库版本非常新，但是cross的版本是比较久之前发布的

目前cross的版本是0.2.5，对应的tag值也是一样

编译过程当中会出现如下错误，表示找不到某个GLIBC版本

error: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by /target/release/deps/libfutures_macro-7a167e0564403030.so)

查看容器基础镜像信息

$ docker run ghcr.io/cross-rs/x86_64-pc-windows-gnu:0.2.5 cat /etc/os-release
NAME="Ubuntu"
VERSION="18.04.6 LTS (Bionic Beaver)"
...
VERSION_CODENAME=bionic
UBUNTU_CODENAME=bionic

查看支持的GLIBC版本信息

$ docker run ghcr.io/cross-rs/x86_64-pc-windows-gnu:0.2.5 strings /lib/x86_64-linux-gnu/libc.so.6|grep GLIBC
GLIBC_2.2.5
....
GLIBC_2.24
GLIBC_2.25
GLIBC_2.26
GLIBC_2.27
GLIBC_PRIVATE
GNU C Library (Ubuntu GLIBC 2.27-3ubuntu1.6) stable release version 2.27.

解决步骤

• 切换到项目https://github.com/cross-rs/cross的tag v0.2.5查看文件cross/docker/Dockerfile.x86_64-pc-windows-gnu发现第一行确实是FROM ubuntu:18.04
• 这个时候浏览器直接访问地址ghcr.io/cross-rs/x86_64-pc-windows-gnu，会跳转到https://github.com/cross-rs/cross/pkgs/container/x86_64-pc-windows-gnu
• 发现镜像的tag列表当中存在edge或者main，镜像很新，对应的是main分支的镜像，一般使用这种tag的镜像基本可以解决99%的GLIBC版本找不到的问题，虽然不是release版本的tag，但是rust的程序只要可以成功编译出来，就基本不用有什么执行问题的，可以放心使用

• 在项目根目录下面（与Cargo.toml同级）创建一个文件Cross.toml写入如下

  [target.x86_64-pc-windows-gnu]
  image = "ghcr.io/cross-rs/x86_64-pc-windows-gnu:edge"

• 之后再次执行编译就会使用最新的edge镜像了

  $ cross build -r --target x86_64-pc-windows-gnu

参考阅读

cross官方github readme