clang在编译时指定目标文件所需的最低macOS版本
阅读原文时间:2023年07月08日阅读:3

调研这个的原因,是因为有个同事在macOS 12.2上打包好的程序,放在macOS 10.15上运行时报错:

Dyld Error Message:
  Symbol not found: __ZNKSt3__115basic_stringbufIcNS_11char_traitsIcEENS_9allocatorIcEEE3strEv
  Referenced from: /Library/Application Support/XXX.dylib (which was built for Mac OS X 12.2)
  Expected in: /usr/lib/libc++.1.dylib

调研了一番,发现这个是因为Apple的SDK使用weak linking来支持不同版本的macOS。

目标文件所需的最低macOS版本有个专有名称“deployment target”。

查看库的deployment target

查看*.dylib、*.a或者主程序的deployment target属性、sdk版本:

otool -l 7z.dylib | grep -E "(minos|sdk)"
find . -name "*.a" | xargs otool -l | grep -E "(minos|sdk)"

通过命令行参数设置deployment target

clang/clang++在编译时指定deployment target的命令行参数是-mmacos-version-min,比如:-mmacos-version-min=10.15,指定最低为Catalina的最后一个版本10.15。

针对iOS等有类似的开关如-miphoneos-version-min、-mtvos-version-min、 -mwatchos-version-min。

-mmacos-version-min有个别名-mmacosx-version-min,别名只是为了兼容,尽量不使用这个别名。

clang会根据这个命令行参数来定义编译器内置宏MAC_OS_X_VERSION_MIN_REQUIRED等,而SDK头文件中有对这些宏的检查,根据宏决定哪些符号采用weak linking。weak linking的符号在编译时不会报错,dylib加载时也不会报错,在用到对应的符号时如果不存在才会报错。

通过环境变量设置deployment target

clang的这个参数也可通过环境变量来设置。命令行参数优先于环境变量。

MACOSX_DEPLOYMENT_TARGET

IPHONEOS_DEPLOYMENT_TARGET

TVOS_DEPLOYMENT_TARGET

WATCHOS_DEPLOYMENT_TARGET

DRIVERKIT_DEPLOYMENT_TARGET

我们的工程以及我们的工程所直接/间接依赖的所有静态库/动态库,都需要在编译时指定相同的deployment target。

省事的办法是通过环境变量来统一设置,在开始整个打包之前设置一下。

其次是命令行开关。不同工程类型的命令行开关设置方法有差异。以下是命令行开关的设置。

通过vcpkg install编译的库

需要更改vcpkg/triplets/x64-osx.cmake文件的内容,增加下面三行(理论上只要第一行即可,但vcpkg目前貌似有bug,导致VCPKG_OSX_DEPLOYMENT_TARGET只对CMake工程生效,对其他类型的工程不生效。所以需要第二行、第三行):

set(VCPKG_OSX_DEPLOYMENT_TARGET "10.15")

set(VCPKG_C_FLAGS -mmacosx-version-min=10.15)

set(VCPKG_CXX_FLAGS -mmacosx-version-min=10.15)

也可以复制这个文件到某个目录下,在复制出来的文件中增加上面这三行,然后给vcpkg install传递--overlay-triplets参数以使用这个修改过的triplet文件。这样通过vcpkg install安装的所有库的deployment target都是10.15。

autoconf类型的工程

比如libiconv库是手动执行autoconf编译的,需要在configure时增加参数:

./configure CFLAGS=-mmacos-version-min=10.15 CPPFLAGS=-mmacos-version-min=10.15

CMake工程

在CMakeLists.txt里的project()语句之前增加一句:

set(CMAKE_OSX_DEPLOYMENT_TARGET "10.15")

或者

set(CMAKE_OSX_DEPLOYMENT_TARGET "10.15" CACHE STRING "" FORCE)

Xcode工程

在界面的工程属性中可以设置deployment target。

Makefile工程

在makefile里自行给clang传递参数-mmacos-version-min=10.15即可。