1 简介
Shotcut是一个开源的跨平台的视频编辑软件，支持WIN/MACOS/LINUX等平台，由于该项目的编译较为麻烦，踩坑几许，因此写此文章记录完整编译构建过程，后续按此法编译，可减少走弯路，提高生产力。
编译构建环境：
- qt sdk版本 >= 6.4，此文是qt 6.5.3，请自行下载安装，笔者已安装好；
- Shortcut SDK版本23.09.29，universal build；
2 源码下载
源码下载建议不要在github上下载，那不够，建议从官方文档上下载。详情参见第6章。
下载后将shotcut-macos-sdk-230929.txz拷贝到以下home目录，并解压：
按实际Shotcut项目路径修改mlt-framework-7文件内容：
prefix=/Users/mingo/Applications/workspace/av/Shotcut
exec_prefix=${prefix}/build
libdir=${prefix}/Contents/Frameworks
includedir=${prefix}/Contents/Frameworks/include
datadir=${prefix}/build/share
moduledir=${prefix}/lib/mlt
mltdatadir=${datadir}/mlt
Name: mlt-framework
Description: MLT multimedia framework
Version: 7.19.0
Requires:
Libs: -L${libdir} -lmlt-7
Cflags: -I${includedir}/mlt-7
按实际Shotcut项目路径需改mlt++-7文件内容：
prefix=/Users/mingo/Applications/workspace/av/Shotcut
exec_prefix=${prefix}/build
libdir=${prefix}/Contents/Frameworks
includedir=${prefix}/Contents/Frameworks/include
datadir=${prefix}build/share
Name: mlt++
Description: C++ API for MLT multimedia framework
Version: 7.19.0
Requires: mlt-framework-7
Libs: -L${libdir} -lmlt++-7
Cflags: -I${includedir}/mlt-7/mlt++
在Shotcut项目路径建立软链接：
# 建立软连接
mingo@localhost:~/Applications/workspace/av$ ln -s Shotcut Shotcut.app
drwxr-xr-x@ 4 mingo staff 128 9 30 2023 Shotcut/
lrwxr-xr-x 1 mingo staff 7 5 28 15:42 Shotcut.app@ -> Shotcut
接下来就是qt creator上的配置了。
3 qt creator配置
按如下图配置：
遇到问题：
-- Checking for module 'fftw3'
-- No package 'fftw3' found
-- Checking for module 'fftw'
-- No package 'fftw' found
CMake Error at /opt/homebrew/Cellar/cmake/3.26.0/share/cmake/Modules/FindPkgConfig.cmake:607 (message):
A required package was not found
问题原因：以下目录缺失fftw3.pc文件.
mingo@localhost:~/Applications/workspace/av/Shotcut/Contents/Frameworks/lib/pkgconfig$tree -L 1
.
├── fftw3.pc
├── frei0r.pc
├── frei0r.pc.bak
├── libavcodec.pc
├── libavcodec.pc.bak
├── libavdevice.pc
├── libavdevice.pc.bak
├── libavfilter.pc
├── libavfilter.pc.bak
├── libavformat.pc
├── libavformat.pc.bak
├── libavutil.pc
├── libavutil.pc.bak
├── libpostproc.pc
├── libpostproc.pc.bak
├── libswresample.pc
├── libswresample.pc.bak
├── libswscale.pc
├── libswscale.pc.bak
├── libvmaf.pc
├── libvmaf.pc.bak
├── mlt++-7.pc
├── mlt++-7.pc.bak
├── mlt-framework-7.pc
├── mlt-framework-7.pc.bak
├── movit.pc
├── movit.pc.bak
├── opencv4.pc
├── opencv4.pc.bak
├── vidstab.pc
└── vidstab.pc.bak
1 directory, 31 files
在以上目录下创建fftw.pc文件，并输出以下内容：
prefix=/Users/mingo/Applications/workspace/av/Shotcut
exec_prefix=${prefix}/build
libdir=${prefix}/Contents/Frameworks
includedir=${prefix}/Contents/Frameworks/include
datadir=${prefix}build/share
Name: fftw3-3
Description: fftw3.3.10
Version: 3.3.10
Requires: fftw3.3
Libs: -L${libdir} -lfftw3.3
Cflags: -I${includedir}/fftw3
然后，在以下include目录下创建fftw3目录，并把相关头文件放入其中：
mingo@localhost:~/Applications/workspace/av/Shotcut/Contents/Frameworks/include$tree -L 1
.
├── fftw3
├── frei0r.h
├── ladspa.h
├── libavcodec
├── libavdevice
├── libavfilter
├── libavformat
├── libavutil
├── libpostproc
├── libswresample
├── libswscale
├── libvmaf
├── mlt-7
├── movit
├── opencv4
└── vid.stab
15 directories, 2 files
fftw3的头文件就放在fftw3目录下。具体头文件来源请参加下一节。
3.1 build配置
CMake的配置截图如下：
CMake => Kit configuration => current configuration 文字描述如下：
CMAKE_INSTALL_PREFIX => /Users/mingo/Applications/workspace/av
CMAKE_INSTALL_RPATH => @executable_path/../Frameworks
CMAKE_INSTALL_RPATH_USE_LINK_PATH => ON
然后在 CMake => Kit configuration => initial configuration 页面按如下配置：
上图option的文字描述如下，方便拷贝：
-DCMAKE_INSTALL_PREFIX=/Users/mingo/Applications/workspace/av -DCMAKE_INSTALL_RPATH=@executable_path/../Frameworks -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=ON
最后在此指定pkg config的路径：
老规矩，文字描述如下，方便copy：
PKG_CONFIG_PATH => /Users/mingo/Applications/workspace/av/Shotcut/Contents/Frameworks/lib/pkgconfig
3.2 run配置
完整配置参见下图：
截图不方便copy，因此贴于此处：
Executable => /Users/mingo/Applications/workspace/av/Shotcut/Contents/MacOS/Shotcut
QTDIR => /Users/mingo/Applications/workspace/tools/qt5.15.2/6.5.3/macos
QT_PLUGIN_PATH => /Users/mingo/Applications/workspace/tools/qt5.15.2/6.5.3/macosplugins
QML2_IMPORT_PATH => ${QTDIR}/qml
4 安装fftw3
由于下载后的工程里没有fftw相关头文件和lib文件，需要另外设法搞到。执行以下命令安装fftw，arm64下缺省安装在**/opt/homebrew/Cellar/fftw/3.3.10_1/**下：
brew install fftw
这一步骤如果报错，请按报错指引安装即可。安装完毕后相关的文件在以下目录：
mingo@localhost:~/Applications/workspace/av/Shotcut/Contents/MacOS$tree -L 2 /opt/homebrew/Cellar/fftw/3.3.10_1/
/opt/homebrew/Cellar/fftw/3.3.10_1/
├── AUTHORS
├── COPYING
├── COPYRIGHT
├── ChangeLog
├── INSTALL_RECEIPT.json
├── NEWS
├── README
├── TODO
├── bin
│ ├── fftw-wisdom
│ ├── fftw-wisdom-to-conf
│ ├── fftwf-wisdom
│ └── fftwl-wisdom
├── include
│ ├── fftw3-mpi.f03
│ ├── fftw3-mpi.h
│ ├── fftw3.f
│ ├── fftw3.f03
│ ├── fftw3.h
│ ├── fftw3l-mpi.f03
│ ├── fftw3l.f03
│ └── fftw3q.f03
├── lib
│ ├── cmake
│ ├── libfftw3.3.dylib
│ ├── libfftw3.a
│ ├── libfftw3.dylib -> libfftw3.3.dylib
│ ├── libfftw3_mpi.3.dylib
│ ├── libfftw3_mpi.a
│ ├── libfftw3_mpi.dylib -> libfftw3_mpi.3.dylib
│ ├── libfftw3_omp.3.dylib
│ ├── libfftw3_omp.a
│ ├── libfftw3_omp.dylib -> libfftw3_omp.3.dylib
│ ├── libfftw3_threads.3.dylib
│ ├── libfftw3_threads.a
│ ├── libfftw3_threads.dylib -> libfftw3_threads.3.dylib
│ ├── libfftw3f.3.dylib
│ ├── libfftw3f.a
│ ├── libfftw3f.dylib -> libfftw3f.3.dylib
│ ├── libfftw3f_mpi.3.dylib
│ ├── libfftw3f_mpi.a
│ ├── libfftw3f_mpi.dylib -> libfftw3f_mpi.3.dylib
│ ├── libfftw3f_omp.3.dylib
│ ├── libfftw3f_omp.a
│ ├── libfftw3f_omp.dylib -> libfftw3f_omp.3.dylib
│ ├── libfftw3f_threads.3.dylib
│ ├── libfftw3f_threads.a
│ ├── libfftw3f_threads.dylib -> libfftw3f_threads.3.dylib
│ ├── libfftw3l.3.dylib
│ ├── libfftw3l.a
│ ├── libfftw3l.dylib -> libfftw3l.3.dylib
│ ├── libfftw3l_mpi.3.dylib
│ ├── libfftw3l_mpi.a
│ ├── libfftw3l_mpi.dylib -> libfftw3l_mpi.3.dylib
│ ├── libfftw3l_omp.3.dylib
│ ├── libfftw3l_omp.a
│ ├── libfftw3l_omp.dylib -> libfftw3l_omp.3.dylib
│ ├── libfftw3l_threads.3.dylib
│ ├── libfftw3l_threads.a
│ ├── libfftw3l_threads.dylib -> libfftw3l_threads.3.dylib
│ └── pkgconfig
├── sbom.spdx.json
└── share
├── info
└── man
9 directories, 57 files
然后进入到Shotcut的安装目录下，执行如下命令，将dylib库copy到Frameworks目录下：
cd /Users/mingo/Applications/workspace/av/Shotcut/Contents/Frameworks
cp /opt/homebrew/Cellar/fftw/3.3.10_1/lib/libfftw3.3.dylib ./
拷贝include文件到以下安装目录：
cp /opt/homebrew/Cellar/fftw/3.3.10_1/include/* ./
mingo@localhost:~/Applications/workspace/av/Shotcut/Contents/Frameworks/include/fftw3$tree -L 1
.
├── fftw3-mpi.f03
├── fftw3-mpi.h
├── fftw3.f
├── fftw3.f03
├── fftw3.h
├── fftw3l-mpi.f03
├── fftw3l.f03
└── fftw3q.f03
1 directory, 8 files
5 编译运行
链接时报错fftw3库找不到：
解决办法：
确保fftw.pc文件按以下书写正确：
prefix=/Users/mingo/Applications/workspace/av/Shotcut
exec_prefix=${prefix}/build
libdir=${prefix}/Contents/Frameworks
includedir=${prefix}/Contents/Frameworks/include
datadir=${prefix}build/share
Name: fftw3-3
Description: fftw3.3.10
Version: 3.3.10
Requires: fftw3.3
Libs: -L${libdir} -lfftw3.3
Cflags: -I${includedir}/fftw3
然后，确保libfftw3.3.dylib库copy到了如下目录：
/Users/mingo/Applications/workspace/av/Shotcut/Contents/Frameworks
最后执行Run Cmake重新生成makefile，然后再编译链接即可：
. 编译成功，成功运行： 
6 参考文献
Shotcut - How To Use the macOS SDK ，此文是Shotcut的macOS上的官方编译文档。借助此文可少走很多弯路。