MacOS Qt应用打包

一.简介

在MacOS上打包带图形的界面，一定是从Bundle创建的，这个Bundle就像是Apk，里面包含了代码，包含库和资源文件等等。

如果自己创建一个QT工程，用的是.pro文件，这个文件会自带这个Bundle属性，保险起见也可以这样加上：

CONFIG+=app_bundle

如果没有Bundle，会编译不出后面要用到的.app。用CMakeLists.txt 需要自行配置Bundle： 

add_executable(example
        # 重要的是下面这行
        MACOSX_BUNDLE
        ${SRC_LIST}
        ${SRC_COMMON_LIST}
        ${SRC_TEST_LIST}
        ${QRC_FILES}
        main.cpp
    )
# 这些都是设置版本号，名字啥的
set_target_properties(example PROPERTIES
    BUNDLE True
    MACOSX_BUNDLE_GUI_IDENTIFIER example
    MACOSX_BUNDLE_BUNDLE_NAME "example"
    MACOSX_BUNDLE_BUNDLE_VERSION "0.1"
    MACOSX_BUNDLE_SHORT_VERSION_STRING "0.1"
    # 这个plist.in是从QT摘抄出来的，主要是对macos应用配置一类的吧，我也把它复制到下面了
    MACOSX_BUNDLE_INFO_PLIST ./MacOSXBundleInfo.plist.in
)

MacOSXBundleInfo.plist.in ： 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>CFBundleDevelopmentRegion</key>
	<string>English</string>
	<key>CFBundleExecutable</key>
	<string>${MACOSX_BUNDLE_EXECUTABLE_NAME}</string>
	<key>CFBundleGetInfoString</key>
	<string>${MACOSX_BUNDLE_INFO_STRING}</string>
	<key>CFBundleIconFile</key>
	<string>${MACOSX_BUNDLE_ICON_FILE}</string>
	<key>CFBundleIdentifier</key>
	<string>${MACOSX_BUNDLE_GUI_IDENTIFIER}</string>
	<key>CFBundleInfoDictionaryVersion</key>
	<string>6.0</string>
	<key>CFBundleLongVersionString</key>
	<string>${MACOSX_BUNDLE_LONG_VERSION_STRING}</string>
	<key>CFBundleName</key>
	<string>${MACOSX_BUNDLE_BUNDLE_NAME}</string>
	<key>CFBundlePackageType</key>
	<string>APPL</string>
	<key>CFBundleShortVersionString</key>
	<string>${MACOSX_BUNDLE_SHORT_VERSION_STRING}</string>
	<key>CFBundleSignature</key>
	<string>????</string>
	<key>CFBundleVersion</key>
	<string>${MACOSX_BUNDLE_BUNDLE_VERSION}</string>
	<key>CSResourcesFileMapped</key>
	<true/>
	<key>NSHumanReadableCopyright</key>
	<string>${MACOSX_BUNDLE_COPYRIGHT}</string>
</dict>
</plist>

二.打包

先在QT里面选择Release版本，编译一下，完了进入build目录，正常来说会在buile目录看到一个example.app的文件，如果没有，只有一个可执行文件，就是没设置Bundle。

首先执行：

~/Qt/5.15.2/clang_64/bin/macdeployqt example.app

这个工程会把example用到的资源文件、三方库都拷贝到example.app/Contents/，然后三方库就会放在example.app/Contents/Frameworks/ 下。

具体到我们的应用，它会把一些三方库都帮我们拷贝到Frameworks下：

然后重要的来了，就是调整库的依赖结构，用”otool -L ” 可以看到程序或者其它库的依赖库情况：
比如，看example的： 

otool -L example.app/Contents/MacOS/example

 就会把它的依赖库的路径都列出来了，如果有些三方库，比如libopus.dylib是指向/usr/lib/的，就要手动改过来，不然运行的时候它会跑到系统目录去找，在其他人的环境就会出现问题，如果是一些公共库的比如libc++.1.dylib 这种就没啥问题了。

上图是example的库依赖，这里用macdeployqt 执行完后还是比较完善的，路径都没啥问题，不需要去改。

但如果这样直接打包，完了之后运行dmg可能还是会报错：

这个问题困扰了好一段时间，明明上面列出来的路径都是对的，但总是还会去系统路径找，百思不得其解。后来看文档说otool 还能看库的依赖，然后去列了图中的libavformat.58.dylib:

otool -L example.app/Contents/Frameworks/libavformat.58.dylib

才发现这里的路径有些是系统的，这样就得一个个改了 

install_name_tool -change "/usr/local/Cellar/ffmpeg/4.4_1/lib/libswresample.3.dylib" "@executable_path/../Frameworks/libswresample.3.dylib" example.app/Contents/Frameworks/libavformat.58.dylib 

这个install_name_tool是MacOS专门用来改依赖库的。
还有不少库是这样的，都得改回来，改完之后再重新打包：

~/Qt/5.15.2/clang_64/bin/macdeployqt example.app -dmg

这样打出来的包就能在其它MAC电脑用了。