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/sharemoduledir=${prefix}/lib/mlt
mltdatadir=${datadir}/mltName: 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/shareName: 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.bak1 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/shareName: 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.stab15 directories, 2 files
fftw3的头文件就放在fftw3目录下。具体头文件来源请参加下一节。
3.1 build配置
CMake的配置截图如下:
CMake => Kit configuration => current configuration 文字描述如下:
CMAKE_INSTALL_PREFIX => /Users/mingo/Applications/workspace/avCMAKE_INSTALL_RPATH => @executable_path/../FrameworksCMAKE_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/ShotcutQTDIR => /Users/mingo/Applications/workspace/tools/qt5.15.2/6.5.3/macosQT_PLUGIN_PATH => /Users/mingo/Applications/workspace/tools/qt5.15.2/6.5.3/macospluginsQML2_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└── man9 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.f031 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/shareName: 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上的官方编译文档。借助此文可少走很多弯路。