From 3a1d2baedd11e3a620b5479d9ca11afcf91eaacf Mon Sep 17 00:00:00 2001 From: Sky Date: Sun, 22 Sep 2013 15:56:14 +0100 Subject: [PATCH 1/3] Add Windows build instructions --- BUILD.md | 50 +++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 49 insertions(+), 1 deletion(-) diff --git a/BUILD.md b/BUILD.md index 2d16380b..7038a919 100644 --- a/BUILD.md +++ b/BUILD.md @@ -56,7 +56,55 @@ Congrats. Your MMC5 should run ## Windows -*In work* +Getting the project to build and run on Windows is easy if you use Qt's IDE, Qt Creator. The project will simply not compile using VC's build tools as it uses some C++11 features that aren't implemented in it at the time of writing. + +### Dependencies +* Qt 5.1.1+ Development tools (http://qt-project.org/downloads) ("Qt Online Installer for Windows") +* OpenSSL (http://slproweb.com/products/Win32OpenSSL.html) ("Win32 OpenSSL v1.0.1e Light") + - Microsoft Visual C++ 2008 Redist. is required for this, there's a link on the OpenSSL download page above next to the main download. +* CMake (http://www.cmake.org/cmake/resources/software.html) ("Windows (Win32 Installer)") +* A copy of the MultiMC source (clone it with git) + +### Getting set up + +#### Installing Qt +1. Run the Qt installer +2. Choose a place to install Qt (C:\Qt is the default), +3. Choose the components you want to install + - You need Qt 5.1.1/MinGW 4.8 (32 bit) ticked, + - You need Tools/Qt Creator ticked, + - Other components are selected by default, you can untick them if you don't need them. +4. Accept the license agreements, +5. Double check the install details and then click "Install" + - Installation can take a very long time, go grab a cup of tea or something and let it work. + +#### Installing OpenSSL +1. Run the OpenSSL installer, +2. It's best to choose the option to copy OpenSSL DLLs to the /bin directory + - If you do this you'll need to add that directory (the default being C:\OpenSSL-Win32\bin) to your PATH system variable (Google how to do this, or use this guide for Java: http://www.java.com/en/download/help/path.xml). + +#### Installing CMake +1. Run the CMake installer, +2. It's easiest if you choose to add CMake to the PATH for all users, + - If you don't choose to do this, remember where you installed CMake. + +#### Loading the project +1. Open Qt Creator, +2. Choose File->Open File or Project, +3. Navigate to the MultiMC5 source folder you cloned and choose CMakeLists.txt, +4. Read the instructions that just popped up about a build location and choose one, +5. If you chose not to add CMake to the system PATH, tell Qt Creator where you installed it, + - Otherwise you can skip this step. +6. You should see "Run CMake" in the window, + - Make sure that Generator is set to "MinGW Generator (Desktop Qt 5.1.1 MinGW 32bit)", + - Hit the "Run CMake" button, + - You'll see warnings and it might not be clear that it succeeded until you scroll to the bottom of the window. + - Hit "Finish" if CMake ran successfully. +7. Cross your fingers and press the Run button (bottom left of Qt Creator)! + - If the project builds successfully it will run and the MultiMC5 window will pop up, + - Test OpenSSL by making an instance and trying to log in. If Qt Creator couldn't find OpenSSL during the CMake stage, login will fail and you'll get an error. + +*These build instructions worked for me (Drayshak) on a fresh Windows 8 x64 Professional install. If they don't work for you, let us know on IRC!* ## OSX From f9601395fa9ee99e35c49e17e5f2a1332d704799 Mon Sep 17 00:00:00 2001 From: Sky Date: Sun, 22 Sep 2013 16:02:01 +0100 Subject: [PATCH 2/3] Fix Windows link in build instructions --- BUILD.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/BUILD.md b/BUILD.md index 7038a919..85e9e8d7 100644 --- a/BUILD.md +++ b/BUILD.md @@ -3,7 +3,7 @@ Build on... * [Linux](#linux) -* [Windows](#win) +* [Windows](#windows) * [OSX](#osx) ## Linux @@ -54,7 +54,7 @@ cd run # or whereever its stored Congrats. Your MMC5 should run -## Windows +## Windows Getting the project to build and run on Windows is easy if you use Qt's IDE, Qt Creator. The project will simply not compile using VC's build tools as it uses some C++11 features that aren't implemented in it at the time of writing. From 7016cb9a979c48958b863e72537b47578eebef1f Mon Sep 17 00:00:00 2001 From: Sky Date: Sun, 22 Sep 2013 16:03:33 +0100 Subject: [PATCH 3/3] Add IRC location to build instructions --- BUILD.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/BUILD.md b/BUILD.md index 85e9e8d7..7dfdede7 100644 --- a/BUILD.md +++ b/BUILD.md @@ -104,7 +104,7 @@ Getting the project to build and run on Windows is easy if you use Qt's IDE, Qt - If the project builds successfully it will run and the MultiMC5 window will pop up, - Test OpenSSL by making an instance and trying to log in. If Qt Creator couldn't find OpenSSL during the CMake stage, login will fail and you'll get an error. -*These build instructions worked for me (Drayshak) on a fresh Windows 8 x64 Professional install. If they don't work for you, let us know on IRC!* +*These build instructions worked for me (Drayshak) on a fresh Windows 8 x64 Professional install. If they don't work for you, let us know on IRC (Esper/#MultiMC)!* ## OSX