DE
RU
EN
ES
ZH
FR
PT
AR
HI
Einleitung: Kennenlernen des Fehlers, der Anfänger erschreckt
Sie haben ein Java-Programm geschrieben, es kompiliert, in eine JAR-Datei gepackt und versuchen stolz, es per Doppelklick zu starten – aber statt des Anwendungsfensters sehen Sie ein schwarzes Terminalfenster mit der erschreckenden Meldung: Can't execute jar- file: "no main manifest attribute". Kommt Ihnen das bekannt vor? Wenn nicht – betrachten Sie sich als glücklich (vorerst).
Dieser Fehler ist einer der beliebtesten auf Stack Overflow. Stellen Sie sich vor: Tausende von Entwicklern, von Studenten bis zu erfahrenen Ingenieuren, sind mindestens einmal in ihrem Leben darauf gestoßen, dass ihre JAR-Datei sich weigert zu starten. Warum passiert das? Die Sache ist die: Java ist nicht einfach «packe ein und starte». Die virtuelle Maschine muss genau wissen: Welche Klasse enthält den Einstiegspunkt? Ohne diese Information bleibt die JAR-Datei ein gewöhnliches Archiv und kein ausführbares Programm.
In diesem Artikel werden wir uns ansehen, was ein Manifest ist, wie es mit dem Einstiegspunkt zusammenhängt und – am wichtigsten – wie Sie dafür sorgen, dass Ihre JAR-Datei fehlerfrei startet. Wir gehen vom Einfachen zum Komplexen: von der manuellen Erstellung in der Befehlszeile bis zur Konfiguration der IDE. Los geht's!
Was ist ein Manifest und wozu wird es benötigt?
Jede JAR-Datei (Java Archive) enthält intern einen Ordner META-INF und darin eine Datei MANIFEST.MF. Dies ist nicht nur ein technisches Artefakt, sondern eine echte «Bedienungsanleitung» für die virtuelle Maschine von Java.
Stellen Sie sich ein Buch ohne Inhaltsverzeichnis vor. Sie wissen, dass es Kapitel hat, aber Sie wissen nicht, auf welcher Seite Sie mit dem Lesen beginnen sollen. Genau das Gleiche passiert mit einer JAR-Datei ohne Angabe der Hauptklasse. Die virtuelle Maschine sieht viele Klassen, weiß aber nicht, welche davon die Methode public static void main(String[] args) enthält.
Eine typische MANIFEST.MF-Datei sieht so aus:
Manifest-Version: 1.0Created-By: 17.0.2 (Oracle Corporation)Main-Class: com.example.MainDie wichtigste Zeile hier ist Main-Class. Sie gibt den vollständigen Namen der Klasse (mit Paket) an, die Java starten soll. Wenn diese Zeile fehlt oder falsch angegeben ist – erhalten Sie genau diesen Fehler «no main manifest attribute».
Warum kann das Manifest leer oder fehlerhaft sein?
- Manuelle Erstellung mit
jar– wenn Sie das Flag-enicht angegeben oder kein eigenes Manifest erstellt haben. - Erstellung in der IDE ohne Konfiguration – einige Entwicklungsumgebungen (besonders ältere Versionen) fügen
Main-Classnicht automatisch hinzu. - Nachlässigkeit bei der Benennung – z.B. haben Sie
mainklein geschrieben oder das Paket vergessen. - Kodierung und Formatierung – im Manifest ist jede leere Zeile am Ende der Datei wichtig.
Wie man eine ausführbare JAR-Datei erstellt: drei Methoden
Methode 1. Befehlszeile (manuelle Kontrolle)
Diese Methode vermittelt ein vollständiges Verständnis des Prozesses. Nehmen wir an, wir haben eine einfache Klasse HelloWorld.java:
package com.example;
public class HelloWorld { public static void main(String[] args) { System.out.println("Hallo Welt! JAR funktioniert!"); }}Schritt 1. Klasse kompilieren
javac -d . HelloWorld.javaDas Flag -d . erstellt die Paketstruktur (com/example/HelloWorld.class).
Schritt 2. Manifest manuell erstellen
Erstellen Sie eine Datei MANIFEST.MF (z.B. im Editor) mit folgendem Inhalt:
Manifest-Version: 1.0Main-Class: com.example.HelloWorldWichtig: Nach der letzten Zeile muss unbedingt eine leere Zeile stehen! Ohne diese kann die JAR-Datei das Manifest möglicherweise nicht lesen.
Schritt 3. JAR erstellen
jar cfm HelloWorld.jar MANIFEST.MF com/example/HelloWorld.classDas Flag
Blogs
Buchempfehlungen
Lesen Sie auch
So bestehst du das JavaScript-Vorstellungsgespräch: Top-Fragen und Antworten
TensorFlow einfach erklärt: Grundlagen & Python-Nutzung
