Skip to content

Building Bloxstrap from source

pizzaboxer edited this page Mar 15, 2023 · 19 revisions

These are instructions for people who want to compile and build the source code for contributing, debugging, etc. If you simply just want to download and install Bloxstrap, see the Installing section in the README.

First, download the source repository using your method of choice (git clone, GitHub Desktop, as a zip archive, etc).

From there, there's two ways to build the source code. If you don't already have Visual Studio installed, it's recommended to just build with .NET CLI.

Note that these instructions are for building a release binary. Otherwise, you can just use Visual Studio's debugging tools.

Build with Visual Studio

Open Bloxstrap.sln in Visual Studio, right-click the Bloxstrap project in the Solution Explorer, and select 'Publish'. Configure your build options if you need to (you shouldn't have to change anything), and click 'Publish'.

You can choose between compiling for x64 and x86 by changing the selected .pubxml config.

image image

Build with .NET CLI

If you don't have Visual Studio installed, you can just download and install the .NET 6 SDK for this one.

Open a terminal, and set your location to the folder containing Bloxstrap.sln. Then, run the following command:

> dotnet publish /p:PublishProfile=Publish-x64

To build for x86, change Publish-x64 to Publish-x86.

If you need to configure any build options, run dotnet help publish to learn how to configure options for publishing.

After you've finished building

Navigate to the Bloxstrap folder (the one containing Bloxstrap.csproj), where the compiled binaries are located in bin\Release\net6.0-windows\publish. From there, you can either run and install it fresh, or copy it into your Bloxstrap install location.

image

If you've come this far, you may also want to disable automatic updating for convenience.

Clone this wiki locally