ubuntu 交叉编译 macOS 库, 使用 osxcross 搭建 docker 编译 OS X 库

原创 已于 2025-04-24 21:20:47 修改
· 1.2k 阅读 · 21 ·
版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#macos #策略模式

于 2025-04-22 20:13:42 首次发布

1. ubuntu 交叉编译 macOS 库, 使用 osxcross 搭建 docker 编译 OS X 库

你可以使用osxcross工具来搭建适用于 macOS 的交叉编译环境，下边以 ubuntu22.04 为例，演示如何搭建 macOS 交叉编译环境。

1.1. 安装依赖

sudo apt-get update
sudo apt-get install -y clang llvm-dev libxml2-dev uuid-dev libssl-dev make cmake zlib1g-dev xz-utils git wget

1.2. 安装 osxcross 及 macOS SDK

具体 macOS SDK版本取决于你的需求，你可以从MacOSX-SDKs下载

git clone https://github.com/tpoechtrager/osxcross.git
cd osxcross

# 下载Mac OS X SDK
wget -nc https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.3.sdk.tar.xz
mv MacOSX11.3.sdk.tar.xz tarballs/

# UNATTENDED 表示是否静默安装
# OSX_VERSION_MIN 表示最低支持的 macOS 版本
# SDK_VERSION 表示 macOS SDK 版本, 可以不指定默认从 tarballs 目录中选择
# 编译结束后，会在 target 目录下生成交叉编译工具，target/bin 目录下包含 clang 和 clang++ 等交叉编译工具
SDK_VERSION=11.3 UNATTENDED=yes OSX_VERSION_MIN=10.7 ./build.sh

设置环境变量，以便在终端中使用交叉编译工具：

export PATH=$PATH:/data/code/osxcross/target/bin/

1.2.1. 可能错误

  • 使用 MacOS11.0 的时候出现报错，Given SDK does not contain libc++ headers (-stdlib=libc++ test may fail)
    • 表明你所使用的 Mac OS X SDK 里缺少 libc++ 头文件,使用 tools/gen_sdk_package.sh 脚本在 macOS 系统上重新打包 SDK
    1. 你得有一台可用的 macOS 设备
    2. 在 macOS 系统上克隆 osxcross 仓库
    3. 将 Mac SDK 重新打包
git clone https://github.com/tpoechtrager/osxcross.git
cd osxcross

wget -nc https://github.com/phracker/MacOSX-SDKs/releases/download/11.0-11.1/MacOSX11.0.sdk.tar.xz
tar -xf MacOSX11.0.sdk.tar.xz

# 重新打包SDK，这样就会包含 libc++ 头文件了
./tools/gen_sdk_package.sh MacOSX11.0.sdk

1.3. 编译 cmake 类工程

  • 注意修改 osxcross 所在目录，下边举例是 /data/code/osxcross
  • 注意 bin 文件的前缀，不同的 MacOS 版本有不同的前缀，比如我的 MacOS11.3 的前缀是 x86_64-apple-darwin20.4
  • 将下边内容写入 toolchain-mac.cmake 文件，编译时通过 CMAKE_TOOLCHAIN_FILE 指定即可
# 设置系统名称
set(CMAKE_SYSTEM_NAME Darwin)
set(CMAKE_SYSTEM_PROCESSOR x86_64)

# 设置交叉编译工具链的路径,注意修改 osxcross 路径，注意工具链前缀
set(TOOLCHAIN_PREFIX /data/code/osxcross/target/bin/x86_64-apple-darwin20.4)

# 替换为你实际的 osxcross 安装路径
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}-clang)
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}-clang++)

# 设置搜索路径，注意修改 osxcross 路径
set(CMAKE_FIND_ROOT_PATH /data/code/osxcross/target/macports/pkgs/opt/local)

# 只在交叉编译环境中搜索库和头文件
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

编译时指定工具链文件：

# 编译时通过 CMAKE_TOOLCHAIN_FILE 指定工具链文件即可
mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-mac.cmake ..

1.4. 编译 configure 类工程

#!/bin/sh
# set -x
CUR_DIR=$(cd "$(dirname "$0")"; pwd)
wget https://download.libsodium.org/libsodium/releases/libsodium-1.0.18.tar.gz

src_pkg=libsodium-1.0.18.tar.gz
dst_dir=libsodium-1.0.18
install_dir=${PWD}/target/

