Skip to content
Ashlane

Guide, SDK 3.4.0, updated 28 October 2026

Launcher SDK

The SDK handles the part of a launcher that is easy to get nearly right: installing, updating and repairing a game on a player's disk, over a bad connection, without corrupting it.

Install

LanguagePackageNotes
C++17ashlane-launcher via CMake or vcpkgStatic or shared, no exceptions required
C#Ashlane.Launcher on NuGet.NET 8 and later, Unity 2022.3 and later
Rustashlane-launcher on crates.ioAsync, tokio runtime

Update an install

Planning and applying are separate calls so your launcher can show the download size and ask before it starts.

ashlane::Client c({.endpoint = "https://n74.assetlines.net", .title = "hollowmere"});
auto plan = c.plan_update(install_dir, "live");
if (plan.bytes_to_download > 0) {
  c.apply(plan, [](const ashlane::Progress& p) {
    ui::set_bar(p.bytes_done, p.bytes_total);   // post-delta, post-compression
  });
}

What the SDK guarantees

  • Atomic updates. New files are written beside the old ones and swapped when every chunk verifies. A power cut mid-update leaves the previous version playable.
  • Resumable downloads. Chunks are checked individually, so a resume continues at the next missing chunk, not at the start of a file.
  • Verified installs. Every file is checked against the signed manifest. verify() reads from disk only; repair() downloads just the chunks that do not match.
  • Polite bandwidth. Set a cap in bytes per second, or use Throttle::Adaptive to back off when other traffic on the link gets slow.

Settings you will probably change

OptionDefaultMeaning
max_connections6Parallel HTTP/3 streams per site
min_free_space1.2x downloadRefuses to start below this
keep_previousfalseKeeps the old version for rollback until the next launch
channellivelive, beta or internal
New in 3.4.0: if the disk fills mid-install, the SDK pauses with Error::DiskFull, keeps every verified chunk, and resumes once space is available.