README: Enhance and update

This commit is contained in:
Thibault Saunier 2016-10-26 17:58:16 -03:00
parent a2c4f6f2b0
commit b2b737dc1b

View file

@ -2,27 +2,41 @@
GStreamer [meson](http://mesonbuild.com/) based repositories aggregrator GStreamer [meson](http://mesonbuild.com/) based repositories aggregrator
You can build GStreamer and all its component at once using You can build GStreamer and all its modules at once using
meson and its "subproject" feature. meson and its [subproject](https://github.com/mesonbuild/meson/wiki/Subprojects) feature.
## Getting started ## Getting started
We have an helper script to get started, will get the right [meson](http://mesonbuild.com/) ### Install meson and ninja
version and get you ready to build. You can just get all GStreamer built running:
You should get meson through your package manager or using:
$ pip3 install --user meson
You should get `ninja` using your package manager or downloading it from
[here](https://github.com/ninja-build/ninja/releases).
### Build GStreamer and its modules
You can get all GStreamer built running:
```
mkdir build/ && meson build && ninja -C build/
```
NOTE: on fedora (and maybe other distributions) replace `ninja` with `ninja-build` NOTE: on fedora (and maybe other distributions) replace `ninja` with `ninja-build`
# Development environment
gst-build also contains a special `uninstalled` target that lets you enter an
uninstalled development environment where you will be able to work on GStreamer easily.
You can get into that environment running:
``` ```
./configure && ninja -C build/ ninja -C build/ uninstalled
``` ```
## GStreamer uninstalled If your operating system handles symlinks, built modules source code will be available
at the root of `gst-build/` for example GStreamer core will be in `gstreamer/`. Otherwise
gst-build also contains a special `uninstalled` target that lets you enter they will be present in `subprojects/`. You can simply hack in there and to rebuild you
an uninstalled development environment where you will be able just need to rerun `ninja -C build/`.
to work on GStreamer easily.
Inside that environment you will find the GStreamer modules
in subprojects/, you can simply hack in there and to rebuild you
just need to rerun `ninja`.