Building from source

Building from source

You can build this fork from source to make your own changes or for any other reason.

Prerequisites

1. You need the .NET CLI to build and publish the application.
2. It is recommended to have Git installed on your system for convenience.

Instructions

1. Clone the repository.

   It's recommended to use Windows to build Bloxstrap.

   cd <directory you want to put the files in>
   git clone -b main https://github.com/its-mrarsikk/bloxstrap.git
   cd bloxstrap

   You will now have all the files in the main branch.

2. Use dotnet publish.

   Run the following command:

   dotnet publish -p:PublishSingleFile=true -p:CommitHash=<commit hash> -p:CommitRef=<commit ref> -p:BaseVersion=<base version> -p:IsReleaseBuild=false -r win-x64 -c Release --self-contained false .\Bloxstrap\Bloxstrap.csproj

   • Replace <commit hash> and <commit ref> with their actual values, which can be obtained with git rev-parse HEAD and git symbolic-ref --short HEAD respectively. If you don't want them in the final build, omit the -p statements or use placeholder values.
   • Replace <base version> with the base version of Bloxstrap you're building with. This is important to set to the actual value, as an incorrect one may throw off some checks.
   • You can also adjust PublishSingleFile to control whether the output will be a single EXE, and IsReleaseBuild to control whether the app will think it's a release build.

3. Run the application

   Change your directory to Bloxstrap\bin\Release\net6.0-windows\win-x64\publish (assuming you're in the root folder of the repo). You should see Bloxstrap.exe, PDB files and licenses. Run the .exe.