在Windows下编译ffmpeg完全手册

本文的内容几乎全部来自于FFmpeg on Windows，但是由于国内的网络封锁，很难访问这个域名下的内容，因此我一方面按照我自己的理解和实践做了翻译，另一方面也是为了能提供一个方便的参考方法。

注：

1.       对于compile和build这两个词，本文统一的使用编译这个词，根据上下文读者应能区分语义上的差别。

本文的目的是提供一切与FFmpeg在Windows下的相关帮助。它最初是一个针对用MSys+MinGW系统编译的手把手的教程，现在也增加了如何在你的项目中链接FFmpeg所产生的库（C++，C#）。    
      我们不讨论Cygwin，因为它的工作方式基本上与Unix系统相一致。 开始之前，首先要明确以下几点：

1.       由于MSVC++并不严格的遵循C标准，因此FFmpeg不能使用MSVC++来编译，而且将来也不会支持。所以整个编译过程必须使用MSys+MinGW系统来完成。

2.       如果你选择编译动态链接库(dll)，这些库将和其他的动态链接库一样在使用上没什么差别。你可以使用MSVC++来链接这些库进入到你的程序，只有这种情况下MSVC++是被支持的。

介绍本指南是十分冗长的。如果你已经以前曾有过编译开源软件的经验，你可以尝试读一下这篇。它要简短的多，只需要一些小的微调就能正常工作。
     但是如果你遇到了任何问题，在你向ffmpeg的邮件列表报告错误时请先仔细的通读本文，它是非常直观的，不少地方的细节甚至可能过于详细了。我们试图涵盖一切可能出错的地方，如果你精确的遵照文中的方法，你不会在Windows环境下的FFmpeg上有任何问题。 尽你的努力去解决你所遇到的问题，绝大多数的FFmpeg开发人员不使用Windows，所以他们帮不了你什么。

预备这里的内容可能和本文没有什么关系，但是我不想留下任何可能出错的地方。对于绝大多数人来说，这一部分可以跳过。 你需要一个解压的工具软件支持“*.tar.gz”和“*.tar.bz2”文件。你将需要把这些压缩包解压缩到指定的目录下。如果你已经有这样的程序了，并且知道如何解压到特定目录下，请阅读准备MSys+MinGW系统。 这里我将演示如何使用7-Zip或WinRAR来解压缩。推荐使用7-Zip，因为它是开源且免费的。

• 7-Zip
• WinRAR

准备MSys+MinGW系统获取最新的MSys+MinGW系统。注意以下几个包的版本要求：

• 不要使用2.0.4的bash，这个是有缺陷的，2.05b的bash用来编译FFmpeg没有问题，但是更推荐3.1版本。
• 使用msys-1.0.dll-SNAP-1.0.11-2006.04.23
• 不要使用binutils-2.15.91-20040904-1，它无法正确的链接。

如果你已经安装配置完毕，那么请阅读下一部分用SVN方式获取FFmpeg（http://www.aurora-x.net/wiki/CompileFFmpegWindows#FFmpeg_SVN），否则的话请依次执行下面的步骤。

• 安装MSys
• 安装MinGW
• 整合MinGW和MSys

用SVN方式获取FFmpeg如果你已经知道如何获取FFmpeg的源代码，那么请阅读下一部分编译。 由于FFmpeg的源代码存放在SVN仓库里，你必须使用命令行程序或是图形界面程序来访问。我个人推荐TortoiseSVN，因为它和Windows资源管理器结合的非常棒，所以我只介绍使用TortoiseSVN的方法。 编译

• 编译静态库
• 编译动态库

链接

• 用MSVC++链接DLL库
• 用MSVC++创建output_example.exe

编译FFplay你必须事先安装了SDL-devel。

1.       解压该软件包。

2.       将lib下的所有文件复制到C:/msys/mingw/lib。

3.       将include下的所有文件复制到C:/msys/mingw/include。

4.       将bin下的i386-mingw32msvc-sdl-config复制到C:/msys/mingw/bin，并重命名为sdl-config。

5.       将bin下的SDL.dll复制到C:/msys/mingw/bin。

[Copy to clipboard]

CODE:

SDL.dll必须在ffplay.exe德PATH路径中，程序才能启动。在MSys环境下mingw/bin在PATH环境变量中，因此运行ffplay.exe不会有问题。但如果你想在MSys外部运行，则应SDL.dll复制到和ffplay.exe同一个目录下。

