技术

Appearance

rust交叉编译 ​

纯粹的rust代码是很容易实现交叉编译，但是使用到的库中如果使用到C/C++，编译就会比较复杂，直接运行交叉编译命令如下，可能直接报错

$ cargo build -r --target aarch64-apple-darwin
$ cargo build -r --target aarch64-apple-darwin

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

利用docker简化了在x86_64的linux操作系统上进行交叉编译时所需要的前置设置

安装 ​

shell
$ cargo install cross
$ cargo install cross

该项目需要依赖docker或者podman

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

查看docker服务配置文件位置

shell
$ sudo systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
$ 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代理，代理的参数值需要依据自己代理而调整

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

重启服务

shell
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker

执行交叉编译 ​

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

shell
$ cross build -r --target x86_64-pc-windows-gnu
$ 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

shell
$ cross --version
cross 0.2.5
[cross] note: Falling back to `cargo` on the host.
cargo 1.68.0 (115f34552 2023-02-26)
$ 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)
error: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by /target/release/deps/libfutures_macro-7a167e0564403030.so)

查看容器基础镜像信息

shell
$ 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
$ 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版本信息

shell
$ 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.
$ 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写入如下

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

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

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

交叉编译苹果系列 ​

下面采用target aarch64-apple-darwin作为示范

原因 ​

出于版权原因，cross项目未提供ios/darwin相关的容器镜像，所以需要自己构建镜像

版权说明查看地址https://github.com/cross-rs/cross-toolchains#apple-targets

cross还是提供了部分macos/apple相关的镜像制作的代码，后续所有操作版权问题要自己负责

clone项目

shell
$ git clone https://github.com/cross-rs/cross
$ cd cross
$ git submodule update --init --remote
$ git clone https://github.com/cross-rs/cross
$ cd cross
$ git submodule update --init --remote

其他依赖的仓库 ​

cross的打包编译苹果的时候需要使用到如下仓库，用来生成macos cross toolchain和其他一些操作， 该仓库仅作了解

https://github.com/tpoechtrager/osxcross
https://github.com/tpoechtrager/osxcross

交叉编译的时候需要传递docker build-arg参数，MACOS_SDK_DIR和MACOS_SDK_FILE 或者传递一个单独的MACOS_SDK_URL参数，该参数是苹果的构建包数据信息，这个时候可以选择自己整台MACOS去获取MACOS_SDK包，也可以通过第三方仓库获取Macos-sdk

https://github.com/phracker/MacOSX-SDKs
https://github.com/phracker/MacOSX-SDKs

在仓库的release下查找打包好的sdk，下面我会使用macos-11.1-sdk作为MACOS_SDK_URL的参数

https://github.com/phracker/MacOSX-SDKs/releases/download/11.0-11.1/MacOSX11.1.sdk.tar.xz
https://github.com/phracker/MacOSX-SDKs/releases/download/11.0-11.1/MacOSX11.1.sdk.tar.xz

修改dockerfile ​

进入到刚刚的cross仓库下面，找到文件docker/cross-toolchains/docker/Dockerfile.x86_64-apple-darwin-cross

由于镜像构建过程中会有大量的git clone, curl等网络操作，国内环境需要配置一下代理，在FROM下面一行增加代理信息

ENV HTTP_PROXY=http://*****:**
ENV HTTPS_PROXY=http://{IP}:{端口}
ENV HTTP_PROXY=http://*****:**
ENV HTTPS_PROXY=http://{IP}:{端口}

修改MACOS_SDK_URL参数改为

ARG MACOS_SDK_URL="https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.3.sdk.tar.xz"
ARG MACOS_SDK_URL="https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.3.sdk.tar.xz"

docker组件依赖 ​

交叉编译需要使用到docker buildx，这个非常重要，是能够打包新cross docker镜像的关键，由于buildx还处于实验期，一直不是很稳定，所以需要配置docker开启该功能

修改~/.docker/config.json，增加一行

json
{
	...
	"experimental": "enabled"
	...
}
{
	...
	"experimental": "enabled"
	...
}

校验是否启用， 如下，Experimental： true表示配置成功

shell
$ docker version
Client: Docker Engine - Community
 Version:           20.10.17
 API version:       1.41
 Go version:        go1.17.11
 Git commit:        100c701
 Built:             Mon Jun  6 23:02:57 2022
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true
$ docker version
Client: Docker Engine - Community
 Version:           20.10.17
 API version:       1.41
 Go version:        go1.17.11
 Git commit:        100c701
 Built:             Mon Jun  6 23:02:57 2022
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

