User Tools
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
cppdev:gettingstarted [2012-11-09 17:37] Carsten [Downloading a Compressed Archive] |
cppdev:gettingstarted [2016-08-06 14:22] Carsten remove obsolete section "Downloading a Compressed Archive" |
||
|---|---|---|---|
| Line 10: | Line 10: | ||
| This section explains how you initially get the Cafu source code. | This section explains how you initially get the Cafu source code. | ||
| - | The Cafu source code can be obtained from a compressed archive or by checking out from its Subversion repository. | + | The Cafu source code can be obtained from a compressed archive or by checking it out from its Git repository. |
| - | + | ||
| - | + | ||
| - | ==== Downloading a Compressed Archive ==== | + | |
| - | + | ||
| - | The easiest way to get the Cafu source code is to download a compressed archive for your platform from [[http://www.cafu.de/downloads|www.cafu.de/downloads]]. | + | |
| - | + | ||
| - | The contents of the Windows (zip) and Linux (gz, bz2) archives is the same (inclusive end-of-line style), but Linux users should still get the tar.gz or tar.bz2 archive as it properly sets the executable flags that are required for the build scripts. | + | |
| - | + | ||
| - | Extract the archive contents into an arbitrary directory and you're ready for the [[#python_and_scons|next step]]. | + | |
| Line 25: | Line 16: | ||
| Alternatively, you can also check out the Cafu source code directly from its Git repository. | Alternatively, you can also check out the Cafu source code directly from its Git repository. | ||
| - | /* (We recently migrated from Subversion to Git, a detailed report is at [[http://www.cafu.de/forum/viewtopic.php?f=14&t=1090|Part 1]], [[http://www.cafu.de/forum/viewtopic.php?f=14&t=1092|Part 2]].) */ | + | /* (We recently migrated from Subversion to Git, a detailed report is at [[http://forum.cafu.de/viewtopic.php?f=14&t=1090|Part 1]], [[http://forum.cafu.de/viewtopic.php?f=14&t=1092|Part 2]].) */ |
| Git is a version control system that allows the Cafu developers to work on their copy of the source code independently of each other, and to distribute the latest version of the source code to users and developers at any time. | Git is a version control system that allows the Cafu developers to work on their copy of the source code independently of each other, and to distribute the latest version of the source code to users and developers at any time. | ||
| Line 36: | Line 27: | ||
| There is no better way to get and share new features and bug fixes conveniently and simple. | There is no better way to get and share new features and bug fixes conveniently and simple. | ||
| - | Check out the source code at the command-line under Windows or Linux with this command: | + | For Windows and many other systems, you can get Git from the [[http://git-scm.com/downloads|Git downloads]] page. Popular Git clients with a graphical user interface are available at the Git downloads page as well. |
| + | |||
| + | With most Linux distributions, installing Git via the systems package manager is usually preferred. For example, under Ubuntu: | ||
| <code bash> | <code bash> | ||
| - | > git clone https://bitbucket.org/cafu/cafu.git Cafu | + | > sudo apt-get install git gitk |
| </code> | </code> | ||
| - | This command assumes that you have already installed the Git command-line client. | + | Then check out the source code at the command-line under Windows or Linux with this command: |
| - | You can get Git from the [[http://git-scm.com/downloads|Git downloads]] page for Windows, Linux and many other systems. | + | <code bash> |
| - | Note that with most Linux distributions, installing Git via the systems package manager is usually preferred. | + | > git clone https://bitbucket.org/cafu/cafu.git Cafu |
| - | Popular Git clients with a graphical user interface are available at the Git downloads page as well. | + | </code> |
| - | Our Git project page is https://bitbucket.org/cafu/cafu, where you can browse the repository online, create forks, post pull requests, and find very good related help texts. | + | Our Git project page is https://bitbucket.org/cafu/cafu, where you can browse the repository online, create forks, post pull requests, and find very good additional help. |
| Line 62: | Line 55: | ||
| Under Windows, | Under Windows, | ||
| * first get and install Python **2.7** (//not// one of the newer, but backwards-incompatible 3.x editions!) from [[http://www.python.org/download/]], | * first get and install Python **2.7** (//not// one of the newer, but backwards-incompatible 3.x editions!) from [[http://www.python.org/download/]], | ||
| - | * then get and install SCons **2.0** (or any later version; with VS 2010, you even need version **2.1 (alpha)**) from [[http://www.scons.org/download.php]]. | + | * then get and install SCons **2.3** (or any later version) from [[http://www.scons.org/download.php]]. |
| - | If in doubt, pick the Windows installers for both Python 2.7 and SCons 2.0: they are easy to use, lightweight, and automatically setup the proper environment variables. | + | If in doubt, pick the Windows installers for both Python 2.7 and SCons 2.3: they are easy to use, lightweight, and automatically setup the proper environment variables. |
| Important notes: | Important notes: | ||
| - | * Pick the **32-bit** edition of Python even on 64-bit systems! (Unfortunately, SCons does not yet work with the 64-bit builds of Python.) That is, [[http://www.python.org/ftp/python/2.7.2/python-2.7.2.msi|python-2.7.2.msi]] is the right file for all Windows systems. | + | * Pick the **32-bit** edition of Python even on 64-bit systems! (Unfortunately, SCons does not yet work with the 64-bit builds of Python.) That is, [[http://www.python.org/ftp/python/2.7.5/python-2.7.5.msi|python-2.7.5.msi]] is the right file for all Windows systems. |
| - | * On Windows Vista and Windows 7, run the SCons installer via right-click, then select **"Run as administrator"**. | + | * On Windows Vista, 7 and 8, run the SCons installer via right-click, then select **"Run as administrator"**. |
| - | That is normally all, but you may wish to check if the Python installer added Pythons ''Scripts'' directory to the ''PATH'' environment variable of your system. | + | That is normally all, but you may wish to check if the Python installer added Python's ''Scripts'' directory to the ''PATH'' environment variable of your system. |
| For example, if Python was installed in ''C:\Python27'', then ''PATH'' should contain both ''C:\Python27'' and ''C:\Python27\Scripts''. | For example, if Python was installed in ''C:\Python27'', then ''PATH'' should contain both ''C:\Python27'' and ''C:\Python27\Scripts''. | ||
| Otherwise, you have to add the proper directories manually: See http://support.microsoft.com/kb/310519 and http://vlaurie.com/computers2/Articles/environment.htm for additional information. | Otherwise, you have to add the proper directories manually: See http://support.microsoft.com/kb/310519 and http://vlaurie.com/computers2/Articles/environment.htm for additional information. | ||
| Line 84: | Line 77: | ||
| > scons -v | > scons -v | ||
| SCons by Steven Knight et al.: | SCons by Steven Knight et al.: | ||
| - | engine: v2.0.0.final.0.r5023, 2010/06/14 22:05:46, by scons on scons-dev | + | script: v2.3.0, 2013/03/03 09:48:35, by garyo on reepicheep |
| - | Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 The SCons Foundation | + | engine: v2.3.0, 2013/03/03 09:48:35, by garyo on reepicheep |
| + | engine path: ['C:\\Python27\\Scripts\\..\\Lib\\site-packages\\scons-2.3.0\\SCons'] | ||
| + | Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The SCons Foundation | ||
| </code> | </code> | ||
| The report of the SCons version indicates that both Python and SCons are ready for use. | The report of the SCons version indicates that both Python and SCons are ready for use. | ||
| - | Please make sure that you use SCons version **2.0 or newer**, older versions don't work! | + | Please make sure that you use SCons version **2.3 or newer**, older versions don't work! |
| Line 94: | Line 89: | ||
| Under Linux, just use the systems package manager in order to install SCons. | Under Linux, just use the systems package manager in order to install SCons. | ||
| - | The package manager will automatically install SCons and all software that SCons depends on, such as Python. | + | The package manager will automatically install SCons and all software that SCons depends on, such as Python. For example, under Ubuntu: |
| + | <code bash> | ||
| + | > sudo apt-get install scons | ||
| + | </code> | ||
| Line 103: | Line 101: | ||
| On a fresh, newly installed **Ubuntu 8.04 (Hardy Heron)** system, you'll additionally need the following packages. | On a fresh, newly installed **Ubuntu 8.04 (Hardy Heron)** system, you'll additionally need the following packages. | ||
| - | This can be done at the command prompt with the ''apt-get install'' command, or via the easier to use "Synaptic Package Manager" (recommended). | + | They can be installed at the command prompt with the ''apt-get install'' command, or via the easy to use "Synaptic Package Manager". |
| Similar packages and package management systems also exist on RedHat Linux, SuSE, etc., where you can proceed analogously. | Similar packages and package management systems also exist on RedHat Linux, SuSE, etc., where you can proceed analogously. | ||
| Line 109: | Line 107: | ||
| * **build-essential** -- The compiler and basic tools required to compile C and C++ programs. | * **build-essential** -- The compiler and basic tools required to compile C and C++ programs. | ||
| * **libgtk2.0-dev** -- Developer files for GTK 2.0, needed for building wxGTK. | * **libgtk2.0-dev** -- Developer files for GTK 2.0, needed for building wxGTK. | ||
| - | * **libgl1-mesa-dev** and **libglu1-mesa-dev** -- OpenGL developer files, needed for building wxGTK and the Cafu rendering subsystem. On Debian Sarge (3.1), the packages **xlibmesa-gl-dev** and **xlibmesa-glu-dev** used to serve the same purpose, but on newer systems, they have been replaced by the **libgl(u)1-mesa-dev** packages. | + | * **libgl1-mesa-dev** and **libglu1-mesa-dev** -- OpenGL developer files, needed for building wxGTK and the Cafu rendering subsystem. |
| * **libasound2-dev** -- ALSA developer files, needed for building OpenAL-Soft. | * **libasound2-dev** -- ALSA developer files, needed for building OpenAL-Soft. | ||
| Line 121: | Line 119: | ||
| ^ Windows ^ Remarks ^ | ^ Windows ^ Remarks ^ | ||
| - | | Visual<nbsp>C++<nbsp>2010\\ Visual<nbsp>C++<nbsp>2008 | You can use the free Express Editions with Cafu. They are available at [[http://www.microsoft.com/express/vc/]] and automatically install the related Microsoft Windows SDK. | | + | | Visual<nbsp>C++<nbsp>2012\\ Visual<nbsp>C++<nbsp>2010\\ Visual<nbsp>C++<nbsp>2008 | You can use the free Express Editions with Cafu. They are available at [[http://www.microsoft.com/express/vc/]] and automatically install the related Microsoft Windows SDK. | |
| | Visual C++ 2005 | Also suitable for Cafu in its free Express Edition. However, unlike the newer 2010 or 2008 versions, note that the Microsoft Windows SDK must be installed from a separate download in another step. | | | Visual C++ 2005 | Also suitable for Cafu in its free Express Edition. However, unlike the newer 2010 or 2008 versions, note that the Microsoft Windows SDK must be installed from a separate download in another step. | | ||
| | | | | | | | | ||
| Line 140: | Line 138: | ||
| When you do this for the first time, we recommend that you don't bother with ''Cafu/CompilerSetup.py'' at all. Just let the automatisms determine the settings, and come back here later if desired or required. | When you do this for the first time, we recommend that you don't bother with ''Cafu/CompilerSetup.py'' at all. Just let the automatisms determine the settings, and come back here later if desired or required. | ||
| - | === 64-bit Windows with Visual C++ 2010 Express Edition === | + | === 64-bit Windows with Visual C++ 2010 or 2012 Express Editions === |
| + | |||
| + | On 64-bit Windows systems, SCons tries to find a 64-bit compiler, but Visual C++ 2010 Express Edition comes with a 32-bit compiler only. To tell SCons to use the 32-bit compiler instead, please edit file ''Cafu/CompilerSetup.py'' as described [[http://forum.cafu.de/viewtopic.php?p=4360#p4360|here]]. | ||
| - | On 64-bit Windows systems, SCons tries to find a 64-bit compiler, but Visual C++ 2010 Express Edition comes with a 32-bit compiler only. To tell SCons to use the 32-bit compiler instead, please edit file ''Cafu/CompilerSetup.py'' as described [[http://www.cafu.de/forum/viewtopic.php?p=4360#p4360|here]]. | + | Even though the Visual C++ 2012 Express Edition is supposed to come with a 64-bit compiler, at this time unforunately the [[http://forum.cafu.de/viewtopic.php?p=4360#p4360|same edits]] must be done for it as well. |
| Line 217: | Line 217: | ||
| Or you just browse the files and folders in the ''Cafu'' directory, and start with whatever you feel most attracted to. | Or you just browse the files and folders in the ''Cafu'' directory, and start with whatever you feel most attracted to. | ||
| - | In any case, if you have questions or comments, or if you need help, write us a message at the [[http://www.cafu.de/forum/|support forums]] at any time! | + | In any case, if you have questions or comments, or if you need help, write us a message at the [[http://forum.cafu.de|support forums]] at any time! |
cppdev/gettingstarted.txt · Last modified: 2017-01-06 11:33 by Carsten