Skip to content

overview.md

Latest commit

 

History

History
72 lines (57 loc) · 2.45 KB

overview.md

File metadata and controls

72 lines (57 loc) · 2.45 KB

lighty-java

JRE provisioning + Java process spawn for LightyLauncher. Two responsibilities:

  1. Download a JRE from one of four supported distributions (Temurin, GraalVM, Zulu, Liberica), extract it into the launcher cache, locate the java binary.
  2. Spawn a java process with the right arguments and stream its stdout / stderr.

The crate doesn't know about Minecraft — it's a generic JRE installer

  • process runner. lighty-launch calls it after the version manifest is resolved.

What it provides

Module Surface
jre_downloader find_java_binary, jre_download
runtime JavaRuntime::new, execute, handle_io
distribution (private) URL routing per provider — exposed via JavaDistribution::get_download_url
Root JavaDistribution, DistributionSelection, error enums

JavaDistribution

pub enum JavaDistribution { Temurin, GraalVM, Zulu, Liberica }

Each variant maps to a different provider API. The default is Temurin (widest version coverage). See distributions.md for the comparison matrix and known gaps (e.g. no Java 8 for macOS aarch64).

get_fallback(version) -> Option<JavaDistribution> returns a replacement distribution when the current one doesn't publish that (version, OS, arch) combination — the downloader uses this automatically.

Cargo features

Feature Effect
events jre_download accepts Option<&EventBus> and emits JavaEvent::Java*.

Big picture

flowchart LR
    APP[lighty-launch] --> JRE[jre_downloader::jre_download]
    JRE --> DIST[JavaDistribution::get_download_url]
    DIST --> TEMURIN[Adoptium API]
    DIST --> GRAAL[GitHub releases]
    DIST --> ZULU[Azul Foojay API]
    DIST --> LIBERICA[Foojay Disco API]
    JRE --> DL[lighty_core::download_file]
    JRE --> EX[lighty_core::extract]
    APP --> RUN[JavaRuntime::execute]
    RUN --> CHILD[tokio Child]
    APP --> IO[JavaRuntime::handle_io]
Loading

See also