GStreamer 是一个基于流水线的多媒体框架，其内部基于GObject，以C语言写成（参见Wikipedia）。GStreamer采用基于plugin和pipeline的体系结构，框架中所有的功能模块都是现成可以插拔的component，可以很方便地安装到任意pipeline上。

一、 GStreamer 环境

通常，在运行基于GStreamer开发的程序前，需要根据相应系统发行版本配置相应的环境，除非有特定需求，都建议直接下载已编译的安装包。最新版本（1.8.0）中支持的系统具体如下：

• Linux

大部分Linux发行版均已提供GStreamer package，但部分发行版由于法律上原因会对GStreamer plugins进一步切割，因此可能不会包含gst-plugins-bad,
gst-plugins-ugly及gst-libav packages.

• OpenBSD

不同架构的package都有支持

• Windows

提供相应版本MSI安装器。SDK共提供三种文件，分别为：

• Runtime             ：运行GStreamer程序必需的文件，可能会随程序一同发布
• Development    ：开发GStreamer程序额外所需的文件
• Merge Modules：为GStreamer程序部署SDK所需的额外文件

• Mac
  OS X

提供相应的框架

• Android

提供可被集成入Android NDK的GStreamer Binaries

• iOS

提供可被集成如XCode的GStreamer Binaries

• Source

二、使用Cerbero编译GStreamer SDK

Cerbero是一个服务于开源项目的多平台编译系统，它为不同体系、发行版的平台编译并创建本地化package。

项目通过recipes文件（.recipe）来定义，文件中描述了需要编译的项目信息，如name, version, license, sources和编译方法。同时，还提供了一些用于后续打包的文件。

Packages通过packages文件（.package）来定义，文件中描述了包信息，如name, version, license, maintainer和其他用于打包的内容。一个包内部包含了一系列recipes，安装时将进行展开。

2.1 基础环境配置

Cerbero为各个平台提供了启动引导项，但仍需要一些基础环境来支持bootstrap。

Linux


        在Linux上，只需要确认所使用的发行版中python版本>= 2.6且以添加python的argparse模块（Python2.7已默认支持）。

OSX


        在OSX上你需要安装如下软件：


XCode
CMake : http://www.cmake.org/cmake/resources/software.html

Windows


        Windows中环境配置较为复杂，编译SDK通常也相对耗时最长，但目前Directshow Plugins由于需使用到Directshow base classes仍然需要使用到Microsoft的编译器和SDK完成编译。


Python2.7 : https://www.python.org/downloads/



                切记只能安装2.7版本的，3.x版本并不支持。


CMake : http://www.cmake.org/cmake/resources/software.html



                虽然只有x86版本，但默认同样支持X64编译。


Git : http://git-scm.com/download/win



                安装过程中选择“Checkout as-is, commit as-is”选项，其他默认即可。


Msys/MinGW : http://sourceforge.net/projects/mingw/files/Installer/mingw-get-setup.exe/download



                勾选所有基础选项进行安装。


Wix 3.5 : http://wix.codeplex.com/releases/view/60102
Microsoft SDK 7.1 : http://www.microsoft.com/en-us/download/details.aspx?id=8279



               安装Win7.1 SDK GRMSDKX_EN_DVD.7z（带X），只有该包中存在amd64.msi。


Windows Driver Kit 7.1.0 : http://msdn.microsoft.com/en-us/windows/hardware/hh852365



               安装GRMWDK_EN_7600_1.ISO。

 
Cerbero必须在MinGW shell中运行，当完成上述所有安装后，必须为shell配置python和git的路径：


32-bit windows



                echo ‘export PATH="$PATH:/c/Python27:/c/Program Files/Git/bin:/c/MinGW/bin/"‘ > ~/.profile


64-bit windows



                echo ‘export PATH="$PATH:/c/Python27:/c/Program Files (x86)/Git/bin:/c/MinGW/bin/"‘ > ~/.profile    注意：如生成的.profile文件与shell不位于同一路径下，请手动拷贝并运行python、git命令行进行确认已生效      

2.2 使用说明

