Basic FAQ

From The Player Project

Jump to: navigation, search
(How do I get the latest code?)
(Player/stage)
Line 297: Line 297:
===Player/stage===
===Player/stage===
-
Since we're using the GNU Autotools, it's a little different to build from a working copy instead of from a distribution. First, you need autoconf and automake installed. They are already installed on any reasonable UNIX-like machine, but you might need to upgrade them; you can download both packages from any GNU mirror. We're currently using:
+
====Player====
 +
 
 +
The development version of Player uses [http://www.cmake.org CMake] for its build system. This is an entirely new build system, replacing the old GNU Autotools-based system we used in the past. It's simpler, cleaner and much, much faster to configure, compile and install using this new system. To build Player from SVN, you will need to install CMake (at least version 2.4 is required).
 +
 
 +
Once you have the Player source checked out and CMake installed, create a directory anywhere on your system where you have write privileges and change to that directory. Typically, a subdirectory of the source is used for convenience. For example:
 +
 
 +
$ cd player/
 +
$ mkdir build
 +
$ cd build/'''
 +
 
 +
Within this directory, execute either cmake (for a text-only interface) or ccmake (for an ncurses-based UI), providing the path to the Player source. Continuing the above example, one of the following two lines would be used:
 +
 
 +
$ cmake ../
 +
$ ccmake ../
 +
 
 +
If you used cmake, the configuration will be completed in a single run. It will display output indicating the configuration Player will be built with (enabled/disabled drivers, client libraries, etc.). If you used ccmake, you will be presented with a set of configurable options. Press 'c' to run the configuration, and more options will appear. Configure Player to suit your needs (for example, change CMAKE_INSTALL_PREFIX to change the location to install to, and enable/disable drivers), then press 'c' repeatedly until the generate option appears at the bottom (usually two or three passes are required). Press 'g' to generate the build scripts.
 +
 
 +
You can now build and install Player using the build method of your system. This will typically be Make, so execute make:
 +
 
 +
$ make
 +
$ make install
 +
 
 +
====Stage====
 +
 
 +
Stage's CMake-based build system is still under development, so it still uses the GNU Autotools-based build system. Since we're using the GNU Autotools, it's a little different to build from a working copy instead of from a distribution. First, you need autoconf and automake installed. They are already installed on any reasonable UNIX-like machine, but you might need to upgrade them; you can download both packages from any GNU mirror. We're currently using:
* autoconf 2.53
* autoconf 2.53
* automake 1.9
* automake 1.9

Revision as of 02:28, 15 May 2008

Personal tools