渋谷ほととぎす通信

「Unityをわかりやすく」初心者のためのゲーム作りブログ

【Unity】Androidビルドに必要なJDKはUnityHubで解決

【Unity】Androidビルドに必要なJDKはUnityHubで解決

こんにちは、Unityエンジニアのオオバです。

Android向け開発中のトラブルは絶えません。

  • ビルドができない
  • 実機に転送できない
  • コンパイルが通らない

などなど。
中でもトラブル頻度第1位。

ビルドトラブル

今回紹介するトラブルはコチラ。
JDK not found です。

Androidビルド時のエラーダイアログ

【Unity】Androidビルドに必要なJDKはUnityHubで解決_0

このようなエラーログが出るパターン。

JDK not found  
Java Development Kit (JDK) directory is not  
set or invalid. Please, fix it in  
Edit / Unity -> Preferences -> External Tools  

JDKが見つからなくて
ビルドが通らないエラーの解決方法を紹介します。

OpenJDKをUnityHub経由のインストールで解決

【Unity】Androidビルドに必要なJDKはUnityHubで解決_1

UnityHubから
以下の手順を踏みましょう。

  1. UnityHubからAdd Modules
  2. OpenJDKにチェックを入れてインストール

この2ステップのみ。
これだけで JDK not foundは解決 します。

最近はビルド環境をUnity側に任せられるようになっています。
環境構築が非常に楽 になりました。

では詳細について解説していきます。

👉DOTweenの教科書を読んでUnityアニメーションをプログラミングしてみよう!

AndroidビルドにはJDKが必要な理由

【Unity】Androidビルドに必要なJDKはUnityHubで解決_2

そもそもなぜAndroidビルドに JDK が必要なのでしょうか。
理由はAndroidがJavaで作られているからです。

JDKとはJava Development Kitの略で、
Javaアプリの開発に使います。

つまりAndroidアプリのビルドにはJDKが必要なのです。

JDKはあらかじめPCにダウンロードしておき、
パスを通しておくことで、
ビルド時に参照されます。

Unityのバージョンによって必要なJDKのバージョンも変更

JDKにもいくつもバージョンが存在します。
やっかいなのは、Unityバージョン毎に
必要となるJDKのバージョンも変わる
ということでした。

メニューUnity -> Preferences -> External Tools
Androidの部分を見てみるとJDK周りで警告が出ています。

【Unity】Androidビルドに必要なJDKはUnityHubで解決_3

You are missing the recommended JDK. Install the recommended version using UnityHub.

UnityHub登場前は、Unityのバージョンに合わせた
JDKを公式サイトからダウンロードするという手間が発生していました。

オススメはUnityHub経由のJDKインストール

【Unity】Androidビルドに必要なJDKはUnityHubで解決_4

Install the recommended version using UnityHub.

先の警告にも記載されていますが、
UnityHubからJDKのインストールをオススメ します。

強くおすすめする理由は、
自動で適切なバージョンのJDKをインストール してくれるからです。

これによりビルド環境構築の時間を大幅に削減してくれました。

今はこれ一択です。
わざわざ開発者がJDKを
ダウンロードする理由はありません。

ではUnityHubからJDKのインストール手順を解説します。

1.JDKを追加したいUnityバージョンのを選択

【Unity】Androidビルドに必要なJDKはUnityHubで解決_5

↑の通りJDKを追加したいUnityの右上ボタンを押します。
この例ではUnity2021.1.2f1にJDKをインストールします。

2.Add Modulesボタンクリック

【Unity】Androidビルドに必要なJDKはUnityHubで解決_6

Add Modules をクリックします。

3.OpenJDKにチェック

【Unity】Androidビルドに必要なJDKはUnityHubで解決_7

Android Build Support > OpenJDKにチェックを入れます。

チェックを入れて、Doneボタンをクリック。

※キャプチャに写っていませんがDonwボタンは右下にあります

するとインストールは開始します。

PreferencesからJDKインストール完了の確認

JDKインストール完了後Unityに戻ります。

JDK Instaled with Unity(recommdned)の
チェックをつけ直す
と更新されます。
↑地味に大事なところ

【Unity】Androidビルドに必要なJDKはUnityHubで解決_8

警告が出ていなければ、
適切なバージョンのJDK
Unityにインストールされたということです。

この状態で再度Androidビルドしてみてください。

JDK not foundエラーは解消 するでしょう。

まとめ : AndroidビルドエラーJDKはUnityHubで解決

【Unity】Androidビルドに必要なJDKはUnityHubで解決_9

記事の内容を簡単にまとめます。

  • AndroidはJava製
  • ビルドにはJDKが必要
  • JDKにインストールはUnityHubがオススメ
  • UnityバージョンごとにJDKは必要

こんな感じです。

UnityHubでJDKをインストールするだけ

最近のUnityはこれで完了します。

ひと昔前まで必要だった下記の作業は不要です。

  • 適切なJDKを自分でダウンロード
  • パスを通す作業

UnityHubで完結する良い時代となりました。
Unityの進化ですね。

「Unity初心者大学」というUnity初心者向けのYouTube始めました!!
ぜひチャンネル登録をお願いします!

最後まで読んでいただきありがとうございました!
すばらしいAndroidビルドライフをお過ごしください。

オススメ記事
検証環境
  • Unity2020.3.19f1