clang在编译时指定目标文件所需的最低macOS版本
调研这个的原因,是因为有个同事在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头文件<AvailabilityMacros.h>、<Availability.h>中有对这些宏的检查,根据宏决定哪些符号采用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即可。