现在你可以按照前面的方式静态或动态重新编译FFmpeg，在运行configure脚本后，它将正确的找到SDL和ffplay。

对第三方库的支持

你必须完全的理解了编译动态库部分。

在向FFmpeg的二进制文件中添加其他的库时，你必须首先考虑库是以静态还是动态的链接到FFmpeg中。不要把这个和FFmpeg本身是静态/动态链接库搞混，你可以把静态的将第三方库链接到FFmpeg中，但是FFmpeg的库本身是动态加载的dll库。

考虑这种情况：你想要更换xvidcore却不希望重新编译FFmpeg，那你就应该把xvidcore编译成动态链接库。

其次你要考虑的是这些第三方库被安装到MSys系统中的什么位置上。

对于绝大多数的是库，如果你把它们安装到缺省路径，你就得向FFmpeg的configure脚本传递额外的参数，这样才能在编译的时候找到这些库。

如果你把这些库安装到gcc的缺省include和lib路径下，就不需要额外指定这些参数了。如果你希望把动态库和静态库分开保存，那就不得不指定路径。这样的路径被称为你所安装的库的prefix。 如果你把库安装在了非gcc的缺省寻找路径，你必须向FFmpeg的configure脚本传递这些路径信息。

[Copy to clipboard]

CODE:

--extra-ldflags=-L<prefix>/lib --extra-cflags=-I<prefix>/include

类似这样：

[Copy to clipboard]

CODE:

./configure --enable-memalign-hack --enable-mp3lame  -–extra-ldflags=-L/usr/local/lib  --extra-cflags=-I/usr/local/include

在MSys下gcc的缺省路径是 /mingw另外，如果你把这些库的dll安装后，确保你的应用程序能在PATH环境变量中找到相应的dll。 我将展示下面这些库的安装：

• zlib
• mp3lame
• xvidcore
• libogg
• libvorbis
• faad
• faac
• amr_nb
• amr_wb
• libdts
• libgsm
• x264

引用原文：http://www.aurora-x.net/wiki/CompileFFmpegWindows

安装MSys

下载如下的文件：

• MSYS-1.0.11-2004.04.30-1.exe
• msys-1.0.dll-SNAP-1.0.11-2006.04.23.tar.bz2
• bash-3.1-MSYS-1.0.11-snapshot.tar.bz2

接下来依次安装这些文件：

MSYS-1.0.11-2004.04.30-1.exe

运行 MSYS-1.0.11-2004.04.30-1.exe.

点Yes

点Next >

如果你接受许可协议，点Yes

点Next >

选择MSys安装的路径，推荐C:/msys。点Next >。

点Next >

选择MSys在启动菜单中位置，推荐MinGW，点Next >。

上载新附件"Install.png"

点Install。不久你将看到

输入n后回车

再按一下回车。

把所有打勾的框去掉，然后点Finish

msys-1.0.dll-SNAP-1.0.11-2006.04.23.tar.bz2

• 将该压缩包解压到C:/msys/bin。
• 在Windows资源管理器中打开C:/msys/bin目录。
• 删除文件msys-1.0.dll（你刚才已经解压了一个新的版本了，所以删除旧的没有问题）。
• 重命名new-msys-1.0.dll为msys-1.0.dll。

bash-3.1-MSYS-1.0.11-snapshot.tar.bz2

• 在本地目录解压该压缩包。
• 产生一个名为bash-3.1的目录。
• 在该目录下有一个子目录名为bin，其他的目录并不关心。
• 复制bin目录中的所有文件到C:/msys/bin。
• 提示是否要覆盖sh.exe的时候，选择确定。

修改 "msys.bat"

用文本编辑器打开C:/msys/msys.bat，譬如记事本等。如果你打算用MSVC++编译你的程序（注意：是你的程序，不是FFmpeg），你需要有.lib文件才能链接到FFmpeg的库。这些.lib文件可以使用微软的工具链中lib命令产生。为此，你的机器上必须已经安装了微软的Visual Studio或是Visual C++。把下面这行加到msys.bat的最前面，把路径替换成你机器上vcvars32.bat实际存在的路径。

call "C:/Program Files (x86)/Microsoft Visual Studio .NET 2003/vc7/bin/vcvars32.bat"

