cerbero: Update documentation for Python 3 and Meson

WiX has also moved its homepage and repositories
This commit is contained in:
Nirbheek Chauhan 2018-10-12 22:05:43 +05:30
parent d8ce611a3a
commit 0f937e787f
2 changed files with 34 additions and 28 deletions

View file

@ -64,7 +64,7 @@ need to deploy.
If you are building your installer using one of the Professional If you are building your installer using one of the Professional
editions of [Visual editions of [Visual
Studio](http://www.microsoft.com/visualstudio/en-us/products/2010-editions/professional/overview) Studio](http://www.microsoft.com/visualstudio/en-us/products/2010-editions/professional/overview)
or [WiX](http://wix.sf.net) you can take advantage of pre-packaged or [WiX](http://wixtoolset.org) you can take advantage of pre-packaged
[Merge [Merge
Modules](http://msdn.microsoft.com/en-us/library/windows/desktop/aa369820\(v=vs.85\).aspx). Modules](http://msdn.microsoft.com/en-us/library/windows/desktop/aa369820\(v=vs.85\).aspx).
GStreamer is divided in packages, which roughly take care of GStreamer is divided in packages, which roughly take care of

View file

@ -7,8 +7,7 @@
The GStreamer build system provides bootstrapping facilities for all The GStreamer build system provides bootstrapping facilities for all
platforms, but it still needs a minimum base to bootstrap: platforms, but it still needs a minimum base to bootstrap:
- python > 2.6 and python's `argparse` module, which is already - python >= 3.5
included in python2.7.
- git - git
### Windows users ### Windows users
@ -19,21 +18,38 @@ Cerbero can take control.
You need to install the following programs: You need to install the following programs:
- [Python 2.7] - [Python 3.5+]
- [Git] (Select the install option "Checkout as-is, Commit as-is" and * First page of the installer
install it in a path without spaces, eg: c:\Git) - Check "Add Python 3.x to PATH"
- Click "Customize installation"
* Second page, check "pip"
* Third page, select:
- Install for all users
- Associate files with Python
- Add Python to environment variables
- Customize install location: C:\Python3
- [Git]
* Select the install option "Checkout as-is, Commit as-is"
* Ensure that git is installed in PATH, but no other tools are
- [Msys/MinGW] (Install it with all the options enabled) - [Msys/MinGW] (Install it with all the options enabled)
- [CMake] (Select the option "Add CMake in system path for the - [CMake] (Select the option "Add CMake in system path for the
current user") current user")
- [Yasm] (Download the win32 or win64 version for your platform, name - [Yasm] (Download the win32 or win64 version for your platform, name
it `yasm.exe`, and place it in your MinGW `bin` directory, it `yasm.exe`, and place it in your MinGW `bin` directory,
typically, `C:\MinGW\bin`) typically, `C:\MinGW\bin`)
- [WiX 3.5] - [WiX 3.11.1]
- [Microsoft SDK 7.1] (Install the SDK samples and the Visual C++
Compilers, required to build the DirectShow base classes. Might need Several packages that have Meson build files are now built by default with
installing the .NET 4 Framework first if the SDK installer doesn't Visual Studio, so you need to install Visual Studio 2015 or newer in the
find it) default location. The Visual Studio Community build which is free for
- [Windows Driver Kit 7.1.0] open-source use can be installed at:
* https://visualstudio.microsoft.com/vs/older-downloads/
You should add the cerbero git directory to the list of excluded folders in your
anti-virus, or you will get random build failures when Autotools does file
operations such as renames and deletions. It will also slow your build by
about 3-4x.
Your user ID can't have spaces (eg: John Smith). Paths with spaces are Your user ID can't have spaces (eg: John Smith). Paths with spaces are
not correctly handled in the build system and msys uses the user ID for not correctly handled in the build system and msys uses the user ID for
@ -42,19 +58,11 @@ the home folder.
Cerbero must be run in the MinGW shell, which is accessible from the Cerbero must be run in the MinGW shell, which is accessible from the
main menu once MinGW is installed. main menu once MinGW is installed.
The last step is making `python` and `git` available from the shell, for
which you will need to create a `.profile` file. Issue this command from
within the MinGW shell:
`echo "export PATH=\"\$PATH:/c/Python27:/c/Git/bin\"" >> ~/.profile`
Using the appropriate paths to where you installed `python` and `git`
(Note that inside the shell, / is mapped to c:\Mingw\msys\1.0 ) (Note that inside the shell, / is mapped to c:\Mingw\msys\1.0 )
### OS X users ### macOS users
To use cerbero on OS X you need to install the "Command Line Tools" from To use cerbero on macOS you need to install the "Command Line Tools" from
XCode. They are available from the "Preferences" dialog under XCode. They are available from the "Preferences" dialog under
"Downloads". "Downloads".
@ -228,14 +236,12 @@ To cross compile for iOS from OS X, use the configuration file
cerbero -c config/cross-ios-universal.cbc <command> cerbero -c config/cross-ios-universal.cbc <command>
[Warning]: images/icons/emoticons/warning.png [Warning]: images/icons/emoticons/warning.png
[Python 2.7]: http://www.python.org/getit/releases/2.7/ [Python 3.5+]: https://www.python.org/downloads/
[Git]: http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git [Git]: https://github.com/git-for-windows/git/releases/latest
[Msys/MinGW]: https://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/ [Msys/MinGW]: https://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/
[CMake]: http://www.cmake.org/cmake/resources/software.htm [CMake]: http://www.cmake.org/cmake/resources/software.htm
[Yasm]: http://yasm.tortall.net/Download.html [Yasm]: http://yasm.tortall.net/Download.html
[WiX 3.5]: http://wix.codeplex.com/releases/view/60102 [WiX 3.11.1]: https://github.com/wixtoolset/wix3/releases/tag/wix3111rtm
[Microsoft SDK 7.1]: http://www.microsoft.com/en-us/download/details.aspx?id=8279
[Windows Driver Kit 7.1.0]: http://msdn.microsoft.com/en-us/windows/hardware/hh852365
[XCode]: https://developer.apple.com/devcenter/ios/index.action#downloads [XCode]: https://developer.apple.com/devcenter/ios/index.action#downloads
[here]: http://www.freedesktop.org/software/gstreamer-sdk/cerbero.cbc.template [here]: http://www.freedesktop.org/software/gstreamer-sdk/cerbero.cbc.template
[Installing GStreamer]: installing/index.md [Installing GStreamer]: installing/index.md