配置环境 Ubuntu 22.04.2 LTS + FFmpeg 6.0
建议在《编译与安装》一节,都使用源码的方式编译和安装,本编译安装方式最终生成的皆为静态库。
部分命令说明:
git -C <other-git-repo-path> [git-command] 指定其它路径的仓库 执行命令 注意,-C 要在命令之前。
Step 1 建立目录
在希望存放项目的目录下创建三个文件夹,分别是:
- ffmpeg_sources:用于下载源文件
- ffmpeg_build: 存储编译后的库文件
- bin:存储编码解析库等(ffmpeg,ffplay,ffprobe,X264,X265等)
可以直接在GNOME桌面中直接新建,也可以在终端中利用代码生成
#在主目录下创建,这个可以自定义 cd ~ mkdir ffmpeg_sources ffmpeg_build bin
Step 2 安装依赖库
在这之前若库不是最新的,通过sudo apt-get update更新一下软件列表。
在终端粘贴下列代码,安装需要的依赖库:
sudo apt-get -y install \ autoconf \ automake \ build-essential \ cmake \ git-core \ libass-dev \ libfreetype6-dev \ libsdl2-dev \ libtool \ libva-dev \ libvdpau-dev \ libvorbis-dev \ libxcb1-dev \ libxcb-shm0-dev \ libxcb-xfixes0-dev \ pkg-config \ texinfo \ wget \ zlib1g-dev libasound2-dev \ libgl1-mesa-dev \ libglew-dev\ libglm-dev
Step 3 编译和安装
对于不需要用到的编码库可以直接跳过不安装,并在FFmpeg中删除相应的./configure选项。比如若不需要libvpx,则不安装libvpx编码库,然后从安装FFmpeg部分中删除 --enable-libvpx。
Tip:如果是多核系统,可以尝试使用 make -j 指令来加快编译速度(例如make -j4,使用4个内核协助编译)
*如果主目录空间足够大,可以将编码库全部安装在主目录下,HOME为系统环境变量,可以对应修改该键值来指定安装的目录
NASM
在终端运行下列代码
cd ~/ffmpeg_sources && \ wget https://www.nasm.us/pub/nasm/releasebuilds/2.16/nasm-2.16.tar.bz2 && \ tar xjvf nasm-2.16.tar.bz2 && \ cd nasm-2.16 && \ ./autogen.sh && \ PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" && \ make && \ make install
如果在编译ffmpeg的时候报错找不到 nasm,则通过命令安装:sudo apt install nasm Yasm部分库使用到该汇编库,使用源码进行安装(如果在编译ffmpeg的时候报错找不到 yasm,则通过命令安装:sudo apt install yasm):
cd ~/ffmpeg_sources && \ wget -O yasm-1.3.0.tar.gz https://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz && \ tar xzvf yasm-1.3.0.tar.gz && \ cd yasm-1.3.0 && \ ./configure CFLAGS="-fPIC" CPPFLAGS="-fPIC" --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" && \ make && \ make install
libx264
H.264视频编码器。更多信息和使用范例参考H.264 Encoding Guide
要求编译ffmpeg时配置:--enable-gpl --enable-libx264
使用源码进行编译(其他编译步骤同理可以把命令进行拆分,但注意的是 大部分操作 配置环境变量和 configure是一起执行的。比如 PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --enable-static --enable-pic):
cd ~/ffmpeg_sources && \ git -C x264 pull 2> /dev/null || git clone --depth 1 https://github.com/mirror/x264.git && \ cd x264 && \ PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --enable-static --enable-pic && \ PATH="$HOME/bin:$PATH" make && \ make install
libx265
H.265/HEVC 视频编码器, 更多信息和使用范例参考H.265 Encoding Guide。
要求编译ffmpeg时配置:--enable-gpl --enable-libx265
使用源码进行编译:sudo apt-get install mercurial libnuma-dev && \ cd ~/ffmpeg_sources && \ if cd x265 2> /dev/null; then git pull && cd ..; else git clone https://gitee.com/mirrors_videolan/x265.git; fi && \ cd x265/build/linux && \ PATH="$HOME/bin:$PATH" cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED=off ../../source && \ PATH="$HOME/bin:$PATH" make && \ make install
libvpx
VP8/VP9视频编解码器。 更多信息和使用范例参考VP9 Video Encoding Guide 。
要求编译ffmpeg时配置: --enable-libvpx
使用源码进行编译:cd ~/ffmpeg_sources && \ git -C libvpx pull 2> /dev/null || git clone --depth 1 https://github.com/webmproject/libvpx.git && \ cd libvpx && \ PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --disable-examples --disable-unit-tests --enable-vp9-highbitdepth --as=yasm --enable-pic && \ PATH="$HOME/bin:$PATH" make && \ make install
libfdk-aac
AAC音频编码器. 更多信息和使用范例参考AAC Audio Encoding Guide。
要求编译ffmpeg时配置:--enable-libfdk-aac ( 如果你已经配置了 --enable-gpl则需要加上--enable-nonfree).
使用源码进行编译:cd ~/ffmpeg_sources && \ git -C fdk-aac pull 2> /dev/null || git clone --depth 1 https://github.com/mstorsjo/fdk-aac && \ cd fdk-aac && \ autoreconf -fiv && \ ./configure CFLAGS="-fPIC" CPPFLAGS="-fPIC" --prefix="$HOME/ffmpeg_build" && \ make && \ make install
libmp3lame
MP3音频编码器.
要求编译ffmpeg时配置:--enable-libmp3lame.
使用源码进行编译:
cd ~/ffmpeg_sources && \ git clone --depth 1 https://gitee.com/hqiu/lame.git && \ cd lame && \ PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --bindir="$HOME/bin" --enable-nasm --with-pic && \ PATH="$HOME/bin:$PATH" make && \ make install
libopus
Opus音频编解码器.
要求编译ffmpeg时配置:--enable-libopus.
使用源码进行编译:cd ~/ffmpeg_sources && \ git -C opus pull 2> /dev/null || git clone --depth 1 https://github.com/xiph/opus.git && \ cd opus && \ ./autogen.sh && \ ./configure --prefix="$HOME/ffmpeg_build" -with-pic&& \ make && \ make install
FFmpeg
可直接将下列代码复制在终端执行
cd ~/ffmpeg_sources && \ wget -O ffmpeg-6.0.tar.bz2 https://ffmpeg.org/releases/ffmpeg-6.0.tar.bz2 && \ tar xjvf ffmpeg-6.0.tar.bz2 && \ cd ffmpeg-6.0 && \ PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" CFLAGS="-O3 -fPIC" ./configure \ --prefix="$HOME/ffmpeg_build" \ --pkg-config-flags="--static" \ --extra-cflags="-I$HOME/ffmpeg_build/include" \ --extra-ldflags="-L$HOME/ffmpeg_build/lib" \ --extra-libs="-lpthread -lm" \ --bindir="$HOME/bin" \ --enable-gpl \ --enable-libass \ --enable-libfdk-aac \ --enable-libfreetype \ --enable-libmp3lame \ --enable-libopus \ --enable-libvorbis \ --enable-libvpx \ --enable-libx264 \ --enable-libx265 \ --enable-pic \ --enable-shared \ --enable-nonfree && \ PATH="$HOME/bin:$PATH" make && \ make install && \ hash -r
通过这段指令,在重新启动Ubuntu后可以识别新安装FFmpeg的位置
source ~/.profile
现在已经完成编译和安装ffmpeg (also ffplay, ffprobe, lame, x264, & x265) 。该文档剩余章节主要讲如何更新和删除ffmepg。
编译完成后,ffmpeg_build ffmpeg_sources bin目录的大体情况
lqf@ubuntu:~/ffmpeg_build$ ls
bin include lib share
lqf@ubuntu:~/ffmpeg_sources$ ls
fdk-aac lame-3.100.tar.gz opus yasm-1.3.0.tar.gz
ffmpeg-4.2.1 libvpx x264
ffmpeg-4.2.1.tar.bz2 nasm-2.14.02 x265
lame nasm-2.14.02.tar.bz2 yasm-1.3.0
lqf@ubuntu:~/bin$ ls
ffmpeg ffplay ffprobe lame nasm ndisasm vsyasm x264 yasm ytasm
Step 4 使用
确认ffmpeg版本
查看ffmpeg版本以及编译配置信息
ffmpeg -version
正常显示ffmpeg版本信息,以及编译配置信息。如果报以下错误(找不到so库):
需要将ffmpeg lib加入到环境变量。步骤如下所述:
- 编辑和修改/etc/ld.so.conf
sudo vim /etc/ld.so.conf
比如:
特别需要注意的是不能直接照抄这个目录,特别需要注意的是不能直接照抄这个目录。需要自己在ffmpeg_build/lib目录下使用 pwd 命令获取对应的目录。
2.使环境变量生效,然后:sudo ldconfig
测试ffplay命令
测试ffplay是否可以使用(需要在Ubuntu图形方式进行测试,不能在类似xshell终端测试)
#如果可以正常播放则代表功能正常,后面的地址要确保目录下存在对应的文件 ffplay ./test.mp4
Step 5 ffmpeg代码调试
生成的可执行程序中,ffmpeg 不包含调试信息,调试信息在 ffmpeg_g 中,Debug 要选择 ffmpeg_g。
除此之外,./config选项是确定调试信息的核心,需在config中添加:
- - –enable-debug=3:开启debug调试
- - –disable-asm:禁用 asm 优化
- - –disable-optimizations:禁用优化,以便调试时按函数顺序执行。
- - –disable-stripping:禁用剥离可执行程序和共享库,即调试时可以进入到某个函数进行单独调试。
将configure生成的文件清空一下:
make clean
然后重新配置config
./configure \ --prefix="$HOME/ffmpeg_build" \ --pkg-config-flags="--static" \ --extra-cflags="-I$HOME/ffmpeg_build/include" \ --extra-ldflags="-L$HOME/ffmpeg_build/lib" \ --extra-libs="-lpthread -lm" \ --bindir="$HOME/bin" \ --enable-gpl \ --enable-libass \ --enable-libfdk-aac \ --enable-libfreetype \ --enable-libmp3lame \ --enable-libopus \ --enable-libvorbis \ --enable-libvpx \ --enable-libx264 \ --enable-libx265 \ --enable-pic \ --enable-shared \ --enable-nonfree \ --enable-debug=3 \ --disable-optimizations \ --disable-asm \ --disable-stripping && \ PATH="$HOME/bin:$PATH" make && \ make install && \ hash -r
Debug功能便可以使用了
Step 6 文档
你可以使用 man ffmpeg以本地的方式访问文档:
echo"MANPATH_MAP $HOME/bin $HOME/ffmpeg_build/share/man" >> ~/.manpath
你可能必须注销系统然后重新登录man ffmpeg才生效。
HTML 格式的文档位于 ~/ffmpeg_build/share/doc/ffmpeg.
你也可以参考在线文档 online FFmpeg documentation
另:如果有问题,可再次参考:零声学院 音视频高级教程 ubuntu ffmpeg开发环境搭建0.4 (yuque.com)
靠谱推荐:Free Pos,微信JOCIHEZ