如果你的操作系统是Windows x64，那你必须把下面的这些内容插入到:_WindowsNT标签后面（行36）：

rem Hopefully a temporary workaround for getting MSYS shell to run on x64

rem (WoW64 cmd prompt sets PROCESSOR_ARCHITECTURE to x86)

if not "x%PROCESSOR_ARCHITECTURE%" == "xAMD64" goto _NotX64

set COMSPEC=%WINDIR%/SysWOW64/cmd.exe

%COMSPEC% /c %0 %1 %2 %3 %4 %5 %6 %7 %8 %9

goto EOF

:_NotX64

安装MinGW

下载这些文件：

• binutils-2.17.50-20060824-1.tar.gz
• gcc-core-3.4.5-20060117-1.tar.gz
• gcc-g++-3.4.5-20060117-1.tar.gz
• mingw-runtime-3.10.tar.gz
• w32api-3.7.tar.gz （站点上找不到该文件，不过这个链接是有效的）

把它们全部解压到C:/msys/mingw。

整合MinGW和MSys

复制C:/msys/etc/fstab.sample为C:/msys/etc/fstab。

用文本编辑器打开C:/msys/etc/fstab编辑。（注意：使用一个支持Unix换行风格的编辑器）

把下面这行

c:/mingw        /mingw

改为

c:/msys/mingw   /mingw

编译静态库

如果你的系统已经按照所安装配置，那么下面的动作将正常执行：

从启动菜单出进入

开始->程序->MinGW->MSys->msys

一个米色背景的窗口会出现在你的眼前，这是一个运行着bash的rxvt程序

这是一个类Linux的shell并且在Windows上运行的就像是在使用一个真正的Linux shell。

1. 目录名使用正斜杠来分割，而不是Windows所使用的反斜杠（象"C:/ffmpeg"而不是"C:/ffmpeg"）。
2. 盘符（例如"C:/"）可以从根目录处访问（像这样"/C/"）。
3. 文件名或目录名中的空格必须用双引号括起（例如这样"/C/Program Files (x86)"，带有双引号）。

切换目录到你之前存放FFmpeg源代码的目录，如果你严格的按照本文的示范，那么就应该输入下面的命令来切换:

cd /C/ffmpeg

首先配置FFmpeg，选择你所需要的部分，如果你还想安装额外的库（例如mp3lame，或xvid），参考后面的使用第三方库部分。不过先确保完成了这一部分和下一部分动态库编译。

如果你不知道项包含什么，那么就输入：

./configure --enable-memalign-hack

--enable-memalign-hack选项是在FFmpeg在Windows上编译成功所必须指定的。

待配置完成后，将回到命令提示符，你应该看到如下的画面：

如果没有错误的话，你现在就可以"make" FFmpeg了，在提示符后输入：

make

编译的过程将持续很长时间。如果一切正常，结束后将返回提示符，并有如下的输出画面

程序已经编译好了，你可以在ffmpeg的目录下找到ffmpeg.exe这个文件。之后，你应该执行安装步骤

make install

得到如下的输出画面：

这将会复制所有生成的重要文件到系统的"Program Files"目录下。通常"Program Files"目录是"C:/Program Files"，但也有可能会不同。要了解确切的路径，在提示符下输入：

echo $PROGRAMFILES

然后将Windows风格的路径名改为Linux风格的路径名，进入该目录，在该目录下输入

cd FFmpeg

很好，你现在可以方便的运行ffmpeg.exe，FFmpeg已经成功的编译并静态链接了。

当然你得知道正确的参数使用方法，要产生Windows兼容的文件请参考http://ffmpeg.mplayerhq.hu/faq.html#SEC9以获取更多的信息。

编译动态库

编译动态库和编译静态库没有什么明显的差别，只不过你要明确地告诉configure脚本你现在将编译动态库。

如果还没有MSys的话，那么现在启动它：

开始->程序->MinGW->MSys->msys

切换到FFmpeg的源代码目录，在开始编译前先清理上一次留下的中间文件是个好习惯：

make distclean

现在需要向configure脚本多传递两个参数：

./configure --enable-shared --disable-static --enable-memalign-hack

后面的则不变：

make

make install

在Program Files下的FFmpeg目录里，现在应该多了一些文件：

