Windows下搭建FFmpeg开发调试环境的详细步骤

2022-11-13 13:11:52 搭建 步骤 调试

背景

如果你是一个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.zip和VSNASM.zip：

https://github.com/ShiftMediaProject/VSNASM/releases

Https://github.com/ShiftMediaProject/VSYASM/releases

下载完成后：

? 解压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.c的main()函数入口处打好断点，按F5开启愉快的调试学习之旅~

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

⏭️ 一键部署脚本

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

? 先下载下面仓库：

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

? 创建你的工程目录，如D:\Code\ffmpeg_smp_vs

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

? 双击运行脚本，等待运行完成

? 好了，接下来只需要参考步骤五即可

到此这篇关于Windows下搭建FFmpeg开发调试环境的文章就介绍到这了,更多相关Windows FFmpeg环境搭建内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持！

相关文章