Java アプリケーションを JAR (Java Archive) ファイルとしてパッケージ化し実行する際、開発者はしばしば「no main manifest attribute」エラーに遭遇します。このエラーは、JAR ファイルを実行しようとした際に、Java Virtual Machine (JVM) がアプリケーションを開始するための main メソッドを含むクラスを特定できない場合に発生します。
この実験（Lab）では、この一般的なエラーの理解、診断、および解決方法を案内します。このチュートリアルを終える頃には、main クラスを正しく指定するマニフェストファイルを使用して、JAR ファイルを適切に構成する方法を習得しているでしょう。
JAR ファイルにパッケージ化する簡単な Java アプリケーションを作成することから始めましょう。これにより、「no main manifest attribute」エラーを実演し、後で修正することができます。
まず、Java ソースファイルのディレクトリを作成し、そこに移動します。
cd ~/project/src/com/example次に、エディタを開き、このディレクトリにHelloWorld.javaという名前の新しいファイルを作成します。
/home/labex/project/src/com/exampleに移動します。HelloWorld.javaとします。HelloWorld.javaファイルに以下のコードを追加します。
package com.example;
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}これは、実行時にコンソールに「Hello, World!」と出力するmainメソッドを持つ基本的な Java プログラムです。
次に、Java クラスをコンパイルしましょう。ターミナルに戻り、プロジェクトのルートディレクトリに移動します。
cd ~/projectjavacコマンドを使用して Java ファイルをコンパイルします。
javac -d . src/com/example/HelloWorld.javaこのコマンドは、Java ソースファイルをコンパイルし、パッケージ名に基づいてコンパイルされたクラスファイルを適切なディレクトリ構造に配置します。
これで、~/project/com/example/HelloWorld.classにコンパイルされたクラスファイルが作成されます。以下で確認できます。
ls -l com/example/出力には、HelloWorld.classファイルが表示されます。
total 4
-rw-r--r-- 1 labex labex 426 [date] HelloWorld.class次に、マニフェストで main クラスを指定せずに JAR ファイルを作成しましょう。これにより、「no main manifest attribute」エラーを再現できます。
jar cf HelloWorld.jar com/このコマンドは、コンパイルされたクラスファイルを含むHelloWorld.jarという名前の JAR ファイルを作成します。
JAR ファイルを作成したので、実行してみましょう。
java -jar HelloWorld.jar次のエラーメッセージが表示されます。
no main manifest attribute, in HelloWorld.jarこれが、私たちが修正しようとしているエラーです。JAR のマニフェストで main クラスを指定しなかったため、JVM は実行する main クラスを見つけることができません。
このステップでは、「no main manifest attribute」エラーの原因を探り、JAR ファイルの manifest の仕組みを理解します。
JAR ファイルには、META-INFディレクトリにMANIFEST.MFと呼ばれる特別なファイルが含まれています。このマニフェストファイルには、JAR とその内容に関するメタデータが含まれています。マニフェストが含めることができる重要な情報の 1 つは、Main-Class属性です。これは、JAR が実行されたときに実行する main メソッドを含むクラスを JVM に指示します。
現在の JAR ファイルのマニフェストを調べてみましょう。
mkdir -p temp_dir
cd temp_dir
jar xf ../HelloWorld.jar META-INF/MANIFEST.MF
cat META-INF/MANIFEST.MF次のような最小限のマニフェストが表示されます。
Manifest-Version: 1.0
Created-By: 1.8.0_XXX (Oracle Corporation)このマニフェストにはMain-Class属性がないことに注意してください。これが、JAR を実行しようとしたときに「no main manifest attribute」エラーが発生する理由です。
JAR ファイルをよりよく理解するために、その内容を見てみましょう。
cd ~/project
jar tf HelloWorld.jarこのコマンドは、JAR 内のすべてのファイルを一覧表示します。出力は次のようになります。
META-INF/
META-INF/MANIFEST.MF
com/
com/example/
com/example/HelloWorld.classご覧のとおり、JAR には期待どおりコンパイルされたクラスファイルが含まれていますが、マニフェストには main クラスを識別するために必要な情報がありません。
「no main manifest attribute」エラーは、通常、次のような状況で発生します。
java -jarを使用して JAR ファイルを実行しようとしたが、JAR が実行可能になるように意図されていない場合Main-Class属性が含まれていない場合今回のケースでは、エラーを実演するために、意図的に main クラスを指定せずに JAR を作成しました。
一時ディレクトリをクリーンアップしましょう。
cd ~/project
rm -rf temp_dirエラーの原因を理解したので、次のステップでは、適切なマニフェストファイルを作成して修正します。
問題点を理解したので、main クラスを指定する適切なマニフェストファイルを作成して修正しましょう。
まず、プロジェクトディレクトリに戻ります。
cd ~/project次に、manifest.txtというテキストファイルを作成します。
/home/labex/projectに移動します。manifest.txtとします。manifest.txtファイルに次の内容を追加します。
Main-Class: com.example.HelloWorldファイルの最後に改行を追加してください（マニフェスト形式では、ファイルが改行で終わる必要があります）。WebIDE では、上記の行を入力した後、Enter キーを押すだけです。
このシンプルなマニフェストファイルは、com.example.HelloWorldクラスに、JAR の実行時に実行される main メソッドが含まれていることを指定します。
次に、新しい JAR ファイルを作成します。今回は、カスタムマニフェストを含めます。
jar cfm HelloWorldWithManifest.jar manifest.txt com/このコマンドは、コンパイルされたクラスファイルを含み、カスタムマニフェストファイルを使用する、HelloWorldWithManifest.jarという名前の新しい JAR ファイルを作成します。
このコマンドで使用されるオプションは次のとおりです。
c: 新しいアーカイブを作成しますf: アーカイブファイル名を指定しますm: 指定されたマニフェストファイルからマニフェスト情報を含めますマニフェストが JAR に正しく含まれているかどうかを確認しましょう。
mkdir -p temp_check
cd temp_check
jar xf ../HelloWorldWithManifest.jar META-INF/MANIFEST.MF
cat META-INF/MANIFEST.MFマニフェストにMain-Class属性が含まれるようになったことがわかります。
Manifest-Version: 1.0
Created-By: [Java version info]
Main-Class: com.example.HelloWorld次に、一時ディレクトリをクリーンアップしましょう。
cd ~/project
rm -rf temp_checkmain クラスを指定する適切なマニフェストファイルを使用して JAR ファイルを作成したので、それを実行し、正しく動作することを確認しましょう。
プロジェクトディレクトリにいることを確認してください。
cd ~/project次に、java -jarコマンドを使用して JAR ファイルを実行します。
java -jar HelloWorldWithManifest.jar今回は、「no main manifest attribute」エラーではなく、プログラムからの出力が表示されるはずです。
Hello, World!おめでとうございます。main クラスを指定する適切なマニフェストファイルを作成することにより、「no main manifest attribute」エラーを正常に修正しました。
エラーを修正するために何をしたのかを理解するために、少し時間をかけましょう。
Main-Class属性を含むマニフェストファイルを作成し、実行する main メソッドを含むクラスを JVM に指示しました。java -jarコマンドを使用して JAR を実行し、JVM は main メソッドを見つけて実行することができました。JAR ファイルを操作する際に、main クラスを指定する他の方法がいくつかあります。
別のマニフェストファイルを作成する代わりに、eオプションを使用して、JAR の作成時に main クラスを直接指定できます。
jar cfe HelloWorldDirect.jar com.example.HelloWorld com/これにより、main クラスがcom.example.HelloWorldとして指定された、HelloWorldDirect.jarという名前の新しい JAR ファイルが作成されます。
これが動作することを確認するために、この JAR を実行しましょう。
java -jar HelloWorldDirect.jar出力が表示されるはずです。
Hello, World!適切なマニフェストがない JAR ファイルがある場合でも、javaコマンドで main クラスを直接指定することで実行できます。
java -cp HelloWorld.jar com.example.HelloWorldこのコマンドは、JVM にクラスパス（-cp）でHelloWorld.jarを使用し、com.example.HelloWorldクラスを実行するように指示します。
出力が表示されるはずです。
Hello, World!このアプローチは、実行するクラスを JVM に明示的に指示することにより、マニフェストの必要性を回避します。
この実験では、Java の「no main manifest attribute」エラーとその解決方法について学びました。これまでの内容を振り返ってみましょう。
エラーの理解: 「no main manifest attribute」エラーは、JAR ファイル内の実行する main クラスがマニフェストで指定されていないため、JVM がそれを見つけられない場合に発生します。
適切なマニフェストの作成: Main-Class属性を使用して main クラスを指定するマニフェストファイルの作成方法を学びました。
マニフェストを使用した JAR ファイルの構築: マニフェスト情報を含む JAR ファイルの作成方法を学びました。
jar cfm ...）jar cfe ...）JAR ファイルの実行: JAR ファイルとしてパッケージ化された Java アプリケーションを実行するさまざまな方法を学びました。
java -jarを使用するjava -cpを使用するこれらのスキルは、アプリケーションを JAR ファイルとしてパッケージ化して配布する必要がある Java 開発者にとって不可欠です。マニフェストの役割と、それを正しく設定する方法を理解することで、「no main manifest attribute」エラーを回避し、Java アプリケーションがスムーズに実行されるようにすることができます。
適切なパッケージングは、優れたコードを書くことと同じくらい重要であることを忘れないでください。ビルドとパッケージングを正しく設定する時間をかけることで、後であなたとユーザーのフラストレーションを回避できます。