# 删除后,重新解压编译,避免之前的版本对当前版本有影响
rm -rf ${install_dir}/*

platforms=("x86_64" "aarch64")
for platform in "${platforms[@]}"; do
	rm ${dst_dir} -rf
	if [ ! -d ${dst_dir} ] ;then	
		tar xvf ${src_pkg} 
	fi
	cd ${dst_dir}

	# 配置交叉编译环境
	export PATH=$PATH:/data/code/osxcross/target/bin
	export CC=${platform}-apple-darwin20.4-clang
	export CXX=${platform}-apple-darwin20.4-clang++

	# 配置 libsodium 编译选项
	./configure --host=${platform}-apple-darwin20.4 \
				--prefix=${install_dir}/${platform} \
				--with-sysroot=/data/code/osxcross/target/macports/pkgs/opt/local
	# 编译和安装
	make
	make install
	cd -
done

echo "libsodium 1.0.18 编译和安装完成。"

1.5. 单文件编译及其他环境编译

#include <stdio.h>

void hello() {
    printf("Hello from the library!\n");
}

export PATH=$PATH:/data/code/osxcross/target/bin/

# 编译成目标文件
o64-clang -c example.c -o example.o
# 生成静态库
ar rcs libexample.a example.o
# 生成动态库
o64-clang -shared example.c -o libexample.dylib

其它工程编译

# 配置交叉编译环境, platform 可以是 x86_64 或 aarch64 等
export PATH=$PATH:/data/code/osxcross/target/bin
export CC=${platform}-apple-darwin20.4-clang
export CXX=${platform}-apple-darwin20.4-clang++

1.6. 打包成 docker 镜像

  • 为了简单，可以使用 Dockerfile 来搭建交叉编译环境，这样可以避免在宿主机上安装依赖
  • 将下边内容保存为 Dockerfile 文件，然后执行 docker build -t mac_build . 生成镜像，docker images 查看镜像是否生成成功
FROM ubuntu:22.04

# 避免在安装过程中出现交互式提示
ENV DEBIAN_FRONTEND=noninteractive

# 安装必要的依赖
RUN apt-get update && \
    apt-get install -y \
    clang \
    llvm-dev \
    libxml2-dev \
    uuid-dev \
    libssl-dev \
    make \
    cmake \
    zlib1g-dev \
    xz-utils \
    git \
    wget && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

# 克隆 osxcross 仓库
RUN git clone https://github.com/tpoechtrager/osxcross.git /osxcross
WORKDIR /osxcross

# 下载 Mac OS X SDK
RUN wget -nc https://github.com/phracker/MacOSX-SDKs/releases/download/11.3/MacOSX11.3.sdk.tar.xz && \
    mv MacOSX11.3.sdk.tar.xz tarballs/

# 编译 osxcross
ENV SDK_VERSION=11.3
ENV UNATTENDED=yes
ENV OSX_VERSION_MIN=10.7
RUN ./build.sh

# 设置环境变量
ENV PATH=$PATH:/osxcross/target/bin/
  • 可以给 image 打 tag docker tag mac_build:latest xx.cloud.com.cn/mac_build:1.0
  • 也可以上传镜像 docker push xx.cloud.com.cn/mac_build:1.0 当然如果只是本地使用，可以不上传

1.7. 使用 docker 编译 cmake 工程

  • 编译本地 cmake 管理的工程
    • 假设本地工程目录是 /home/xxx/my_project
    • 执行 docker run -it -v /home/xxx/my_project:/my_project mac_build:1.0 build.sh 即可
    • build.sh 脚本内容参考如下
# 修改 MOUNT_DIR、OSXCROSS_PATH 这2个宏，可以使用本地的 mac sdk 环境编译
MOUNT_DIR="/my_project"
OSXCROSS_PATH=/osxcross
MAC_TOOLCHAIN=${MOUNT_DIR}/toolchain-mac.cmake

BUILD_DIR=${MOUNT_DIR}/build
DST_DIR=${MOUNT_DIR}/output

build_mac() {
    SYSTEM_PROCESSOR=$1
    echo "start build for ${SYSTEM_PROCESSOR}..."
    mkdir -p ${DST_DIR}/${SYSTEM_PROCESSOR}
    rm -rf ${BUILD_DIR}
    mkdir -p ${BUILD_DIR}
    cd ${BUILD_DIR}

    cmake -DSYSTEM_PROCESSOR=${SYSTEM_PROCESSOR} -DOSXCROSS_PATH=${OSXCROSS_PATH} -DCMAKE_TOOLCHAIN_FILE=${MAC_TOOLCHAIN} ..
    make

    mv ${BUILD_DIR}/lib/libFFMPEG.a ${DST_DIR}/${SYSTEM_PROCESSOR}/libFFMPEG.a
    mv ${BUILD_DIR}/lib/libFFMPEG.dylib ${DST_DIR}/${SYSTEM_PROCESSOR}/libFFMPEG.dylib

    echo "build for ${SYSTEM_PROCESSOR} success"
    echo "----------------------------------------"
}

build_mac aarch64
build_mac x86_64

# 创建 universal 通用库
lipo -create ${DST_DIR}/aarch64/libFFMPEG.a ${DST_DIR}/x86_64/libFFMPEG.a -output ${DST_DIR}/libFFMPEG.a
lipo -create ${DST_DIR}/aarch64/libFFMPEG.dylib ${DST_DIR}/x86_64/libFFMPEG.dylib -output ${DST_DIR}/libFFMPEG.dylib
# 验证通用库
lipo -info ${DST_DIR}/libFFMPEG.a
lipo -info ${DST_DIR}/libFFMPEG.dylib

rm -rf ${DST_DIR}/aarch64
rm -rf ${DST_DIR}/x86_64

chmod 777 ${DST_DIR} -R

rm -rf ${BUILD_DIR}
  • 上边的脚本用到了本地的 toolchain-mac.cmake 文件，内容如下, 位置可以随便放，在 build.sh 中设置即可
  • 这个文件没有放在 docker 镜像中，而是在宿主机上，这样可以直接修改，不用重新构建 docker 镜像，也可以直接使用本地的 osxcross 环境
# 设置系统名称
set(CMAKE_SYSTEM_NAME Darwin)

if((NOT ${SYSTEM_PROCESSOR} STREQUAL "x86_64") AND (NOT ${SYSTEM_PROCESSOR} STREQUAL "aarch64"))
    message(FATAL_ERROR "Unsupported platform: ${CMAKE_SYSTEM_NAME} ${CMAKE_SYSTEM_PROCESSOR}")
    return()
endif()
set(CMAKE_SYSTEM_PROCESSOR ${SYSTEM_PROCESSOR})

message(STATUS "macOS toolchain: CMAKE_SYSTEM_NAME: ${CMAKE_SYSTEM_NAME}, CMAKE_SYSTEM_PROCESSOR: ${CMAKE_SYSTEM_PROCESSOR}, OSXCROSS_PATH: ${OSXCROSS_PATH}")

# 设置交叉编译工具链的路径
set(TOOLCHAIN_PREFIX ${OSXCROSS_PATH}/target/bin/${CMAKE_SYSTEM_PROCESSOR}-apple-darwin20.4)

# 替换为你实际的 osxcross 安装路径
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}-clang)
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}-clang++)

# 设置搜索路径
set(CMAKE_FIND_ROOT_PATH ${OSXCROSS_PATH}/target/macports/pkgs/opt/local)

# 只在交叉编译环境中搜索库和头文件
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

其他工程类似，只需要导出对应的 CC/CXX/LD/STRIP 等编译工具即可

knowledgebao
关注
macOS与Ubuntu虚拟机使用SSH文件互传
09-24 651
macOS使用scp连接ubuntu并发送文件。
在 Mac OS X 中编译 ClickHouse
AI天才研究院
06-17 8730
ClickHouse 支持在 Mac OS X 10.12 版本中编译。若您在用更早的操作系统版本，可以尝试在指令中使用 Gentoo Prefix 和 clang sl. 通过适当的更改，它应该可以适用于任何其他的 Linux 发行版。 安装 Homebrew $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/H...
ubuntu 远程连接 macos 桌面
Alan_Yao的博客
09-05 1033
要在Ubuntu上远程连接到macOS桌面，可以使用多种方法，包括VNC、RDP和SSH等协议。
最新【云原生 02】分别在CentOS、Ubuntu、macOS(2)，2024年最新大数据开发面试点梳理
2401_84591746的博客
05-16 1848
Next，可能会询问你的 macOS 登陆密码，你输入即可。之后会弹出一个 Docker 运行的提示窗口，状态栏上也有有个小鲸鱼的图标。
2024年最新【云原生 02】分别在CentOS、Ubuntu、macOS，2024年最新阿里P7大牛整理
2401_84160087的博客
05-14 346
hello-world”镜像。（假设它还没有在本地可用。） 3. Docker 引擎守护进程从该镜像创建了一个新容器，该容器运行 生成您当前正在阅读的输出的可执行文件。4. Docker Engine 守护程序将该输出流式传输到 Docker Engine CLI 客户端，后者将其发送 到您的终端。
macOS与Ubuntu困惑解答
zhanly19的博客
04-25 589
参考：https://blog.csdn.net/LuoMin2523/article/details/119215880?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522168243493316800226590237%2522%252C%2522scm%2522%253A%252220140713.130102334…bash读取的配置文件：~/.bash_profile。切换bash：chsh -s /bin/bash。
基于 Docker 为 Android 交叉编译 FFMpeg 动态库
也说安卓
01-22 3137
本文将会介绍：如何在 Docker 下为 Android 编译 FFMpeg 动态库。 1 前言 为什么使用 Docker Docker 相当于一个虚拟机，类似于 Vmware Workstation。使用 Docker 可以充分保证（容器内）环境的一致性，减少不同环境的干扰。 基础概念 镜像（image）：有过装系统经验的应该不难理解， 宿主机（host）： 容器（container）： 交叉编译（cross compile）：通俗点说，是在一个架构的环境下，编译另一个架构下可以运行的目标文件（动态.
MacOS(M1)下创建Docker Ubuntu容器搭建CSAPP实验环境并运行
weixin_52693116的博客
09-21 792
经过查阅资料得知原因是缺少gcc完整的环境，也就是需要再安装gcc-multilib，而它只能用apt-get安装，所以果断换成ubuntu了。打开bits.c，第一个让我们实现的函数功能是位的异或，题目要求运用合法的操作符是～ &，这里我们为了测试是否能在刚搭建好的环境中编译成功且dlc返回结果，简单地让函数返回x^y。其中，-v "/Users/xx/csapp:/csapp"命令是将csapp文件目录与容器目录进行共享，以实现同步，这样我们就可以直接在本机写代码，docker上编译。
Docker搭建树莓派内核编译环境
weixin_46027271的博客
01-23 1834
Docker搭建树莓派内核编译环境
在windows上、Macos、ubuntu上 搭建linux内核0.11版本详细教程与linux0.11内核源码
05-24
搭建Linux内核0.11版本的教程涵盖了在Windows、MacOS和Ubuntu这些主流操作系统上的实践过程。Linux内核0.11是Linux历史上的一个早期版本，它为我们提供了了解操作系统核心工作原理的机会。这个教程可能对软件开发...
在Mac上编译交叉编译器
solan的博客
04-25 2929
许多时候我们是用mac来编程。毕竟mac是正统的BSD的后裔。shell直接就是BSD的shell环境。这样对程序员而言，是天然友好的。 但是现在生产力环境是Linux，mac下编译的东西没发直接在Linux下运行。这个时候，需要有交叉编译器来构造这样的二进制程序，这样在mac下编写、编译的程序，也可以在Linux运行。 可以用crosstool-ng来产生适用于不同Linux平台的交叉编译器。在mac下，可以用如下命令来安装crosstool-ng brew install crosstool-n
如何在MacOS上使用OpenHarmony SDK交叉编译？
maniuT的博客
04-14 1751
本文以cJSON三方库为例介绍如何通过OpenHarmony的SDK在Mac平台进行交叉编译。
Mac OS 安装 CGO 交叉编译环境 x86_64-linux-gnu-gcc
shida's blog
02-22 3536
Mac OS 安装 CGO 交叉编译环境 x86_64-linux-gnu-gcc，解决 CGO 编译难题。
MacOS 13.3.1 连接Ubuntu 21.10 远程桌面
04-11 3246
2. MacOS上安装Microsoft Remote Desktop。4.点击add后,会在面板中出现该远程桌面项。1. ubuntu上开启共享。3.添加远程桌面连接。
【Rust】在mac上交叉编译linux和windows程序（包含Docker实现）
Rei的博客
10-22 6107
Rust在mac上交叉编译
MacOS下aarch64交叉编译工具链制作方法
lirise的博客
08-31 2800
aarch64交叉编译工具链 Mac下交叉编译工具链 AX86U交叉编译工具链
Mac OS 搭建C++开发环境【已解决】
热门推荐
Friday
02-24 1万+
安装VSCode，gcc编译工具，cmake，git，配置完成相关环境，成功编译运行相关项目。
mac os 编译linux内核,在MACOS上实现交叉编译
weixin_39634052的博客
05-09 849
在嵌入式开发过程中，设备的存储空间和运算能力通常会比较低，这时候，比如要编译一个linux的内核，嵌入式设备就不能胜任了，所以，实现交叉编译还是很必要的。通过交叉编译，我们就能够在我们的pc上编译出能够在嵌入式设备上使用的可执行程序。下面，我将一步步讲解如何在MAC OS上实现树莓派(arm)的交叉编译。一。新建一个磁盘映像MAC OS的文件系统默认是大小写不敏感的，而交叉编译工具链是基于大小写敏...
交叉编译 docker
最新发布
03-13
<think>嗯，用户想了解Docker的交叉编译教程和配置方法。首先，我得回忆一下之前处理过的类似问题。交叉编译通常涉及在一个平台上生成另一个平台的可执行文件，比如在x86上编译ARM程序。Docker在这方面很有用，因为它可以创建隔离的环境，包含所需的工具链。 首先，用户可能需要安装Docker，这是基础。然后，选择合适的工具链镜像很重要，比如ARM用的gcc镜像或者Rust的musl镜像。接下来，挂载项目目录到容器里，这样容器内的编译结果可以直接在宿主机上访问。此外，静态编译可能是个关键点，特别是为了减少依赖问题，确保程序在不同系统上运行。 用户提供的引用里提到了使用Docker进行交叉编译的具体步骤，比如Rust的例子，用别名简化命令。可能还要考虑多阶段构建，优化镜像大小。另外，缓存和加速编译的方法也不能少，比如利用volume缓存依赖项。 用户的需求可能包括具体步骤、配置示例和常见问题处理。需要分步骤讲解，确保清晰。可能的问题包括如何选择基础镜像、处理依赖库、静态编译配置等。还要注意不同语言（如C/C++、Rust、Go）的差异，分别给出例子会更全面。 最后，生成相关问题时要覆盖优化方法、常见错误、多平台镜像构建和与虚拟机对比，这样用户能进一步扩展知识。</think>### Docker交叉编译教程与配置方法 #### 一、环境准备 1. **安装Docker** 在宿主机安装Docker引擎，支持Linux/macOS/Windows系统。Linux系统通过包管理器安装，例如Ubuntu： ```bash sudo apt-get update && sudo apt-get install docker.io ``` 验证安装：`docker --version`[^1] 2. **启用多平台支持** 启用Docker的实验性功能以支持多架构镜像构建： ```bash echo '{"experimental": "enabled"}' > ~/.docker/config.json ``` #### 二、交叉编译配置 1. **选择基础镜像** - **C/C++项目**：使用`dockcross`系列镜像，如`dockcross/linux-armv7` - **Rust项目**：使用`ekidd/rust-musl-builder`支持静态编译[^2] - **Go项目**：直接使用多阶段构建（`GOARCH=arm64`） 2. **目录挂载与编译命令** 将本地代码目录挂载到容器内，执行编译操作： ```bash docker run --rm -v "$(pwd)":/workspace dockcross/linux-armv7 bash -c "make" ``` Rust静态编译示例： ```bash alias rust-musl-builder='docker run --rm -it -v "$(pwd)":/home/rust/src ekidd/rust-musl-builder' rust-musl-builder cargo build --release ``` #### 三、多阶段构建优化 通过多阶段构建减小镜像体积： ```Dockerfile # 第一阶段：交叉编译 FROM dockcross/linux-armv7 AS builder COPY . /app RUN make # 第二阶段：生成精简镜像 FROM alpine:latest COPY --from=builder /app/output /usr/local/bin CMD ["/usr/local/bin/app"] ``` #### 四、验证与调试 1. **验证二进制文件架构** ```bash file output_binary # 查看ELF文件头信息 ``` 2. **QEMU模拟测试** 安装QEMU进行目标平台模拟： ```bash docker run --rm --privileged multiarch/qemu-user-static --reset ``` #### 五、典型问题处理 - **依赖库缺失**：在容器内安装目标平台的依赖库（如`apt-get install libssl-dev:armhf`） - **链接器错误**：通过`-static`参数强制静态编译 - **性能优化**：使用`docker buildx`并行构建多平台镜像
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值