Android StudioでRun時に発生するJREエラーを解決する完全ガイド💻

はじめに (対象読者・この記事でわかること)

この記事は、Android Studioを使用してJavaでAndroidアプリケーションを開発している際に、「Run」を実行するとJRE（Java Runtime Environment）に関するエラーに遭遇し、プロジェクトがビルドまたは実行できないと悩んでいる開発者を対象としています。特に、プログラミング初学者の方や、これまでエラー解決に時間を費やしてきた方に役立つ内容となっています。

この記事を読むことで、JREエラーが発生する主な原因を理解し、具体的な診断方法と解決策をステップバイステップで学ぶことができます。よくあるエラーメッセージの種類とその対処法を知ることで、今後の開発において同様の問題に直面した際に、迅速かつ的確に解決できるようになるでしょう。安定した開発環境を構築し、スムーズにアプリケーション開発を進めるための一助となれば幸いです。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 * Android開発の基本的な知識（プロジェクト作成、ビルドの概念など） * Javaプログラミングの基本的な知識 * Android Studioの基本的な操作（プロジェクト設定画面の開き方など）

Android Studioで発生するJREエラーとは？ (概要と原因)

Android Studioでアプリケーションを開発し、「Run」ボタンを押した際、プロジェクトのビルドプロセス中にJava Runtime Environment（JRE）に関連するエラーが表示され、実行が停止してしまうことがあります。このJREエラーは、Javaアプリケーションが実行されるために必要な環境であるJREのバージョン不一致や設定ミスなど、様々な要因で発生します。

Android Studioは内部でGradleというビルドツールを使用しており、Gradleがプロジェクトをビルドする際に、特定のJava Development Kit（JDK）バージョンを要求します。JREはそのJDKの一部として含まれる実行環境ですが、Android Studioのプロジェクト設定、Gradleの設定、そしてシステムにインストールされているJDKの間にバージョン不一致やパスの指定ミスがあると、JREエラーが発生する典型的な原因となります。

よくあるエラーメッセージとしては、以下のようなものがあります。

• Unsupported major.minor version [特定のバージョン番号]：これは最も頻繁に見られるエラーの一つで、プロジェクトが要求するJavaのバージョンと、実際にビルドに使われているJavaのバージョンが異なる場合に発生します。
• java.lang.NoClassDefFoundError：必要なクラスファイルが見つからない場合に発生します。多くの場合、クラスパスの設定ミスや、依存関係の欠落、あるいはJDKバージョンの不一致が原因です。
• Error: JAVA_HOME is not set.：環境変数JAVA_HOMEが正しく設定されていないか、指しているパスにJDKが存在しない場合に発生します。

これらのエラーは、一見すると複雑に見えますが、原因の多くはJavaのバージョン管理とパス設定に集約されます。次のセクションでは、これらのエラーを具体的に診断し、解決するための手順を詳しく見ていきましょう。

Android StudioでのJREエラーの診断と解決策 (具体的な手順)

Android StudioでJREエラーが発生した場合、冷静にエラーメッセージを読み解き、以下の手順で原因を特定し解決していくことが重要です。

ステップ1: エラーメッセージの確認と原因の特定

エラーメッセージは、問題解決の最も重要な手がかりです。Android Studioの「Run」タブや「Build」タブに表示されるエラーメッセージを注意深く確認してください。特に、Error:やCaused by:で始まる行に注目し、どのファイル（build.gradleなど）のどの行で、どのような種類の問題（Unsupported major.minor versionなど）が発生しているかを把握します。

例えば、Unsupported major.minor version 52.0というエラーが出た場合、「バージョン52.0をサポートしていない」という意味で、プロジェクトがJava 8 (バージョン52) を要求しているが、それよりも古いJavaが使われている、またはその逆の状況が考えられます。

ステップ2: プロジェクトのJavaバージョン設定の確認

まずはプロジェクトがどのようなJavaバージョンを要求しているかを確認します。

