faq: update getting

This commit is contained in:
Tim-Philipp Müller 2016-11-15 10:53:38 +00:00
parent 9666a22235
commit 9a128d2891

View file

@ -4,6 +4,8 @@
Generally speaking, you have three options, ranging from easy to hard : Generally speaking, you have three options, ranging from easy to hard :
- [binary packages for Windows, macOS, iOS and Android](#getting-binary-sdk)
- [distribution-specific packages](#getting-gstreamer-packages) - [distribution-specific packages](#getting-gstreamer-packages)
- [source tarballs](#getting-gstreamer-source) - [source tarballs](#getting-gstreamer-source)
@ -17,6 +19,9 @@ currently in use. For all practical purposes you should think of them as
two completely different libraries which just happen to have a similar two completely different libraries which just happen to have a similar
name. They can be installed in parallel and are completely independent. name. They can be installed in parallel and are completely independent.
GStreamer 1.x has been the main stable series since 2012. GStreamer 0.10 is
no longer maintained.
For the 0.10 version you will need the 0.10 plugins and bindings For the 0.10 version you will need the 0.10 plugins and bindings
(gst-plugins 0.10.x, gst-ffmpeg 0.10.x, gst-python 0.10.x etc.), while (gst-plugins 0.10.x, gst-ffmpeg 0.10.x, gst-python 0.10.x etc.), while
for the 1.0 version you will need the 1.0 plugins and bindings (ie. for the 1.0 version you will need the 1.0 plugins and bindings (ie.
@ -29,36 +34,49 @@ is 1.0.13). GStreamer-1.0 will not see or use any of the GStreamer-0.10
plugins and vice versa. plugins and vice versa.
All GStreamer command line tools are suffixed with their main version, All GStreamer command line tools are suffixed with their main version,
e.g. gst-launch-0.10 and gst-launch-1.0, or gst-inspect-0.10 and e.g. `gst-launch-1.0` and `gst-inspect-1.0`.
gst-inspect-1.0.
Applications will use either GStreamer-0.10 or GStreamer-1.0, since the Applications will use either GStreamer-1.0 or GStreamer-0.10, since the
0.10 and 1.0 API/ABI are not compatible. 1.0 and 0.10 API/ABI are not compatible.
Odd-numbered versions such as 0.9.x, 0.11.x, etc. are unstable developer Odd-numbered versions such as 0.9.x, 0.11.x, 1.3.x, 1.5.x, 1.7.x etc. are
releases that should generally not be used. unstable developer releases that should generally not be used.
## So which GStreamer version should I get? ## So which GStreamer version should I get?
You should download GStreamer-1.0. GStreamer-0.10 is end-of-life. You should download GStreamer 1.x. GStreamer-0.10 is no longer maintained.
## How can I install GStreamer from source ? ## How can I install GStreamer from source ?
We provide tarballs of our releases on our own site, at We provide tarballs of our releases on our own site, at
<http://gstreamer.freedesktop.org/src/> <http://gstreamer.freedesktop.org/src/>
When compiling from source, make sure you specify PKG\_CONFIG\_PATH When compiling from source, make sure you set the `PKG_CONFIG_PATH`
correctly when building against GStreamer. For example, if you environment variable correctly to the pkgconfig subdir of your install
configured GStreamer with the default prefix (which is /usr/local), then prefix's libdir, to make sure your newly-installed GStreamer versions are
picked up when building against GStreamer. For example, if you
configured GStreamer with the default prefix (which is `/usr/local`), then
you need to you need to
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
before building gst-plugins. before building GStreamer plugin modules. After installing GStreamer from
source on Linux, run `sudo ldconfig` to make sure your new libs will be found.
Please note that GStreamer is not an easy thing to build from source, since it
has so many interconnected pieces from multiple modules, which must all be
installed just right and must all find each other in the right versions.
If you have GStreamer already installed from packages, it is strongly
recommended that you find newer packages instead of installing from source, or
upgrade to a distro version that ships newer packages. Installing from source
into one prefix with distro packages in another prefix can cause problems if
it's not done right, and it is very difficult for anyone to provide help with
such a setup.
## Are there premade binaries available ? ## Are there premade binaries available ?
Yes we currently provide [precompiled packages for Windows, OS/X, Yes, we currently provide [precompiled packages for Windows, OS/X,
Android and iOS](http://gstreamer.freedesktop.org/pkg/). Android and iOS](http://gstreamer.freedesktop.org/pkg/).
We currently do not provide packages for Linux distributions, but rather We currently do not provide packages for Linux distributions, but rather
@ -75,7 +93,7 @@ interested in maintaining GStreamer binaries for other distributions or
Unices we would be happy to hear from you. Contact us through the Unices we would be happy to hear from you. Contact us through the
GStreamer-devel mailing list. GStreamer-devel mailing list.
I am having trouble compiling GStreamer on my LFS installation, why ? ## I am having trouble compiling GStreamer on my LFS installation, why ?
If you are running LFS our basic opinion is that you should be If you are running LFS our basic opinion is that you should be
knowledgeable enough to solve any build issues you get on your own. knowledgeable enough to solve any build issues you get on your own.