RetroShare/build_scripts/Windows-msys2/WindowsMSys2_InstallGuide.md

## Compilation on Windows

The preferred build method on Windows is by using MSYS2 which is a collection
of packages providing unix-like tools to build native Windows software.

Requirements: about 12 GB of free space

The resulting binary is a 32-bit build of Retroshare which will also work
fine on a 64-bit system.

**If you want to make complet solution without debugging it, prefer to use \build_scripts\Windows-msys2\build.bat**

This batch will install and build all for you.

You only have to clone this repository (with [git for windows](https://gitforwindows.org/)) to a local folder, then start it in a terminal.

At the end, you'll get at ..\\*-msys2\deploy\ the Portable 7zip file.

### MSYS2 INSTALLATION (for editing or debugging)

Download MSYS2 from [MSYS2](http://www.msys2.org/). Get the i686 version
if you run a 32-bit Windows or the x86_64 if you run a 64-bit Windows.

Run the installer and install MSYS2.

At the end of the installation, it'll automatically open an MSYS shell terminal.
You can also find it on the start menu as MSYS2 MSYS. This is the shell you'll 
use to install packages with pacman and do maintenance but NOT to build
RetroShare.

First, update your MSYS2 environment to the latest version by typing:

	pacman -Syu

Close the terminal window.

Run MSYS2 MSYS again and finish updating with:

	pacman -Su

Install the default programs needed to build:

	pacman -S base-devel git wget p7zip gcc perl ruby python2 doxygen cmake

Install the 32-bit toolchain:

	pacman -S mingw-w64-i686-toolchain

Install all needed dependencies:

	pacman -S mingw-w64-i686-miniupnpc
	pacman -S mingw-w64-i686-libmicrohttpd
	pacman -S mingw-w64-i686-libxslt
	pacman -S mingw-w64-i686-xapian-core
	pacman -S mingw-w64-i686-sqlcipher
	pacman -S mingw-w64-i686-qt5
	pacman -S mingw32/mingw-w64-i686-cmake
	pacman -S mingw-w64-i686-rapidjson

If you want to use QtCreator as IDE, prefer using this one publish by MSYS2 as all build Kit are already setted.

	pacman -S mingw-w64-i686-qt-creator
*You can start it from MSYS2 terminal.*


We're done installing MSYS2, close the shell terminal.

### BUILDING RETROSHARE

Now run the MSYS2 MinGW 32-bit shell terminal (it's in the start menu).
We will use it to checkout Retroshare and build it:

	git clone https://github.com/RetroShare/RetroShare.git

Go to the RetroShare directory and configure to your liking, for example:
	
	cd RetroShare
	qmake -r -Wall -spec win32-g++ "CONFIG+=debug" "CONFIG+=rs_autologin"

Now we're ready to build Retroshare. Use the '-j' option with the number of
cores you have for a faster build, for instance if you have 4 cores:

	mingw32-make -j4

Make sure your current Retroshare is not running. Then just run:

	retroshare-gui/src/debug/retroshare.exe

You'll get debug output in the terminal and a running Retroshare instance.