ffmpeg.exe

avcodec.dll

avcodec-51.dll

avcodec-51.11.0.dll

avutil.dll

avutil-49.dll

avutil-49.0.0.dll

avformat.dll

avformat-50.dll

avformat-50.5.0.dll

include/

lib/

你可能已经注意到了每个库都有三个对应的dll，它们是同一份文件拷贝。

• SLIBNAME contains only the library name (avcodec.dll)
• SLIBNAME_WITH_MAJOR contains library name and major version number (avcodec-51.dll)
• SLIBNAME_WITH_VERSION contains library name and full version number (avcodec-51.11.0.dll)

因为MSys将ln（制作符号链接的程序）以cp（文件复制）来对待，所以就产生了这些相同的拷贝。

除了消耗点磁盘外不会有任何其他问题，不过对于所有使用这些库的可执行文件来说只链接到SLIBNAME_WITH_MAJOR，因此你可以放心的删除另外两个。换句话说你只需留下avcodec-51.dll、avformat-50.dll 和 avutil-49.dll就行了。

include目录包含了一个名为ffmpeg的子目录，这个子目录里存放了所有其他应用程序访问FFmpeg库时所需包含的头文件。

lib目录下有一个子目录pkgconfig。如果你不知道它是干吗的，那就忽略它吧。

用MSVC++链接DLL库

这是绝大多数人发生误解的地方：FFmpeg SVN本身不能用MSVC++编译，但是如果它在MinGW下正确的被编译，那么你可以把生成的dll用在任何支持dll的程序里。

注意你将用到的不是ffmpeg.exe，而是那些dll。

在开始往下阅读之前，你应该确保你完成并理解了编译静态库和编译动态库部分的内容。这不是推荐的，而是必须的。

---

在msys提示符下输入：

lib

如果你看到如下的画面，说明一切OK，注意有Microsoft (R) Library Manager字样。

上面假定了你是在完成了编译动态库后在FFmpeg目录下执行的，如果你还没有编译动态库，那么依次执行如下：

cd /c/ffmpeg

make distclean

./configure --enable-shared --disable-static --enable-memalign-hack

make

make install

lib

在ffmpeg目录下有三个子目录名字分别为：libavutil、libavcodec 和 libavformat。在这三个目录下都有一个SLIBNAME_WITH_MAJOR.lib这样的文件，分别是avcodec-51.lib、avformat-50.lib 和avutil-49.lib。MSVC++从这些文件中才能知道dll的导出函数。把这三个文件拷贝到Program Files下的FFmpeg下的lib目录。

现在通过包含include/ffmpeg下的头文件，和使用刚才我们拷贝的那三个lib文件进行链接，就能够编写具备FFmpeg功能的应用程序了。

我提供了一个示例：用MSVC++创建output_example.exe

用MSvc++创建output_example.ex

这是绝大多数人发生误解的地方：FFmpeg SVN本身不能用MSVC++编译，但是如果它在MinGW下正确的被编译，那么你可以把生成的dll用在任何支持dll的程序里。

注意你将用到的不是ffmpeg.exe，而是那些dll。

在开始往下阅读之前，你应该确保你完成并理解了编译静态库和编译动态库部分的内容。这不是推荐的，而是必须的。

---

在msys提示符下输入：

lib

如果你看到如下的画面，说明一切OK，注意有Microsoft (R) Library Manager字样。

上面假定了你是在完成了编译动态库后在FFmpeg目录下执行的，如果你还没有编译动态库，那么依次执行如下：

cd /c/ffmpeg

make distclean

./configure --enable-shared --disable-static --enable-memalign-hack

make

make install

lib

在ffmpeg目录下有三个子目录名字分别为：libavutil、libavcodec 和 libavformat。在这三个目录下都有一个SLIBNAME_WITH_MAJOR.lib这样的文件，分别是avcodec-51.lib、avformat-50.lib 和avutil-49.lib。MSVC++从这些文件中才能知道dll的导出函数。把这三个文件拷贝到Program Files下的FFmpeg下的lib目录。

现在通过包含include/ffmpeg下的头文件，和使用刚才我们拷贝的那三个lib文件进行链接，就能够编写具备FFmpeg功能的应用程序了。

我提供了一个示例：用MSVC++创建output_example.exe

用MSvc++创建output_example.exe