lighty-java 26.5.2

Java runtime management for Lighty Launcher
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# 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

```rust,ignore
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`](./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

```mermaid
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]
```

## See also

- [`how-to-use.md`](./how-to-use.md) — install + run a JRE
- [`distributions.md`](./distributions.md) — picking a provider
- [`installation.md`](./installation.md) — `jre_download` walkthrough
- [`runtime.md`](./runtime.md) — `JavaRuntime` API + I/O streaming
- [`events.md`](./events.md) — the eight `JavaEvent` variants
- [`exports.md`](./exports.md) — public API surface
- [`../../event/docs/events.md`](../../event/docs/events.md) — workspace event catalogue