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 ： 

	CFBundleDevelopmentRegion
	English
	CFBundleExecutable
	${MACOSX_BUNDLE_EXECUTABLE_NAME}
	CFBundleGetInfoString
	${MACOSX_BUNDLE_INFO_STRING}
	CFBundleIconFile
	${MACOSX_BUNDLE_ICON_FILE}
	CFBundleIdentifier
	${MACOSX_BUNDLE_GUI_IDENTIFIER}
	CFBundleInfoDictionaryVersion
	6.0
	CFBundleLongVersionString
	${MACOSX_BUNDLE_LONG_VERSION_STRING}
	CFBundleName
	${MACOSX_BUNDLE_BUNDLE_NAME}
	CFBundlePackageType
	APPL
	CFBundleShortVersionString
	${MACOSX_BUNDLE_SHORT_VERSION_STRING}
	CFBundleSignature
	????
	CFBundleVersion
	${MACOSX_BUNDLE_BUNDLE_VERSION}
	CSResourcesFileMapped
	
	NSHumanReadableCopyright
	${MACOSX_BUNDLE_COPYRIGHT}

二.打包

先在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电脑用了。