Differences

This shows you the differences between two versions of the page.

--- outposthd:building_from_source [2019/11/18 04:31] – created leeor_net
+++ outposthd:building_from_source [2021/02/19 04:25] (current) – leeor_net
@@ Line 9: / Line 9: @@
 First and foremost, OutpostHD is built mostly on Windows using [[https://visualstudio.microsoft.com/downloads/|Visual Studio 2019]]. The Community Edition is free and has all the tools needed to build and debug OutpostHD.
-During installation, be sure to select the C++, Git, GitHub Extension and NuGet Package Manager in the Individual Components tab. You'll need all of these.
+During installation, be sure to select the C++, Git and GitHub Extension in the Individual Components tab. You'll need all of these.
 {{ :outposthd:vs2019_install_git.png?nolink |}}
@@ Line 19: / Line 19: @@
 ==== vcpkg ====
-In addition to NuGet, some of the dependencies for OutpostHD are only available via vcpkg, a very powerful command line package management system. It is not installed with Visual Studio so you'll need to get it set up manually.
+See [[outposthd:vcpkg|Setting up vcpkg]] for complete install instructions.
-To begin, open a command prompt with administrator privileges. Click on the start button and type in ''cmd''. Right click on ''Command Prompt'' and click ''Run as administrator''.
+All of the dependencies for OutpostHD are available via vcpkg, a very powerful command line package management system. It is not installed with Visual Studio so you'll need to get it set up manually.
-{{ :outposthd:cmd_admin.png?nolink |}}
+===== Cloning the Repository =====
+After you have Visual Studio, Git and vcpkg installed, we're now ready to clone the OutpostHD repository and build.
-When asked, click ''Yes'' and a command prompt will open up.
+To do this, click on the Clone Repository button.
-{{ :outposthd:cmd_admin.png?nolink |}}
+{{ :outposthd:vs2019_clone_repository.png?nolink |}}
-You can install vcpkg anywhere you want. To make it easy, I'm going to install it in //C:\vcpkg//. To do that, you'll need to create the directory.
+Next, copy the GitHub URL for the OutpostHD repository, ''https://github.com/OutpostUniverse/OPHD.git'', into the //Repository location// and set a location somewhere on your machine that you can easily access. Here I used ''C:\Repos\OPHD'' but you can put it anywhere. Finally, click Clone. After a few moments you'll see the OutpostHD project directory:
-Enter the following commands pressing ''enter'' after every line:
+{{ :outposthd:vs2019_clone_repository3.png?direct&600 |}}
-<code>
+The Visual Studio solution file will be in the root directory and the source code will be in a folder labeled 'OPHD'.
-cd..
-cd..
-cls
-</code>
-You will now be at the root directory of the C:\ drive (or whatever is your primary disk, usually C:\ but sometimes other letters). Anyway, now we need clone the vcpkg git repository. Type ''git clone https://github.com/microsoft/vcpkg.git'' and press ''enter''. Assuming Git is installed properly, the vcpkg repository will be cloned into C:\vcpkg. Now type ''cd vcpkg'' and press ''enter'' to change to the vcpkg directory.
+{{ :outposthd:vs2019_clone_repository4.png?direct&600 |}}
-{{ :outposthd:cmd_git_clone2.png?nolink |}}
+===== Installing NAS2D =====
-Next you'll type ''bootstrap-vcpkg'' and press ''enter''. It will take a few minutes for vcpkg to builds itself. After it finishes your prompt should look like this:
+NAS2D now comes packaged with OutpostHD as a Git Submodule and is included in the OPHD solution. When you build OutpostHD, NAS2D will be built first. It will only be rebuilt if changes are made to NAS2D or if you clean/rebuild the solution.
-{{ :outposthd:cmd_vcpkg_build.png?nolink |}}
+===== Installing the Data Assets =====
-Next we need to integrate vcpkg with Visual Studio. To do this, type ''vcpkg integrate install'' and press ''enter''. This will take a minute or two. When the process completes, we need to install the PhysFS and GLEW packages.
+The data assets are now set up as a submodule of OPHD much like NAS2D.
-We're almost done, we're in the home stretch! Type ''vcpkg install glew:x86-windows glew:x64-windows physfs:x86-windows physfs:x64-windows'' and press ''enter''. This will proceed to download and install the 32-bit and 64-bit versions of the GLEW and PhysFS libraries. This process will take awhile, so just hang out and wait for the process to complete.
-{{ :outposthd:cmd_vcpkg_install_libs.png?nolink |}}
-And that's it! vcpkg and the dependencies that OutpostHD will require are installed! You can see on my machine it took about 5 minutes to build but on my laptop it took 20 minutes. You can just let the process work in the background and you're done.