Windows下搭建FFmpeg开发调试环境

发布于 2022年 01月 24日 00:45

背景#

如果你是一个FFmpeg的使用者,那么绝大部分情况下只需要在你的程序中引用FFmpeg的libav*相关的头文件,然后在编译阶段链接相关的库即可。

但是如果你想调试FFmpeg内部相关的逻辑,或者分析FFmpeg源码,那么有一个可供单步调试FFmpeg的环境往往能使你事半功倍!

要说Windows下做C/C++开发用哪个IDE最强大,我想我的答案是Visual Studio

要说Windows下怎么快速构建FFmpeg的VS项目,我首推ShiftMediaProject(下面都简称 SMP)开源项目:SMP GitHub

关于ShiftMediaProject 的更多相关信息,大家可以直接访问其官网

步骤#

接下来我将以VS2017为例

一步步介绍怎么搭建一个可供单步调试的FFmpeg项目

※ 注:在此之前请确保你电脑的网络环境能正常访问GitHub.

一、安装VS 2017#

先安装VS 2017,安装步骤非本文重点,此处不做赘述

但是有一点需要注意的是:安装时需勾选C++环境和Windows SDK 8.1

二、安装 YASM 与 NASM#

由于FFmpeg的源码有部分需要汇编支持,所以需要先安装好YASM/NASM的VS版本,这一点SMP官方团队也很贴心地帮我们做好:

先直接下载对应如下两个链接的VSYASM.zipVSNASM.zip

下载完成后:

👉 解压VSYASM.zip,右键install_script.bat选择以管理员身份运行,等待安装完成:

👉 解压VSNASM.zip,右键install_script.bat选择以管理员身份运行,等待安装完成:


🙂 TL;DR#

接下来的步骤会比较烦琐,经过多次实践我已经写好了一键部署脚本,可供大家快速部署能直接编译成功的项目。

如果不想理这些烦琐的细节,想直接使用一键部署脚本的读者

⏭️ 可直接跳到文章最后面的 一键部署脚本 章节


三、创建正确的目录层次#

我刚开始用SMP项目的时候总是对它的目录层级结构感到困惑,编译之后都找不着输出目录。

经过多次踩坑实践,再结合官方README的说明,实践出比较好的目录层次应该是如下:

- ffmpeg_smp_vs   // 假设你的项目文件夹叫 ffmpeg_smp_vs
  - source        // 创建source子文件夹,用于放SMP相关源码
  - msvc          // 自动生成,存放SMP编译生成的目标文件等

Q: 为什么要建立两层目录结构?#

A: 因为SMP项目为了不让生成的文件落在源码目录下造成“污染”,把输出目录定在源码目录同层级的msvc目录下。

如果你直接把源码下载到ffmpeg_smp_vs目录下,会导致最后生成的msvc目录跑到了ffmpeg_smp_vs目录外面去,不是很美观。

因此,把源码目录和生成目录都放在统一的ffmpeg_smp_vs目录下是比较好的实践。

四、下载源码和相关依赖#

假设你已经按步骤三创建好了相应的文件夹

就可以开始下载SMP源码及其相关依赖了

注:以下操作均在Windows CMD命令行工具中执行


※ 下载SMP源码:

cd ffmpeg_smp_vs\source
git clone https://github.com/ShiftMediaProject/FFmpeg.git

※ 运行脚本下载相关依赖库:

cd ffmpeg_smp_vs\source\FFmpeg\SMP
project_get_dependencies.bat /Y

下载的依赖库比较多,请耐心等待。若中途有出现错误或者中断,请再次执行上面最后一句脚本直到所有依赖库都顺利下载完成。

※ 下载第三方库的头文件:

👉 AMF 头文件

先获得AMF仓库代码

https://github.com/GPUOpen-LibrariesAndSDKs/AMF.git

再把 AMF\amf\public\include\ 下的所有子文件夹复制到 ffmpeg_smp_vs\msvc\include\AMF 下(目录不存在的话请自行创建)

👉 ffnvcodec 头文件

先获得ffnvcodec仓库代码

git clone https://github.com/FFmpeg/nv-codec-headers.git

再把 nv-codec-headers\include\ffnvcodec\ 下的所有头文件复制到 ffmpeg_smp_vs\msvc\include\ffnvcodec 下(目录不存在的话请自行创建)

👉 OpenGL 头文件

下载如下2个头文件放置到ffmpeg_smp_vs\msvc\include\gl下(目录不存在的话请自行创建)

https://www.khronos.org/registry/OpenGL/api/GL/glext.h
https://www.khronos.org/registry/OpenGL/api/GL/wglext.h

👉 EGL 头文件
下载下面这个头文件放置到ffmpeg_smp_vs\msvc\include\KHR下(目录不存在的话请自行创建)

https://www.khronos.org/registry/EGL/api/KHR/khrplatform.h

五、编译与调试#

※ 编译

进入文件夹:ffmpeg_smp_vs\source\FFmpeg\SMP

双击打开ffmpeg_deps.sln

右键整个解决方案 -> 点击生成解决方案

编译较耗时,请耐心地等待编译完成 ☕ ..

若编译失败,请仔细检查前面的步骤,或者给我留言

※ 调试

由于SMP默认调试目标路径设置有误(至少截止我写这篇文章的时候是这样 | 2021/12/09),所以我们需要修改一下三个可执行文件ffmpeg/ffprobe/ffplay的调试路径,以ffmpeg为例(另外2个都是这么改):

👉 右键Programs目录下的ffmpeg -> 选属性

👉 将配置属性->调试->命令 一行的$(TargetPath)修改为:$(OutDir)\bin\x64\$(TargetName)$(TargetExt)

👉 以调试ffmpeg为例,将ffmpeg设置为启动项目

👉 在ffmpeg.cmain()函数入口处打好断点,按F5开启愉快的调试学习之旅~

关于Visual Studio的调试技巧非本文重点,请自行搜索



⏭️ 一键部署脚本#

为方便大家快速部署一个可成功编译的FFmpeg VS 2017项目,避免在各种配置上踩坑浪费时间,我写了个一键部署的脚本供大家使用,前提是你要完成上述的步骤一步骤二再进行这一步。

👉 先下载下面仓库:

git clone https://github.com/Suiyek/OneKeySetupSMP.git

👉 创建你的工程目录,如D:\Code\ffmpeg_smp_vs

👉 把init_smp_proj.bat复制到你的工程目录下

👉 双击运行脚本,等待运行完成

👉 好了,接下来只需要参考步骤五即可


_ 欢迎关注我的公众号音视频开发札记

推荐文章