0ct0pu5/wesnoth
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Make the CodeBlocks projectfiles README pretty and not confusing

Browse source 
This streamlining should make it easier for people reading this document
to get started without stumbling upon references to old packages that
aren't useful anymore, and it's also verified to work with the latest
CodeBlocks release (12.11).
This commit is contained in:
Ignacio R. Morelle 2013-10-21 04:29:17 -03:00
parent a3b6759ad0
commit 038e76ee47
1 changed files with 58 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

110
projectfiles/CodeBlocks/README.txt
View file

@ -1,54 +1,60 @@
README.txt
Compiling Wesnoth on Windows using CodeBlocks
---------------------------------------------
Compiling wesnoth on windows using CodeBlocks 10.05
(June 2011, development version 1.9.6+svn r49843,
earlier source versions untested)
updated: r50891, 2011-08-23
updated: 19.06.2013, untested
(Last tested using Wesnoth 1.11.6 on Code::Blocks 12.11.)
(Whenever you enter directories or names, you should do it
by using the "..." button to the right of the field.)
1. Get the source by downloading from from http://www.wesnoth.org/
or by using git (if you know how to). The folder where you put the
source is referred to as wesnoth_root/ in this README.
2. Install CodeBlocks http://www.codeblocks.org/
MinGw is not needed. CodeBlocks' installation folder is referred to as
codeblocks_root/ in this README.
3. Install tdm-gcc-4.5.2 from
http://sourceforge.net/projects/tdm-gcc/files/TDM-GCC Installer/Previous/1.1006.0/
Note that the projectfiles in wesnoth_root/projectfiles/CodeBlocks/
may contain the setting to compile with OpenMP so you should make sure
that this option is enabled while installing the compiler, there is a checkbox
for this in the installer. (Or simply make a "all packages" installation.)
The newest version of tdm-gcc won't work, you need the mentioned one.
4. In CodeBlocks, open
wesnoth_root/projectfiles/CodeBlocks/wesnoth.workspace
5. In CodeBlocks, goto (menu bar)>settings>compiler and debugger
>global compiler settings> (tab) toolchain executables.
In the field "compiler's installation directory", enter the folder
into which you did install tdm-gcc-4.5.2.
Into the fields "c compiler", "c++ compiler" and "linker for dynamic libs"
enter "g++.exe".
Into the field "linker for static libs", enter "ar.exe".
6. Download CodeBlocksWinSDK.zip from
http://www.mediafire.com/?qbibb8p3stb08w7 and extract
this archive so that you have directories codeblocks_root/include_tdm_gcc
and codeblocks_root/lib_tdm_gcc
Newer package versions can be downloaded from
http://sourceforge.net/projects/wesnoth/files/unofficial/Windows%20Compile%20Stuff/
They contain the usual needed headers/libs (.a files)/dlls combination; the exact directory
names may be different, so you need to adapt your settings in CodeBlocks which
reference them. Since dependencies may be added to wesnoth, older packages
may no longer work after some spot.
7. In CodeBlocks, goto (menu bar)>settings>compiler and debugger
>global compiler settings> (tab) search directories> (tab) compiler>Add.
Enter codeblocks_root/include_tdm_gcc.
8. In CodeBlocks, goto (menu bar)>settings>compiler and debugger
>global compiler settings> (tab) search directories> (tab) linker>Add.
Enter codeblocks_root/lib_tdm_gcc.
9. In CodeBlocks, choose (menu bar)>build>build workspace.
wesnoth.exe and wesnothd.exe should appear in wesnoth_root/
when finished building.
10. To be able to execute the program, copy all *.dll files from your
installation folder of the most recent official windows wesnoth development
release into wesnoth_root/.
1. Get a Wesnoth source tarball or Git repository clone. The folder which
contains the data/, projectfiles/, and src/ subfolders is referred to as
wesnoth_root/ in this file.
2. Install CodeBlocks from <http://www.codeblocks.org/>.
MinGW is not needed.
3. Install tdm-gcc-4.5.2 from <http://sourceforge.net/projects/tdm-gcc/files/TDM-GCC Installer/Previous/1.1006.0/>.
Note that the project files in wesnoth_root/projectfiles/CodeBlocks/ may
contain a setting to compile with OpenMP support, so you should make sure
that this option is enabled while installing the compiler (mark the
checkbox for this when choosing components to install).
NOTE: the newest version of tdm-gcc will NOT work; you need the
aforementioned one.
4. Download the latest CodeBlocksWinSDK*.zip package from <http://sourceforge.net/projects/wesnoth/files/unofficial/Windows%20Compile%20Stuff/>.
The package contains the right version/build combination of source headers,
build-time libraries (*.a) and run-time libraries (*.dll) needed to build
and run Wesnoth. Older versions of the package may no longer be useful
after new dependencies are added to Wesnoth or its version requirements
change.
Unpack the file to any path of your choice, which will be referred to as
sdk_root/ for the remainder of this file.
The exact names of the folders containing the required files may vary; take
note of them for the next steps.
5. In CodeBlocks, open wesnoth_root/projectfiles/CodeBlocks/wesnoth.workspace.
6. Go to the Settings -> Compiler option in the menu, and choose the
Global compiler settings -> Toolchain executables tab in the settings
dialog. Enter the following settings into the text boxes:
* Compiler's installation directory: the path to which you installed
tdm-gcc-4.5.2 (click on ... to browse for it).
* C compiler, C++ compiler, Linker for dynamic libs: g++.exe
* Linker for static libs: ar.exe
7. Change to the Search directories -> Compiler tab and choose Add; enter the
path to sdk_root/include_tdm_gcc/.
8. Change to the Search directories -> Linker tab and choose Add; enter the
path to sdk_root/lib_tdm_gcc/.
Close the settings dialog.
9. Choose the Build -> Build workspace option in the CodeBlocks menu. Once
finished, wesnoth.exe and wesnothd.exe should appear in wesnoth_root/.
10. To be able to run your build, copy all *.dll files from the sdk_root/dll/
folder to wesnoth_root/ where the *.exe files are.