Windows 11 向け 最新 Launch4j のインストールと使用方法：JAR から EXE への完全なパッケージ化ガイド


記事の目次

  • 目次

    記事の目次

    インストール手順

    まとめ

    • 概要
    • インストール手順
    • 技術的な詳細
    • まとめ

概要

本記事では、Launch4j を使用して Java の JAR パッケージを Windows 実行可能ファイル（EXE）に変換する方法について解説します。内容は、Launch4j の概要と主要機能、公式サイトからのダウンロード・インストール手順、JAR ファイルとアイコンの準備、Basic/JRE などの主要パラメータの設定、EXE ファイルの生成と動作テスト、およびよくあるエラー（クラッシュ、JRE が見つからない、アイコンが反映されない）のトラブルシューティング方法などを網羅しています。Java 開発者が、プロフェッショナルで使いやすい Windows クライアントを迅速にパッケージ化できるよう支援します。

公式サイト

https://launch4j.sourceforge.net/

こちらは Launch4j の公式プロジェクトページで、機能紹介やドキュメントを確認できます。

公式ダウンロード先（SourceForge）

Launch4j は SourceForge でホストされており、公式ダウンロード先はこちらです：

https://sourceforge.net/projects/launch4j/files/

  • 現在の最新バージョンは 3.50で、ダウンロードファイルは launch4j-3.50-win32.exe

    • です。

  • 上記のリンクを開くと、launch4j-3 フォルダが表示されます（数字の3はメジャーバージョン番号を表します）
  • クリックして開くと、最新バージョンのフォルダを選択できます。現在の最新バージョンは 3.50
  • お使いのオペレーティングシステムに応じて、対応するインストーラーを選択してください：
    • Windows ユーザー：launch4j-3.50-win32.exe
    • Linux ユーザー：対応する .tgz パッケージ
    • Mac ユーザー：対応する Mac 版パッケージ
  • 図のように、「ダウンロード」をクリックしてください。

前提環境要件

⚠️ 重要なお知らせ: Launch4j 自体を実行するには、お使いのコンピュータに JRE または JDK 環境がインストールされている必要があります（Launch4j 自体も Java プログラムであるため）。

Java がインストールされているか確認する:

コマンドプロンプトを開き（Win+R、cmdと入力）、以下を入力してください：

java -version

バージョン番号（例：java version 「1.8.0_xxx」）が表示されれば、インストール済みです。「内部コマンドまたは外部コマンドではありません」というメッセージが表示された場合は、まず JDK をインストールする必要があります。

インストール手順

1. インストールファイルをダブルクリックして実行

ダウンロードした launch4j-3.50-win32.exeをダブルクリックすると、インストールウィザードのウェルカム画面が表示されます。Next（次へ）をクリックしてください。

2. ライセンス契約を読む

Launch4j は BSD 3-Clause オープンソースライセンスを採用しています。同意するをクリックします。

3. インストール先を選択する

デフォルトでは、C:\\Program Files (x86)\\Launch4jにインストールされます。

推奨： システムドライブ以外のパス（例：D:\\Tools\\Launch4j）に変更することをお勧めします。これにより、今後の管理が容易になり、権限の問題を回避できます。Nextをクリックします。

図のように、インストールが完了するまでお待ちください

4. インストールの完了

インストール完了後、Launch4jをすぐに起動するかどうかを尋ねるメッセージが表示されます。チェックを入れて Finish をクリックすると、Launch4jのメイン画面が開きます。

以上がインストール手順です

3. インストールが正常に完了したか確認する

起動すると、Launch4jのメイン画面が表示され、以下のタブが含まれています:

  • Basic(基本設定：JARパス、出力EXEパス、アイコン)
  • Classpath(クラスパス設定)
  • Header(GUI/コンソールモード)
  • Splash(起動画面)
  • Versions Info(バージョン情報)
  • Messages(エラーメッセージ設定)
  • JRE(JREのバージョンとパス設定)

インターフェースが正常に開き、これらのタブが表示されていれば、インストールは成功しています

技術的な詳細

Launch4j 詳細設定チュートリアル（スクリーンショットに基づく）

Launch4j 3.50を正常に起動できました。ここからが最も重要な設定段階です。以下、タブごとに順を追って説明します。

一、Basic タブ（必須の主要設定）

1. Output file（出力ファイル）必須

右側のフォルダアイコンをクリックし、生成される exe ファイルの保存先とファイル名を選択してください。

例：

D:\\toolkit\\chung-release\\original\\MyApp.exe
2. Jar 必須

右側のフォルダアイコンをクリックし、パッケージ化する jar ファイルを選択します（実行可能な jar、つまり Main-Class を含む jar である必要があります）。

例:

D:\\MyApp\\myapp.jar

? IDEA/Eclipseからエクスポートされた「Runnable JAR」の場合は、ここで直接それを選択してください。

3. 「Don''t wrap the jar, launch only」（JARをラップせず、起動のみ）はチェックを入れず、デフォルトのままにします
  • 「:jar」にチェックを入れない場合：JARはexeファイル内に完全にラップされます（推奨。配布時にはexeファイル1つで済みます）
  • にチェックを入れる場合：exeは単なるランチャーとなり、実行時にはjarファイルが別途必要となります（jarファイルを独立して更新したい場合に適しています）
4. Wrapper manifest（任意、空欄でも可）

特別なWindowsマニフェストの要件（管理者権限の要求などの高度な用途）がない限り、通常は個別に設定する必要はありません。

5. アイコン

右側のフォルダアイコンをクリックし、.ico形式のアイコンファイルを選択してください。これにより、生成されるexeにはデフォルトのJavaのコーヒーカップアイコンではなく、独自のアイコンが表示されます。

