These are instructions for developing and building the source code so that you may contribute, debug it, and more. If you simply want to download and install Bloxstrap, go to the Installing portion of the README. If you need a build from a commit that hasn’t been released yet, get a build artifact from GitHub Actions.
It should be noted that this is possible on Windows, however it requires the.NET Desktop Runtime.
To begin, download the source repository using either git clone or GitHub Desktop. Avoid downloading it as a ZIP archive, as you’ll encounter issues without using git.
> git clone https://github.com/pizzaboxer/bloxstrap.git
> cd bloxstrap
> git submodule init
> git submodule update
After downloading the repository, there are two ways to build the source code. If you don’t have Visual Studio installed, it’s better to build it using .NET CLI.
These instructions are for generating a release binary. If you are not doing this, you can simply use Visual Studio’s debugging tools.
Build with Visual Studio
Note: Publishing through Visual Studio isn’t working properly on the main branch right now. It should be fixed on the version-2.6.0-contingency branch. If you’re still having trouble, please open an issue.
Open Bloxstrap.sln in Visual Studio, then right-click the Bloxstrap project in the Solution Explorer, and choose ‘Publish’. If needed, adjust your build options (though you probably won’t need to change anything), and click ‘Publish’.
Build with .NET CLI
If you do not have Visual Studio installed, you can download and install the.NET 6 SDK instead.
Open a terminal and go to the folder containing Bloxstrap.sln. Then execute the following command:
> dotnet publish /p:PublishProfile=Publish-x64
If you need to set up any build options, use the command dotnet help publish to find out how to do it for publishing.
After you’ve finished building
Go to the Bloxstrap folder (the one with Bloxstrap.csproj) where the compiled files are in bin\Release\net6.0-windows\publish. From there, you can either run and install it as new, or copy it to your Bloxstrap installation folder.
If you’ve come this far, you might want to turn off automatic updates for convenience.