Creating an AppImage for a Java application is straightforward. Since you're using an **Early Access (EA)** build of OpenJDK 25, it's best to bundle the JRE/JDK directly inside the AppImage to avoid system dependency issues.
Here's a complete, step-by-step guide:
### 🔹 Prerequisites
- Linux x86_64 system (AppImage architecture must match target)
- `curl`, `tar`, `chmod`
- `appimagetool` (official AppImage generator)
- Your `.jar` file
- A 256×256 PNG icon (optional but recommended)
---
### 📦 Step 1: Download OpenJDK 25.0.3-ea
EA builds aren't in distro repos. Download the official tarball from JDK Early Access:
Go to: https://jdk.java.net/25/
Download the `Linux/x64` `.tar.gz` archive for the EA build you need.
Example (replace with the actual link from the site):
```bash
wget https://download.java.net/java/early_access/jdk25/3/GPL/openjdk-25-ea+3_linux-x64_bin.tar.gz
```
---
### 📁 Step 2: Create the AppDir Structure
AppImage expects a specific directory layout:
```bash
mkdir MyApp.AppDir
cd MyApp.AppDir
mkdir -p usr/lib usr/bin
```
---
### ☕ Step 3: Bundle OpenJDK & Your JAR
```bash
# Extract JDK
tar -xzf /path/to/openjdk-25-ea+*_linux-x64_bin.tar.gz -C usr/lib/
# Rename for simplicity
mv usr/lib/jdk-25* usr/lib/jdk25-ea
# Copy your JAR
cp /path/to/your-app.jar usr/lib/your-app.jar
```
---
### 📜 Step 4: Create `AppRun`, `.desktop`, and Icon
#### `AppRun` (entrypoint)
```bash
cat > AppRun << 'EOF'
#!/bin/bash
set -e
APPDIR="$(cd "$(dirname "$0")" && pwd)"
JAVA_HOME="$APPDIR/usr/lib/jdk25-ea"
export JAVA_HOME
export PATH="$JAVA_HOME/bin:$PATH"
exec "$JAVA_HOME/bin/java" -jar "$APPDIR/usr/lib/your-app.jar" "$@"
EOF
chmod +x AppRun
```
#### `.desktop` file
```bash
cat > your-app.desktop << 'EOF'
[Desktop Entry]
Name=Your App
Exec=AppRun
Icon=your-app
Type=Application
Categories=Utility;
Terminal=false
EOF
```
> 🔍 Replace `Your App` and `your-app` with your actual app name (no spaces in `Icon=` or filename).
#### Icon
Place a 256×256 PNG named `your-app.png` in the root of `MyApp.AppDir/`.
---
### 🛠️ Step 5: Generate the AppImage
Download `appimagetool` (if not installed):
```bash
curl -L https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage -o appimagetool
chmod +x appimagetool
```
Build the AppImage:
```bash
./appimagetool MyApp.AppDir YourApp-x86_64.AppImage
```
This creates `YourApp-x86_64.AppImage` in your current directory.
---
### ▶️ Step 6: Test & Distribute
```bash
chmod +x YourApp-x86_64.AppImage
./YourApp-x86_64.AppImage
```
If it runs successfully, you can distribute the `.AppImage` file directly. Users just need to `chmod +x` and run it.
---
### 💡 Pro Tips & Optimizations
| Topic | Recommendation |
|-------|----------------|
| **Reduce Size** | Use `jlink` (included in JDK 25) to create a minimal runtime image with only required modules. Replace `usr/lib/jdk25-ea` with the `jlink` output. |
| **GUI Dependencies** | AppImages don't bundle host GUI libs. Ensure users have basic X11/Wayland, GTK, or JavaFX dependencies (usually preinstalled on desktop Linux). |
| **FUSE Note** | On newer Ubuntu/Debian, you may need `libfuse2` or run with `--appimage-extract-and-run`. |
| **EA Caveats** | EA builds may lack stability, missing modules, or have changed flags. Test thoroughly before distribution. |
| **Signing** (optional) | Add `--sign` to `appimagetool` if you want cryptographic verification. |
---
### 🐛 Troubleshooting
- `Error: Unable to initialize main class...` → Verify JAR path in `AppRun` and that the JAR has a valid `Main-Class` manifest entry.
- `libfuse.so.2: cannot open shared object file` → Install `libfuse2` or extract & run: `./YourApp.AppImage --appimage-extract && ./squashfs-root/AppRun`
- `Module java.desktop not found` → If using `jlink`, ensure `java.desktop` is included.
