Building from Source

Building from Source

Getting Started	Using the App	Technical Reference	Project
Home	Usage Guide	Architecture	Repository
Installation	Conversion Methods	XDVDFS Technical Docs	Building from Source
	XISO Explorer	Troubleshooting & FAQ	Release Notes

---

Prerequisites

Requirement	Notes
Windows 10/11 (x64 or ARM64)	WPF application; Windows-only
.NET 10 SDK	Matches the net10.0-windows target; global.json pins the required SDK version
Git	To clone the repository

Verify your SDK:

dotnet --version

Cloning

git clone https://github.com/purelogiccode/XboxIsoStudio.git
cd XboxIsoStudio

Building

Build the full solution (application + test project):

dotnet build CSharp_XboxIsoStudio.sln

Or build and run the application directly:

dotnet run --project XboxIsoStudio

Bundled Helper Tools

XISO conversion is performed by the XISOSharp NuGet package — no conversion binaries are bundled. The application project still bundles Windows helper executables that are copied to the output directory on every build:

• 7za.exe, 7za_arm64.exe — 7-Zip CLI fallback for archive extraction

These are committed to the repository, so no extra download steps are needed.

Running the Tests

The test suite uses xUnit with Moq:

dotnet test CSharp_XboxIsoStudio.sln

The suite covers models, services (orchestrator, XISO conversion, integrity, extractor, movers, path helpers, update checker, and more).

Code Analysis

Both projects enforce analyzer rules (Meziantou.Analyzer, Roslynator) as build warnings. Treat new warnings in changed code as errors in practice — keep the build clean.

Publishing a Release Build

Example for a framework-dependent x64 publish:

dotnet publish XboxIsoStudio -c Release -r win-x64 --self-contained false

For a self-contained single-folder build (no .NET runtime requirement for end users):

dotnet publish XboxIsoStudio -c Release -r win-x64 --self-contained true

Use -r win-arm64 for ARM64 builds. Ensure the bundled executables end up next to the published XboxIsoStudio.exe.

Project Notes

• Target framework: net10.0-windows with <UseWPF>true</UseWPF>.
• Nullable + implicit usings are enabled.
• The References/ folder (vendored sources such as the xdvdfs Rust workspace, if present) is excluded from compilation.
• Version numbers are maintained in XboxIsoStudio.csproj (AssemblyVersion / FileVersion); the update checker compares against GitHub release tags.