Recent changes to compile

compile modified by col2071

col2071 — Sat, 18 Mar 2017 18:57:32 -0000

--- v3
+++ v4
@@ -4,7 +4,7 @@
 You have the source code ready [GIT switch branch]
 You have installed the compiler [compiler setup]

-First you open the file sourceDLL\DLL_Sources\Colonization Mod Collection.vcxproj
+First you open the file sourceDLL\Project Files\Colonization Mod Collection.vcxproj
 Tip: if you compile frequently (like using DLL develop branch), you may want to make an alias to this file and place it somewhere with easier access, like the desktop.

 Select the type of DLL file you want.

compile modified by Nightinggale

Nightinggale — Thu, 19 Jun 2014 19:44:37 -0000

--- v2
+++ v3
@@ -2,7 +2,7 @@

 Prerequires:
 You have the source code ready [GIT switch branch]
-You have installed the compiler (TODO write page on compiler setup)
+You have installed the compiler [compiler setup]

 First you open the file sourceDLL\DLL_Sources\Colonization Mod Collection.vcxproj
 Tip: if you compile frequently (like using DLL develop branch), you may want to make an alias to this file and place it somewhere with easier access, like the desktop.
@@ -40,4 +40,4 @@

 Error due to a .tmp file: build again. This mysterious error shows up at random and second attempt works.

-Can't find nmake.exe: check last step in compiler setup (TODO write that page)
+Can't find nmake.exe: check last step in [compiler setup]

compile modified by Nightinggale

Nightinggale — Thu, 19 Jun 2014 19:16:19 -0000

--- v1
+++ v2
@@ -9,7 +9,7 @@

 Select the type of DLL file you want.

-(screenshot)
+[[img src=target%20selection.jpg]]

 Types of DLL files:
 - Release: optimized to be as fast as possible. Used for stable releases.
@@ -23,7 +23,7 @@

 Once you have selected target, you build.

-(screenshot of build)
+[[img src=compile.jpg]]

 ... wait

@@ -31,7 +31,7 @@

 1-2 minutes later (on a modern computer) the screen should hopefully look like this.

-(screenshot of done)
+[[img src=compile_complete_small.jpg]]

 If you copied one file twice you managed to compile yourself and the game is ready to be started.

compile modified by Nightinggale

Nightinggale — Thu, 19 Jun 2014 19:10:40 -0000

This page tells how to compile a DLL file. It is assumed that the reader has no prior knowledge and and will be a step by step telling what to click.

Prerequires:
You have the source code ready [GIT switch branch]
You have installed the compiler (TODO write page on compiler setup)

First you open the file sourceDLL\DLL_Sources\Colonization Mod Collection.vcxproj
Tip: if you compile frequently (like using DLL develop branch), you may want to make an alias to this file and place it somewhere with easier access, like the desktop.

Select the type of DLL file you want.

(screenshot)

Types of DLL files:
- Release: optimized to be as fast as possible. Used for stable releases.
- Assert: Same as release, except it adds a whole lot of checks on data from DLL and XML files to find bugs.
- Debug: slow DLL only used by coders. Can examine code behavior while playing and is perfect for bug and crash examination.
- Profile: (rarely used) DLL used to monitor time spend in each line of code. Used to find places where performance can be improved.

Some targets have -fast in their names. -fast mean the compiler will use all CPU cores when compiling instead of just one and hence compile faster. The result should be the same regardless of using -fast or not.

Assert-fast should be the number one choice for anybody compiling code from git. Even if you don't change anything yourself, it may find bugs made by other people.

Once you have selected target, you build.

(screenshot of build)

... wait

......wait

1-2 minutes later (on a modern computer) the screen should hopefully look like this.

(screenshot of done)

If you copied one file twice you managed to compile yourself and the game is ready to be started.

Common errors:
File didn't copy: quit the game and build again.

Error due to a .tmp file: build again. This mysterious error shows up at random and second attempt works.

Can't find nmake.exe: check last step in compiler setup (TODO write that page)