在 macOS 上跨平台编译 Rust 应用程序至 Linux 和 Windows

在 macOS 上跨平台编译 Rust 应用程序至 Linux 和 Windows

在 Rust 开发中,能够从单一开发环境(如 macOS)为不同操作系统生成可执行文件是一项强大且实用的技能。本文将指导您如何在 macOS 系统上分别构建适用于 Linux 和 Windows 的 Rust 应用程序,并介绍两种主要的实现方法。

第一种方式:本地安装依赖并编译

编译为 Linux 可执行文件

  1. 安装 Musl Cross-Compiler: 利用 Homebrew 安装 Musl 交叉编译器套件以支持在 macOS 上为 Linux 构建。

    bash 复制代码
    brew install FiloSottile/musl-cross/musl-cross
  2. 配置 Rust 目标平台 : 使用 rustup 添加 x86_64 架构 Linux(基于 Musl C 库)的目标平台。

    bash 复制代码
    rustup target add x86_64-unknown-linux-musl
  3. 项目链接器设置 : 在项目的 .cargo/config.toml 文件中指定 Musl 链接器路径。

    toml 复制代码
    [target.x86_64-unknown-linux-musl]
    linker = "x86_64-linux-musl-gcc"
  4. 构建 Linux 版本项目: 执行以下命令进行编译,生成适用于 Linux 的 release 版本可执行文件。

    bash 复制代码
    cargo build --release --target x86_64-unknown-linux-musl

编译为 Windows 可执行文件

针对 Windows 平台,我们需要借助 cargo-xwin 工具及 LLVM 组件:

  1. 安装 cargo-xwin : 使用 cargo 命令行工具安装 cargo-xwin 插件。

    bash 复制代码
    cargo install cargo-xwin
  2. 安装 LLVM: 通过 Homebrew 获取 LLVM,确保 Windows 目标编译所需组件已就绪。

    bash 复制代码
    brew install llvm
  3. 更新环境变量 : 将 LLVM bin 目录添加到系统 PATH 中,使 cargo-xwin 能找到相关工具。

    bash 复制代码
    export PATH="/opt/homebrew/Cellar/llvm/17.0.6/bin:$PATH"
    source ~/.zshrc
  4. 添加 Windows 目标平台 : 使用 rustup 添加支持 x86_64 架构 Windows(使用 MSVC 工具链)的目标平台。

    bash 复制代码
    rustup target add x86_64-pc-windows-msvc
  5. 构建 Windows 版本项目 : 运行 cargo-xwin 来完成 Windows 版本的编译工作。

    bash 复制代码
    cargo xwin build --release --target x86_64-pc-windows-msvc

第二种方式:利用 cross 工具简化跨平台编译流程

使用 cross 实现 Docker 容器内编译

cross-rs/cross 是一个通过 Docker 容器技术优化跨平台编译过程的强大工具。其工作原理概括如下:

  1. 准备容器环境 : 根据目标平台(Linux 或 Windows),cross 自动下载或创建包含对应平台构建工具链、Rust 工具和必要库的 Docker 镜像。

  2. 挂载源代码至容器 : 当运行 cross 命令时,会自动将本地项目源码目录映射到 Docker 容器内部。

  3. 容器内部编译cross 根据目标平台在容器内部调用相应的 Rust 工具链进行编译。

  4. 同步结果至主机: 编译完成后,生成的二进制文件存储于容器内的特定路径,并通过 Docker 卷映射功能回传至宿主 macOS 系统。

使用 cross 进行编译步骤

首先,通过 Cargo 安装 cross

bash 复制代码
cargo install cross

然后,在项目根目录下配置 Cross.toml 文件,考虑到国内网络问题,可以自定义镜像地址:

toml 复制代码
[target.x86_64-unknown-linux-gnu]
xargo = false
image = "togettoyou/ghcr.io.cross-rs.x86_64-unknown-linux-gnu:main"

[target.x86_64-pc-windows-gnu]
xargo = false
image = "togettoyou/ghcr.io.cross-rs.x86_64-pc-windows-gnu:main"

最后,运行 cross 命令编译 Windows 版本应用:

bash 复制代码
cross build -r --target x86_64-pc-windows-gnu

成功编译后,可在项目 target 目录下找到相应平台的可执行文件。

参考资料:

相关推荐
蟾宫曲2 小时前
在 Vue3 项目中实现计时器组件的使用(Vite+Vue3+Node+npm+Element-plus,附测试代码)
前端·npm·vue3·vite·element-plus·计时器
秋雨凉人心2 小时前
简单发布一个npm包
前端·javascript·webpack·npm·node.js
liuxin334455662 小时前
学籍管理系统:实现教育管理现代化
java·开发语言·前端·数据库·安全
qq13267029402 小时前
运行Zr.Admin项目(前端)
前端·vue2·zradmin前端·zradmin vue·运行zradmin·vue2版本zradmin
海绵波波1072 小时前
flask后端开发(10):问答平台项目结构搭建
后端·python·flask
网络风云3 小时前
【魅力golang】之-反射
开发语言·后端·golang
魏时烟3 小时前
css文字折行以及双端对齐实现方式
前端·css
Q_19284999063 小时前
基于Spring Boot的电影售票系统
java·spring boot·后端
2401_882726484 小时前
低代码配置式组态软件-BY组态
前端·物联网·低代码·前端框架·编辑器·web
web130933203984 小时前
ctfshow-web入门-文件包含(web82-web86)条件竞争实现session会话文件包含
前端·github