osxcross 搭建 macOS 交叉编译环境

knowledgebao2025-04-23 12:59

1. osxcross 搭建 macOS 交叉编译环境

  • [1. osxcross 搭建 macOS 交叉编译环境](#1. osxcross 搭建 macOS 交叉编译环境)
    • [1.1. 安装依赖](#1.1. 安装依赖)
    • [1.2. 安装 osxcross 及 macOS SDK](#1.2. 安装 osxcross 及 macOS SDK)
      • [1.2.1. 可能错误](#1.2.1. 可能错误)
    • [1.3. 编译 cmake 类工程](#1.3. 编译 cmake 类工程)
    • [1.4. 编译 configure 类工程](#1.4. 编译 configure 类工程)
    • [1.5. 单文件编译及其他环境编译](#1.5. 单文件编译及其他环境编译)
    • [1.6. 打包成 docker 镜像](#1.6. 打包成 docker 镜像)
    • [1.7. 使用 docker 编译 cmake 工程](#1.7. 使用 docker 编译 cmake 工程)

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

1.1. 安装依赖

shell 复制代码 
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下载

shell 复制代码 
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

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

shell 复制代码 
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 重新打包
shell 复制代码 
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 指定即可
shell 复制代码 
# 设置系统名称
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)

编译时指定工具链文件：

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

1.4. 编译 configure 类工程

shell 复制代码 
#!/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. 单文件编译及其他环境编译

c 复制代码 
#include <stdio.h>

void hello() {
    printf("Hello from the library!\n");
}
shell 复制代码 
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

其它工程编译

shell 复制代码 
# 配置交叉编译环境, 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 查看镜像是否生成成功
shell 复制代码 
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 脚本内容参考如下
shell 复制代码 
# 修改 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
  • 上边的脚本用到了本地的 toolchain-mac.cmake 文件，内容如下, 位置可以随便放，在 build.sh 中设置即可
  • 这个文件没有放在 docker 镜像中，而是在宿主机上，这样可以直接修改，不用重新构建 docker 镜像，也可以直接使用本地的 osxcross 环境
shell 复制代码 
# 设置系统名称
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 等编译工具即可

相关推荐
V丶Chao4 小时前
VSCode安装与环境配置（Mac环境）
ide·vscode·macos
cmoaciopm5 小时前
MacOS 10.15上能跑大语言模型吗？
人工智能·macos
大米饭6618 小时前
解决Mac 安装 PyICU 依赖失败
macos·ragflow
我该如何取个名字18 小时前
Mac配置Java的环境变量
java·开发语言·macos
黑心老人19 小时前
Mac OS系统下kernel_task占用大量CPU资源导致系统卡顿
linux·运维·服务器·macos
我的代码永没有bug19 小时前
day1-小白学习JAVA---JDK安装和环境变量配置（mac版）
java·学习·macos
孤寂码农_defector1 天前
鸿蒙系统的 “成长烦恼“：生态突围与技术迭代的双重挑战
macos·华为·objective-c·cocoa·harmonyos
方始终_1 天前
亲测有效，如何macOS上卸载并且重新安装homeBrew
前端·后端·macos
依旧风轻1 天前
iOS 冷启动时间监控：启动起点有哪些选择？
macos·ios·cocoa·sqi·coldstart
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03我决定放弃搞 Java 了04YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】05DeepSeek各版本说明与优缺点分析06RAG 实践- Ollama+RagFlow 部署本地知识库07yolov8，yolo11，yolo12 服务器训练到部署全流程 笔记08苍穹外卖面试总结09如何在WPS和Word/Excel中直接使用DeepSeek功能10组基轨迹建模 GBTM的介绍与实现（Stata 或 R）