通过已配置好的git将cerbero repo克隆至本地：

git clone git://anongit.freedesktop.org/gstreamer-sdk/cerbero

虽然文件夹中含有setup.py，但cerbero工具使用前并不需要安装。它直接使用./cerbero-uninstalled脚本实现功能。

默认情况下，cerbero会读取$HOME/.cerbero/cerbero.cbc配置文件来生成编译选项，该文件是一个python代码，支持重写或自定义。当该文件不存在时，cerbero会尝试使用默认选项进行编译，通常默认选项在所支持平台上都能顺利运行。

如不希望每次运行时替换cerbero.cbc文件，也可使用-c/-config选项指定.cbc配置文件。

$ ./cerbero-uninstalled -c config/win32.cbc [command]

如需进一步了解cerbero-uninstalled所支持的命令，可使用--help列出。

$ ./cerbero-uninstalled --help

2.3 Windows7 编译GStreamer SDK 1.0 for Windows

下列编译步骤中如遇到问题，可先在 问题记录中进行查找，如无对应再寻找其他方法解决。

第一次使用cerbero前，你需要运行bootstrap命令，它会通过packages manager来安装所有编译必需的部分，该操作会消耗较长时间（几个小时甚至更多）。

$ ./cerbero-uninstalled -c config/win32.cbc bootstrap
或
$ ./cerbero-uninstalled -c config/win64.cbc bootstrap

编译环境成功配置后，进行打包

$ ./cerbero-uninstalled -c config/win32.cbc package gstreamer-1.0-sdk
或
$ ./cerbero-uninstalled -c config/win64.cbc package gstreamer-1.0-sdk

打包完成后将生成如下文件：

2.4 Ubuntu 14.0.1 编译GStreamer SDK 1.0 for Android
Android SDK只能在Linux主机上使用config/cross-android.cbc进行编译。
下列编译步骤中如遇到问题，可先在 问题记录中进行查找，如无对应再寻找其他方法解决。


git及python2.7安装


        $ sudo add-apt-repository ppa:fkrull/deadsnakes

$ sudo apt-get update

$ sudo apt-get install python2.7

$ sudo apt-get install git

bootstrap


        $ ./cerbero-uninstalled -c config/cross-android.cbc bootstrap

package


        $ ./cerbero-uninstalled -c config/cross-android.cbc package gstreamer-1.0-sdk   

打包完成后将生成如下文件：

三、问题记录
3.1 如遇部分remote包无法下载，可考虑番羽土蔷后重试
    https://github.com/getlantern/lantern

3.2 去除download certificate验证





3.3 补全Win7.1 SDK配置安装


解决办法： 安装Win7.1 SDK GRMSDKX_EN_DVD.7z（带X），只有该包中存在amd64.msi

3.4 Cosole Unicode

The most secure solution is this one: Go to your Registry key HKEY_CURRENT_USER\Software\Microsoft\Command Processor and add String value Autorun = chcp 65001.

http://stackoverflow.com/questions/388490/unicode-characters-in-windows-command-line-how

3.5 Can‘t find ‘page‘ file: Invalid argument

C:\MinGW\msys\1.0\home\sniper\cerbero\sources\windows_x86\clutter-1.8.4\clutter\Makefile

http://mingw.5.n7.nabble.com/windres-unavoidably-reports-syntax-error-at-rc-1-td16052.html

3.6 dbug-glib-0.100

路径问题，将文件夹C:\Users\pandm\Desktop\dbus-glib-0.100\dbus\.libs中下列文件

dbus-bash-completion-helper.exe
dbus-binding-tool.exe




libdbus-glib-1-2.dll


拷贝至：C:\Users\pandm\Desktop\dbus-glib-0.100\dbus目录中

3.7 Unbuntu Android SDK libmad 缺失

    解决方法为去除对libmad项的依赖，具体文件有：

cerbero/recipes/gst-plugins-ugly-1.0.recipe
cerbero/recipes/gst-plugins-ugly-1.0-static.recipe
cerbero/packages/gstreamer-1.0-codecs-restricted.package