首页 > 代码库 > 在Windows下编译ffmpeg完全手册

在Windows下编译ffmpeg完全手册

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

注:

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

  本文的目的是提供一切与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.4bash,这个是有缺陷的,2.05bbash用来编译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的缺省includelib路径下,就不需要额外指定这些参数了。如果你希望把动态库和静态库分开保存,那就不得不指定路径。这样的路径被称为你所安装的库的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.dllmsys-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

 

整合MinGWMSys

复制C:/msys/etc/fstab.sampleC:/msys/etc/fstab

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

把下面这行

c:/mingw        /mingw

改为

c:/msys/mingw   /mingw

 

 

编译静态库

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

从启动菜单出进入

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

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

 

这是一个类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选项是在FFmpegWindows上编译成功所必须指定的。

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

 

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

make

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

 

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

make install

得到如下的输出画面:

 

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

echo $PROGRAMFILES

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

cd FFmpeg

 

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

当然你得知道正确的参数使用方法,要产生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目录下有三个子目录名字分别为:libavutillibavcodec  libavformat。在这三个目录下都有一个SLIBNAME_WITH_MAJOR.lib这样的文件,分别是avcodec-51.libavformat-50.lib avutil-49.libMSVC++从这些文件中才能知道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目录下有三个子目录名字分别为:libavutillibavcodec  libavformat。在这三个目录下都有一个SLIBNAME_WITH_MAJOR.lib这样的文件,分别是avcodec-51.libavformat-50.lib avutil-49.libMSVC++从这些文件中才能知道dll的导出函数。把这三个文件拷贝到Program Files下的FFmpeg下的lib目录。

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

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

MSvc++创建output_example.exe

在Windows下编译ffmpeg完全手册