Building from Source

Building XGDTool from Source

This guide covers building all three targets (XGDTool-GUI, XGDTool-CLI, and XGDTool-Android) from source on Windows and Linux.

---

Prerequisites

Windows Desktop (GUI & CLI)

• OS: Windows 10 / 11 (x64)
• Compiler: Visual Studio 2022 (with "Desktop development with C++" workload)
• Build System: CMake 3.22+ and MSBuild or Ninja
• Package Manager: vcpkg (automatically bootstrapped during build)
• Dependencies: wxwidgets (for GUI), zstd, lz4, openssl, curl, nlohmann-json, cli11

Android (APK)

• Android Studio: Ladybug / Iguana or command-line SDK
• JDK: OpenJDK 17 or higher
• Android SDK: Build-tools 34.0.0, SDK Platform 34
• Android NDK: r27 LTS (27.2.12479018) or newer
• Gradle: 8.7+ (included via Gradle Wrapper gradlew)

---

Building on Windows

Clone the repository and submodules recursively:

git clone --recursive https://github.com/Ashnar2602/XGDTool.git
cd XGDTool

1. Build Full Desktop GUI (XGDTool-GUI.exe)

cmake -B build -S .
cmake --build build --config Release -j

• Executable output: build/Release/XGDTool.exe (distributable as XGDTool-GUI.exe).

2. Build Lean Command-Line Executable (XGDTool-CLI.exe)

cmake -B build_cli -S . -DENABLE_GUI=OFF
cmake --build build_cli --config Release -j

• Executable output: build_cli/Release/XGDTool.exe (distributable as XGDTool-CLI.exe).

---

Building Android APK

Open PowerShell or terminal in the android/ directory:

cd android
.\gradlew.bat assembleRelease

• Release APK output: android/app/build/outputs/apk/release/app-release.apk.
• To install directly to a connected device via ADB:

adb install -r app/build/outputs/apk/release/app-release.apk

---

Building on Linux

Install required development packages:

sudo apt-get update
sudo apt-get install -y cmake g++ libwxgtk3.2-dev liblz4-dev libzstd-dev libssl-dev libcurl4-openssl-dev

Configure and compile CLI:

cmake -B build_cli -S . -DENABLE_GUI=OFF
cmake --build build_cli -j$(nproc)