检查buildx版本

shell
$ docker buildx version
github.com/docker/buildx v0.** ***********
$ docker buildx version
github.com/docker/buildx v0.** ***********

开始构建，构建完成之后会生成一个镜像aarch64-apple-darwin-cross:local

shell
$ cargo build-docker-image aarch64-apple-darwin-cross --tag local
$ cargo build-docker-image aarch64-apple-darwin-cross --tag local

如果遇到报错，如下，看提示和建议信息好像是说buildx未被安装，解决方案也是配置环境变量CROSS_CONTAINER_ENGINE_NO_BUILDKIT=1不使用buildx

error: failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: unexpected status code [manifests 20.04]: 403 Forbidden
......
Location:
   /rustc/90c541806f23a127002de5b4038be731ba1458ca/library/core/src/convert/mod.rs:727

Warning: call to docker failed
Suggestion: is `buildx` available for the container engine?
Note: disable the `buildkit` dependency optionally with `CROSS_CONTAINER_ENGINE_NO_BUILDKIT=1`
error: failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: unexpected status code [manifests 20.04]: 403 Forbidden
......
Location:
   /rustc/90c541806f23a127002de5b4038be731ba1458ca/library/core/src/convert/mod.rs:727

Warning: call to docker failed
Suggestion: is `buildx` available for the container engine?
Note: disable the `buildkit` dependency optionally with `CROSS_CONTAINER_ENGINE_NO_BUILDKIT=1`

这个时候要淡定，不接受他的建议

先尝试去访问buildx仓库如下，获取最新的一个release版本

https://github.com/docker/buildx
https://github.com/docker/buildx

比如现在获取到的最新的buildx的下载链接

https://github.com/docker/buildx/releases/download/v0.11.0/buildx-v0.11.0.linux-amd64
https://github.com/docker/buildx/releases/download/v0.11.0/buildx-v0.11.0.linux-amd64

下载之后按照buildx仓库readme的提示，替换原来的docker-buildx

linux的docker plugin的可能位置有

  • /usr/local/lib/docker/cli-plugins OR /usr/local/libexec/docker/cli-plugins
  • /usr/lib/docker/cli-plugins OR /usr/libexec/docker/cli-plugins

像我的Ubuntu22机器就是执行如下命令

$ sudo mv buildx-v0.11.0.linux-amd64 /usr/libexec/docker/cli-plugins/docker-buildx
$ sudo chmod a+x /usr/libexec/docker/cli-plugins/docker-buildx
$ sudo mv buildx-v0.11.0.linux-amd64 /usr/libexec/docker/cli-plugins/docker-buildx
$ sudo chmod a+x /usr/libexec/docker/cli-plugins/docker-buildx

执行完成之后再检查buildx版本，一般buildx运行的时候是会遇到很多问题的，该工具也还在实验中，也一直在不断进行更新修复，所以使用最新版本大概率可以解决问题

$ docker buildx version
github.com/docker/buildx v0.11.0 687feca9e8dcd1534ac4c026bc4db5a49de0dd6e
$ docker buildx version
github.com/docker/buildx v0.11.0 687feca9e8dcd1534ac4c026bc4db5a49de0dd6e

最后再次执行镜像构建

$ cargo build-docker-image aarch64-apple-darwin-cross --tag local
$ cargo build-docker-image aarch64-apple-darwin-cross --tag local

如果还是报错再接受建议，执行命令如下，不使用buildx

$ CROSS_CONTAINER_ENGINE_NO_BUILDKIT=1 cargo build-docker-image aarch64-apple-darwin-cross --tag local
$ CROSS_CONTAINER_ENGINE_NO_BUILDKIT=1 cargo build-docker-image aarch64-apple-darwin-cross --tag local

创建Cross.toml

toml
[target.aarch64-apple-darwin]
image = "ghcr.io/cross-rs/aarch64-apple-darwin-cross:local"
[target.aarch64-apple-darwin]
image = "ghcr.io/cross-rs/aarch64-apple-darwin-cross:local"

执行命令如下就完成交叉编译了

shell
$ cross build --target aarch64-apple-darwin -r
$ cross build --target aarch64-apple-darwin -r

参考阅读 ​

cross官方github readme

Last updated:

Released under the MIT License.

Copyright © 2023 gongzhengyang