Skip to content

Building

BlueShank edited this page Sep 1, 2026 · 4 revisions

The repository ships no build scripts.
What it ships is a premake5.lua that generates the projects, and CI runs the exact steps below in the build workflows.
Building manually is therefore the same as what CI does.

Requirements

  • Premake5, on your PATH or in the repository root.
  • Windows: Visual Studio 2022 with the MSBuild toolset (CI uses windows-latest + setup-msbuild).
  • Linux: build-essential and uuid-dev (CI uses Ubuntu 22.04):
sudo apt-get update
sudo apt-get install -y build-essential uuid-dev

What gets built

Premake generates four projects, one per side and architecture:

Project Output Built with
plugin_crashcapture86_sv server, x86 INTERFACE_PLUGIN
plugin_crashcapture64_sv server, x64 INTERFACE_PLUGIN
plugin_crashcapture86_cl client, x86 INTERFACE_PRELOAD
plugin_crashcapture64_cl client, x64 INTERFACE_PRELOAD

Configurations are Debug and Release.
Artifacts land in bin/<arch>/<config>/ (for example bin/x64/Release/).

Windows

Generate the Visual Studio solution, then build it (this mirrors windows-x64.yml):

premake5 vs2022
cd build
msbuild plugin_crashcapture64_sv.sln /p:Configuration=Release
  • Swap the solution name for plugin_crashcapture64_cl.sln, plugin_crashcapture86_sv.sln or plugin_crashcapture86_cl.sln for the other targets.
  • Configuration is Debug or Release.

Linux

Generate the makefiles, then build (this mirrors linux-x64.yml):

premake5 gmake
cd build
make -f plugin_crashcapture64_sv.make config=release_x64
  • Swap the makefile name for plugin_crashcapture64_cl.make, plugin_crashcapture86_sv.make or plugin_crashcapture86_cl.make for the other targets.
  • config is debug_x64, release_x64, debug_x86 or release_x86.

Getting Premake5

Any recent release works:

  • Windows: download the premake zip from the premake-core releases and unpack premake5.exe next to the project (this is what CI does).
  • Linux: download a release binary, or bootstrap it from source the way CI does:
git clone --depth=1 https://github.com/premake/premake-core.git
cd premake-core
make -f Bootstrap.mak linux
mv ./bin/release/premake5 /path/to/plugin_crashcapture/

Clone this wiki locally