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 [2013-10-20 12:20] Carsten Clarified installation instructions for Git and SCons under Linux |
cppdev:gettingstarted [2016-08-06 14:22] Carsten remove obsolete section "Downloading a Compressed Archive" |
||
|---|---|---|---|
| Line 11: | Line 11: | ||
| 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 it out from its Git 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 ''gz'' or ''bz2'' archive type, 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 110: | 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 116: | 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 128: | 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 147: | 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 224: | 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