Difference between revisions of "How to build VCMI (Windows/Cmake)"

From VCMI Project Wiki
Jump to: navigation, search
(Prerequisites)
(Redirected page to How to build VCMI (Windows/Vcpkg))
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Prerequisites =
+
#REDIRECT [[How_to_build_VCMI_(Windows/Vcpkg)]]
* HoMM 3 (can be bought at [http://www.gog.com/en/gamecard/heroes_of_might_and_magic_3_complete_edition/ gog.com])
 
 
 
 
* CMake [https://cmake.org/download/ download]
 
* Git or git GUI, for example, SourceTree [http://www.sourcetreeapp.com/download download]
 
 
 
 
* Qt5 bundle [http://download.qt.io/official_releases/online_installers/qt-unified-windows-x86-online.exe download]
 
* Boost libraries [http://sourceforge.net/projects/boost/files/boost/1.55.0/boost_1_55_0.7z/download download] (<=1.55, Boost 1.56 has error and incompatible)
 
 
 
* Libraries pack ([http://1drv.ms/1mSeRtX download]), which contains
 
** [http://www.ffmpeg.org/download.html FFmpeg]
 
** SDL libraries
 
*** [http://www.libsdl.org/ SDL2]
 
*** [https://www.libsdl.org/projects/SDL_image/ SDL2_image]
 
*** [https://www.libsdl.org/projects/SDL_mixer/ SDL2_mixer]
 
*** [https://www.libsdl.org/projects/SDL_ttf/ SDL2_ttf]
 
** [http://zlib.net/ ZLib]
 
 
 
== Create initial directory ==
 
Create a directory for VCMI development, eg. C:\VCMI
 
We will call this directory as '''[VCMIBUILD_DIR]'''
 
 
 
It is recommended to avoid non-ascii characters in the path to your VCMI development folder. The folder should not be write-protected by system.
 
Good location:
 
* C:\VCMI
 
Bad locations:
 
* C:\Users\Michał\VCMI (non-ascii character)
 
* C:\Program Files (x86)\VCMI (write protection)
 
 
 
= Preparing place =
 
== Clone VCMI ==
 
* open SourceTree
 
* File -> Clone
 
* select '''https://github.com/vcmi/vcmi/''' as source
 
* select '''[VCMIBUILD_DIR]/vcmi/source''' as destination
 
* click '''Clone'''
 
 
 
== Install Qt bundle ==
 
* Run installer
 
* Select latest Qt for mingw and mingw 4.8.2 from tools
 
* Select '''[VCMIBUILD_DIR]/qt''' as destination folder
 
* Install
 
* Add '''[VCMIBUILD_DIR]/Qt/Tools/mingw482_32/bin''' to '''PATH''' system variable.
 
 
 
== Unpack libraries ==
 
* Download libraries pack and unpack it in '''[VCMIBUILD_DIR]/depends''' folder
 
 
 
So, you should get
 
*[VCMIBUILD_DIR]
 
**depends
 
***bin
 
***include
 
***lib
 
***share
 
 
 
= Compiling =
 
== Create toolchain file ==
 
Create [VCMIBUILD_DIR]/toolchain.txt
 
<pre>
 
SET(CMAKE_SYSTEM_NAME Windows)
 
SET(VCMIBUILD_DIR [ENTER YOUR VCMIBUILD_DIR PATH])
 
 
 
SET(CMAKE_C_COMPILER  ${VCMIBUILD_DIR}/Qt/Tools/mingw482_32/bin/gcc.exe)
 
SET(CMAKE_CXX_COMPILER ${VCMIBUILD_DIR}/Qt/Tools/mingw482_32/bin/g++.exe)
 
 
 
SET(ENV{BOOST_ROOT} ${VCMIBUILD_DIR}/boost)
 
 
 
SET(CMAKE_FIND_ROOT_PATH  ${VCMIBUILD_DIR}/depends)
 
list(APPEND CMAKE_PREFIX_PATH ${CMAKE_FIND_ROOT_PATH})
 
list(APPEND CMAKE_PREFIX_PATH ${VCMIBUILD_DIR}/Qt/5.3/mingw482_32)
 
 
 
SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM BOTH)
 
SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
 
SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH)
 
</pre>
 
 
 
== Compile boost ==
 
* Unpack boost archive
 
* Execute
 
<pre>
 
bootstrap.bat mingw
 
b2 toolset=gcc --without-python --stage
 
</pre>
 
* copy '''stage/lib''' to '''[VCMIBUILD_DIR]/boost/lib'''
 
* copy '''boost''' dir to '''[VCMIBUILD_DIR]/boost/boost'''
 
So, you should get
 
*[VCMIBUILD_DIR]
 
**boost
 
***boost
 
***lib
 
 
 
== Compile VCMI ==
 
* Open CMake-gui
 
* Select '''[VCMIBUILD_DIR]/vcmi/source''' as source directory
 
* Select '''[VCMIBUILD_DIR]/vcmi/binary''' as binary directory
 
* click "Configure"
 
* Select "MinGW makefiles" in combobox
 
* Select "Specify toolchain file for crosscompiling"
 
* Select toolchain file
 
* Set variables:
 
** CMAKE_INSTALL_PREFIX = '''[VCMIBUILD_DIR]/vcmi/result'''
 
** ENABLE_PCH = OFF (because of cc1plus.exe crash)
 
* click '''Configure'''
 
* click '''Generate'''
 
* go to '''[VCMIBUILD_DIR]/vcmi/binary''' directory
 
* execute '''mingw32-make'''
 
* execute '''mingw32-make install'''
 
* Grab VCMI in '''[VCMIBUILD_DIR]/vcmi/result''' folder!
 
 
 
= Appendix A. Libraries compilation =
 
== How to compile ZLib yourself ==
 
* Unpack archive to temp folder, for example, '''[VCMIBUILD_DIR]/zlib/src'''
 
* Open CMake-gui
 
* Select '''[VCMIBUILD_DIR]/zlib/src''' as source directory
 
* Select '''[VCMIBUILD_DIR]/zlib/bin''' as binary directory
 
* click "Configure"
 
* Select "MinGW makefiles" in combobox
 
* Select "Specify toolchain file for crosscompiling"
 
* Select toolchain file
 
* Set variables:
 
** INSTALL_BIN_DIR = '''[VCMIBUILD_DIR]/depends/bin'''
 
** INSTALL_INC_DIR = '''[VCMIBUILD_DIR]/depends/include'''
 
** INSTALL_LIB_DIR = '''[VCMIBUILD_DIR]/depends/lib'''
 
** INSTALL_MAN_DIR = '''[VCMIBUILD_DIR]/depends/share/man'''
 
** INSTALL_PKGCONFIG_DIR = '''[VCMIBUILD_DIR]/depends/share/pkgconfig'''
 
* click '''Configure'''
 
* click '''Generate'''
 
* go to '''[VCMIBUILD_DIR]/zlib/bin''' directory
 
* execute '''mingw32-make'''
 
* execute '''mingw32-make install'''
 
 
 
== How to compile FFmpeg yourself ==
 
* Download FFmpeg source tarball([http://www.ffmpeg.org/download.html link]) and unpack it to temp folder, for example, '''[VCMIBUILD_DIR]/ffmpeg/source'''
 
* Download Msys2 ([http://msys2.github.io link]) and install it
 
* Open Msys2
 
* execute <code>pacman -Syu</code> and close Msys2
 
* run <code>autorebase.bat</code> and start Msys2
 
* execute <code>pacman -S make pkg-config yasm</code>
 
* Go to '''/c/[VCMIBUILD_DIR]/ffmpeg/source''' folder
 
* Execute
 
<pre>./configure --disable-doc --target-os=mingw32 --enable-shared --prefix=/c/[VCMIBUILD_DIR]/depends
 
make
 
make install</pre>
 

Latest revision as of 19:50, 19 August 2017