1. build.gradle (Module: app) ファイルの確認: プロジェクトビューで app/build.gradle ファイルを開きます。android ブロック内に以下の記述を探します。

   gradle android { // ... compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } kotlinOptions { // Kotlinを使用している場合 jvmTarget = '1.8' } } sourceCompatibility と targetCompatibility が、このプロジェクトがビルド時に使用するJavaのバージョンを指定しています。ここでは VERSION_1_8 (Java 8) が指定されています。プロジェクトによっては VERSION_1_11 (Java 11) など、異なるバージョンが指定されている場合があります。このバージョンを覚えておいてください。

2. Android StudioのProject Structure設定の確認: File -> Project Structure... を開きます。

   • Projectタブ: SDK location の JDK location が、PCにインストールされているJDKのパスを正しく指しているか確認します。また、Project SDK が適切なJava SDKバージョン（例: Android API 33 Platform, Java 11）に設定されているか確認します。
   • Modulesタブ (もしあれば): 選択されているモジュールの Source Compatibility と Target Compatibility が build.gradle と一致しているか確認します。

ステップ3: システムのJDK/JREバージョンと環境変数の確認

次に、PCに実際にインストールされているJDKのバージョンと、Android Studioが参照する環境変数が正しいかを確認します。

1. コマンドプロンプト/ターミナルでのJDKバージョン確認: コマンドプロンプト（Windows）またはターミナル（macOS/Linux）を開き、以下のコマンドを実行します。

   bash java -version javac -version java -version はJREのバージョンを、javac -version はJDK（Java Compiler）のバージョンを表示します。これらがAndroid StudioのProject Structureで設定されているJDKのバージョン、およびbuild.gradleで指定されているsourceCompatibilityと整合性が取れているかを確認します。

   例えば、build.gradleでVERSION_1_8が指定されているのに、javac -versionがJava 11を示している場合、バージョン不一致の可能性があります。

2. JAVA_HOME環境変数の確認: JAVA_HOME環境変数は、多くのJavaツールがJDKの場所を特定するために使用します。この変数が存在しないか、間違ったパスを指しているとエラーが発生することがあります。

   • Windowsの場合: システムのプロパティ -> 詳細設定 -> 環境変数 を開きます。システム環境変数 の中に JAVA_HOME があるか確認します。パスはJDKのインストールディレクトリ（例: C:\Program Files\Java\jdk-1.8 または C:\Program Files\Android\Android Studio\jbr）を指している必要があります。
   • macOS/Linuxの場合: ターミナルで echo $JAVA_HOME を実行します。パスが表示されなければ設定されていません。

ステップ4: 解決策の適用

これまでの確認で特定された問題点に基づき、以下の解決策を適用します。

解決策1: JDKバージョンの不一致を修正する

• build.gradle の compileOptions を修正: もしPCに特定のJDKバージョンしかインストールされておらず、それをAndroid Studioとプロジェクトで使いたい場合、build.gradle の sourceCompatibility と targetCompatibility をそのJDKのバージョンに合わせます。 例えば、Java 11 (バージョン55) を使用している場合: gradle compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } kotlinOptions { // Kotlinを使用している場合 jvmTarget = '11' } 変更後、Android Studioの「Sync Project with Gradle Files」ボタン（象のアイコン）をクリックして同期します。

• Android StudioのJDKロケーションを修正: File -> Project Structure... -> SDK Location タブで、JDK location が、目的のJDKがインストールされているディレクトリ（例: C:\Program Files\Java\jdk-11 または Android Studioに付属のJDK C:\Program Files\Android\Android Studio\jbr）を正しく指していることを確認します。もし間違っていれば、正しいパスを指定し直します。

• 必要なJDKをインストールする: もしプロジェクトが要求するJavaバージョンがPCにインストールされていない場合は、OpenJDKなどの必要なJDKバージョンをダウンロードし、インストールしてください。その後、上記のJDKロケーション設定を更新します。

解決策2: JAVA_HOME 環境変数を設定する

JAVA_HOME が未設定または誤っている場合は、正しいJDKのパスを指すように設定します。

• Windowsの場合:

  1. システムのプロパティ -> 詳細設定 -> 環境変数 を開きます。
  2. システム環境変数 の 新規 をクリックし、変数名を JAVA_HOME、変数値にJDKのインストールパス（例: C:\Program Files\Java\jdk-11）を入力します。
  3. Path 変数を選択し、編集 をクリック。%JAVA_HOME%\bin を追加します。
  4. PCを再起動するか、コマンドプロンプトを再起動して設定を適用します。

• macOS/Linuxの場合 (例: ~/.bash_profile または ~/.zshrc に追加): bash export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk/Contents/Home # JDKの実際のパスに置き換える export PATH=$JAVA_HOME/bin:$PATH 変更後、source ~/.bash_profile または source ~/.zshrc を実行して設定を適用します。

解決策3: Android Studioのキャッシュクリアと再起動

まれに、Android Studioのキャッシュが原因で問題が発生することがあります。

1. File -> Invalidate Caches / Restart... をクリックします。
2. Invalidate and Restart を選択して、Android Studioを再起動します。

解決策4: プロジェクトのCleanとRebuild

上記の手順を実行した後、プロジェクトを一度クリーンアップし、再度ビルドし直すことで問題が解決することがあります。

1. Build -> Clean Project
2. Build -> Rebuild Project

ハマった点やエラー解決の具体例

Unsupported major.minor version 52.0 エラー

これは、プロジェクトがJava 8 (バージョン52) を使用するように設定されているにもかかわらず、ビルド環境がそれよりも古いJava（例：Java 7）を参照しているか、またはGradleビルドがJava 8に対応していない古いJDKを参照している場合に発生します。

解決策: 1. build.gradle (Module: app): sourceCompatibility と targetCompatibility を JavaVersion.VERSION_1_8 に設定します。 2. Android Studio Project Structure: JDK location をJava 8 (またはそれ以降) のJDKパスに設定します。Android Studioの内部JDK (jbrディレクトリ内) を指定するのが最も簡単な方法です。 3. JAVA_HOME: 環境変数 JAVA_HOME がJava 8以降のJDKパスを指していることを確認します。

java.lang.NoClassDefFoundError

このエラーは、実行時に必要なクラスファイルが見つからない場合に発生します。JDKバージョンの不一致が原因であることも多いですが、ライブラリの依存関係が正しく解決されていない場合や、ビルド出力パスに問題がある場合もあります。

解決策: 1. JDKバージョン確認: 上記のUnsupported major.minor versionと同じく、build.gradle、Project Structure、JAVA_HOMEのJDKバージョンが一致しているか再確認します。 2. 依存関係の確認: build.gradle (Module: app) の dependencies ブロックで、必要なライブラリがすべて正しく追加されているか確認します。 3. Gradle同期: 「Sync Project with Gradle Files」を再度実行し、依存関係が最新の状態であることを確認します。 4. Clean/Rebuild: プロジェクトをクリーンして再ビルドします。

これらの手順を一つずつ確認し、適切に設定することで、Android StudioでのJREエラーの多くは解決できるはずです。

まとめ

本記事では、Android StudioでRun実行時に発生するJREエラーのトラブルシューティングについて解説しました。

• エラーの原因特定: エラーメッセージの種類（Unsupported major.minor versionやNoClassDefFoundErrorなど）を理解し、その原因がJDK/JREのバージョン不一致や環境変数の設定ミスにあることを把握しました。
• バージョン設定の確認: build.gradleファイル、Android StudioのProject Structure設定、そしてシステムのjava -versionコマンドやJAVA_HOME環境変数を通じて、Javaのバージョン設定が正しく行われているかを確認する手順を学びました。
• 具体的な解決策: JDKバージョンの修正、Android StudioのJDKロケーション設定、JAVA_HOME環境変数の設定、キャッシュのクリアと再起動、プロジェクトのClean/Rebuildといった、具体的な解決策をステップバイステップで適用する方法を説明しました。

この記事を通して、Android Studio開発におけるJREエラーに直面した際に、冷静に原因を特定し、適切な解決策を適用できるようになるでしょう。安定した開発環境は生産性向上に直結します。 今後は、さらに複雑なビルドエラーの解決や、CI/CD環境でのJavaバージョン管理についても記事にする予定です。

参考資料

• Android Developers: Build Your Project with Gradle
• Oracle Java Documentation
• OpenJDK Official Website
• Gradle User Manual