⚠️ 注意：必ず .ico 形式である必要があります。png/jpg 形式の画像しかない場合は、オンラインツール（convertio.co、icoconvert.com など）を使用して、まず ico 形式に変換する必要があります。

6. Change dir（ディレクトリの変更、デフォルトは .）

デフォルトの . のままにしておいてください。これにより、プログラム実行時の作業ディレクトリは exe ファイルが存在するディレクトリになります。

7. Command line args（コマンドライン引数）

Java プログラムの main メソッドで起動引数を受け取る必要がある場合は、ここに記入してください。通常は空欄のままにしておきます。

8. Process priority（プロセスの優先度）

デフォルトの Normal のままにしておけば問題ありません。変更する必要はありません。

9. Options（オプション）
  • Stay alive after launching a GUI application：プログラムがGUIアプリケーション（ウィンドウインターフェースを持つ）である場合は、ランチャーが早期に終了してプログラムが異常終了するのを防ぐため、チェックを入れることをお勧めします
  • Restart the application after a crash: クラッシュ後にアプリケーションを自動的に再起動するかどうか。通常はチェックを入れません
10. Java download and support（任意ですが、入力することを推奨）

  • Error title: エラー発生時のポップアップウィンドウのタイトル。例：「プログラムの起動に失敗しました」

  • JavaのダウンロードURL：適切なJREが見つからない場合に、ユーザーを誘導するダウンロード先。推奨：

    https://www.oracle.com/java/technologies/downloads/

  • サポートURL：エラー発生時に表示されるサポートURL（連絡先やヘルプページを入力可）

2. JRE タブ（⭐非常に重要。プログラムが正常に動作するかどうかを決定します）

上部へ移動 JRE タブ、主な設定項目：

  1. Min JRE version（最低JREバージョン）：例：1.8.0と入力すると、Java 8以上が必要であることを示します

  2. Max JRE version（最高JREバージョン）：通常は空欄のままとし、上限を設けません

  3. JVMオプション：JVMの起動パラメータを入力できます。例：

    -Xms256m -Xmx1024m

は、初期メモリ256MB、最大メモリ1024MBを指定します

  1. バンドルされたJREのパス(重要、オプション):
  • 空欄のままの場合：プログラムの実行時に、ユーザーのコンピュータにインストール済みのJREが検索されます
  • パスを指定した場合（例：jreフォルダをexeファイルと同じディレクトリに配置し、jreと入力）：同梱されたJREが優先的に使用され、ユーザーのコンピュータにJavaを別途インストールする必要はありません。これは、技術に詳しくないユーザーに配布する際に最も推奨される方法です

3. その他のタブ（必要に応じて設定）

タブ 機能 必須か
Classpath プログラムが複数の外部JARファイル（メインJARに組み込まれていないもの）に依存している場合、ここにClasspathを追加する必要があります 状況に応じて
Header GUIモード（黒い枠のないコンソール）またはコンソールモード（コマンドラインツール用）を選択します 設定を推奨
Single instance プログラムを同時に1インスタンスのみ実行できるように設定し、重複起動を防止 オプション
Splash 起動時に表示する起動画面（BMP形式の画像）を設定 オプション
Version Info ファイルのバージョン番号、会社名、製品名などを入力（exeファイルを右クリックして「プロパティ」を表示した際に表示されます） 入力することを推奨します。よりプロフェッショナルな印象を与えます
Messages 起動に失敗した際の各種メッセージをカスタマイズ オプション

「Header」タブの操作手順:

  • 「Header type」を見つけ、以下から選択:
    • gui: グラフィカルインターフェースを備えたデスクトップアプリケーションに適しています（デフォルトで推奨）
    • console: コマンドラインツール類のプログラムに適しており、黒いコンソールウィンドウが表示されます

4. exe ファイルの生成

設定完了後、以下の2つの手順を実行してください:

1. 設定を保存する（先に実行することを推奨）

左上のツールバーにある 保存アイコン（3番目、フロッピーディスクのアイコン）をクリックし、.xml 設定ファイルとして保存します。これにより、次回の修正や再利用が容易になります。

2. exe ファイルの生成

ツールバー中央の 歯車アイコン（「Build Wrapper」ボタン）をクリックすると、Launch4j がパッケージ化を開始し、下部の ログ ウィンドウにパッケージ化プロセスのログが表示されます。

パッケージ化成功時の表示例:

D:\\MyApp\\MyApp.exe に jar をラップ中
exe を圧縮中... 完了。

赤いエラーメッセージが表示される場合、通常は以下の原因によるものです：

  • 出力ファイルまたは Jar のパスが入力されていない（必須項目である赤色の * マークが満たされていない）
  • JAR ファイルのパスが存在しない、またはパスに中国語や特殊文字が含まれている
  • アイコンファイルが有効な .ico 形式ではない

5. テスト実行

  1. 先ほど「Output file」で生成された exe ファイルがあるディレクトリを探します
  2. ダブルクリックして実行し、プログラムが正常に起動するか確認します
  3. プログラムが反応しない、またはクラッシュする場合は、Log ウィンドウに戻って具体的なエラーメッセージを確認してください。よくある問題は以下の通りです：
    • 要件を満たす JRE バージョンがシステムにインストールされていない → JRE タブの最低バージョン設定を確認してください
    • jar パッケージ自体に問題がある → まず、java -jar xxx.jar コマンドを直接実行して正常に動作するか確認してください

図のように起動に成功しました

まとめ

ご質問がある場合は、著者の公式アカウント「全栈鍾猿」へダイレクトメッセージをお送りください。メッセージを確認次第、速やかにご質問にお答えいたします