lighty-java 0.8.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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

# lighty-java


Java runtime management for [LightyLauncher](https://crates.io/crates/lighty-launcher).

## Note


This is an internal crate for the LightyLauncher ecosystem. Most users should use the main [`lighty-launcher`](https://crates.io/crates/lighty-launcher) crate instead.

## Features


- **Automatic JRE Download**: Download and install Java runtimes on demand
- **Multiple Distributions**: Support for Temurin, GraalVM, Zulu, and Liberica
- **Version Detection**: Detect required Java version for Minecraft
- **Cross-Platform**: Windows, Linux, and macOS support

## Usage


```toml
[dependencies]
lighty-java = "0.6.3"
```

```rust
use lighty_java::{JavaDistribution, jre_downloader};
use directories::ProjectDirs;

#[tokio::main]

async fn main() {
    let launcher_dir = ProjectDirs::from("com", "MyLauncher", "").unwrap();

    // Download Java 21 (Temurin)
    let java_path = jre_downloader::jre_download(
        21,
        JavaDistribution::Temurin,
        &launcher_dir
    ).await?;

    println!("Java installed at: {}", java_path.display());
}
```

## Structure


```
lighty-java/
└── src/
    ├── lib.rs              # Module declarations and re-exports
    ├── distribution/       # Java distribution providers
    │   ├── mod.rs          # Distribution types and main API
    │   ├── api_models.rs   # API response structures
    │   ├── utils.rs        # Shared utilities
    │   └── providers/      # Individual distribution providers
    │       ├── temurin.rs  # Adoptium Temurin provider
    │       ├── graalvm.rs  # Oracle GraalVM provider
    │       ├── zulu.rs     # Azul Zulu provider
    │       └── liberica.rs # BellSoft Liberica provider
    ├── jre_downloader.rs   # Download and install JRE
    ├── runtime.rs          # Java version detection and validation
    └── errors.rs           # Error types for Java operations
```

## Supported Distributions


### Temurin (Recommended)


Eclipse Temurin - OpenJDK builds from the Adoptium project.

```rust
use lighty_java::JavaDistribution;

let distribution = JavaDistribution::Temurin;
```

**Supported Versions**: 8, 11, 17, 21
**Best for**: General use, maximum compatibility

### GraalVM


GraalVM - High-performance JDK with advanced optimizations.

```rust
use lighty_java::JavaDistribution;

let distribution = JavaDistribution::GraalVM;
```

**Supported Versions**: 17, 21
**Best for**: Modern Minecraft versions (1.17+), maximum performance

### Zulu


Azul Zulu - OpenJDK builds with enterprise support available.

```rust
use lighty_java::JavaDistribution;

let distribution = JavaDistribution::Zulu;
```

**Supported Versions**: 8, 11, 17, 21
**Best for**: Enterprise environments, certified builds

### Liberica


BellSoft Liberica - Lightweight OpenJDK distribution.

```rust
use lighty_java::JavaDistribution;

let distribution = JavaDistribution::Liberica;
```

**Supported Versions**: 8, 11, 17, 21
**Best for**: Resource-constrained systems, lightweight deployments

## Platform Support


| Platform | Architectures | Status |
|----------|---------------|--------|
| Windows  | x64, ARM64    | Tested |
| Linux    | x64, ARM64    | Tested |
| macOS    | x64, ARM64    | Tested |

## License


MIT

## Links


- **Main Package**: [lighty-launcher](https://crates.io/crates/lighty-launcher)
- **Repository**: [GitHub](https://github.com/Lighty-Launcher/LightyLauncherLib)
- **Documentation**: [docs.rs/lighty-java](https://docs.rs/lighty-java)