本文的内容几乎全部来自于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。
- 目录名使用正斜杠来分割,而不是Windows所使用的反斜杠(象"C:/ffmpeg"而不是"C:/ffmpeg")。
- 盘符(例如"C:/")可以从根目录处访问(像这样"/C/")。
- 文件名或目录名中的空格必须用双引号括起(例如这样"/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