Android 用の環境設定

Android 用 Unity アプリケーションを作成するには、まず Android をサポートするように Unity プロジェクトを設定する必要があります。Unity プロジェクトは、Android をサポートするために以下の依存関係を必要とします。

• Android Build Support モジュール
• Android Software Development Kit (SDK)
• Native Development Kit (NDK)
• Java Development Kit。デフォルトでは、Unity は OpenJDK を使用します。

開始する前に、Android の 要件と互換性に関する Unity ドキュメント を参照し、Android 用の Unity アプリケーション開発に関わる制限事項を確認してください。

依存関係のインストール

Unity は依存関係を モジュール として配布しているため、Unity Hub を使用してインストールする必要があります。新しいバージョンの Unity エディターのインストール時にインストールすることも、既存の Unity エディターのインストールに追加することも可能です。モジュールをインストールする場合は、以下を参照してください。

• エディターのインストール時にインストールする場合は、Downloading and installing Editors and modules with the Unity Hub (Unity Hub を使用した、エディターやモジュールのダウンロードとインストール) を参照してください。
• 既存のインストールに追加する場合は、Add modules (モジュールの追加) を参照してください。

インストールするモジュールは以下の 3 つです。

• Android Build Support
• Android SDK & NDK Tools
• OpenJDK

Unity は、Android SDK & NDK Tools と OpenJDK をそれぞれ、/[EditorVersion]/Editor/Data/PlaybackEngines/AndroidPlayer/ の下の SDK、NDK、OpenJDK フォルダーにインストールします。

依存関係のカスタマイズ

Android SDK & NDK Tools と OpenJDK のインストールは、正しいバージョンと設定をインストールするために、Unity Hub を使用して行う必要があります。ただし、Unity が Android 用アプリケーションのビルドに使用する SDK、NDK、JDK を変更することが有用な場合もあります。例えば、同じ依存関係を持つ複数のバージョンの Unity があり、SDK、NDK、JDK のインストールを重複させたくない場合には、共有の場所を指定することもできます。

Unity にカスタムバージョンの依存関係を使用させるには、以下を行ってください。

1. 依存関係のカスタムバージョンをダウンロードします。
   注意: Unity は、Unity Hub を通して提供されるバージョンの OpenJDK、SDK、NDK のみを公式にサポートします。詳細については、サポートされている依存関係のバージョン を参照してください。
2. Unity のメインメニューで、Edit > Preferences > External Tools > Android に移動します (macOS の場合: Unity > Settings > External Tools > Android)。
3. JDK、SDK、NDK、および Gradle のインストールをカスタマイズする方法については、Android 用外部ツール のドキュメント を参照してください。

サポートされている依存関係のバージョン

このセクションには、Unity の各バージョンが、各依存関係のどのバージョンをサポートしているかについての情報が含まれています。Unity はバージョンごとに特定のバージョンの Android NDK および Android JDK を必要としますが、Android SDK に関しては厳密なバージョン要件はありません。

SDK

Unity は Android SDK の提供するツールに依存しており、異なるバージョンの SDK でも通常は同じツールが使用できます。つまり、最近のバージョンの SDK ならどれでも (Unity が必要とするビルドツールを含んでいるので) 使用することができます。

以下の表は、各 Unity バージョンとともにインストールされた Android SDK ツールのサポートされているバージョンを示しています。

重要: Unity バージョン 2020.3 および 2021.3 LTS は、バージョン 31 以降の Android SDK ビルドツールをサポートしません。

NDK

Unity の各バージョンがサポートする NDK のバージョンは、以下の通りです。

JDK

Unity の各バージョンがサポートする JDK のバージョンは、以下の通りです。

ノート: Unity バージョン 2023.2 のみが CMake バージョン 3.22.1 をサポートします。Unity バージョン 2022.3 以下は CMake をサポートしません。

Android 用外部ツール

Android 用の External Tools セクションでは、Android デバイスで Unity プロジェクトを設定するために使用される Android 開発ツールを設定できます。Android 用の External Tools セクションにアクセスするには、Edit > Preferences に移動してから (macOS の場合: Unity > Settings)、External Tools > Android に移動します。

一般的な Preferences 設定については、環境設定 を参照してください。

Android SDK Target API の設定

Unity Hub は、Google Play の要求する Android SDK Target API の最新バージョンをインストールします。より新しいバージョンを使用する必要がある場合は Android Player 設定 で変更可能です。手順は以下のとおりです。

1. Edit > Project Settings を選択します。
2. Project settings ウィンドウの Player タブで、Android Player Settings を開きます。
   
3. Other Settings セクションで、Target API Level を変更します。
   

インストールされている最新のバージョンよりも新しいバージョンのターゲット API を選択した場合、Unity Android SDK Updater は、新しいバージョンのダウンロードとインストールを自動で行うことができます。Unity によってプロンプトが表示され、以下のいずれかの方法を選択できます。

• 新しいバージョンの Android SDK を自動的にダウンロードおよびインストールする
• インストールされている中で最新のバージョンの Android SDK を引き続き使用する

インストールされている最新のものより古く、まだインストールされていないバージョンのターゲット API を選択すると、Unity Android SDK Updater はアップデートを実行できず、エラーメッセージが表示されます。この場合、Android SDK Target API をアップデートするには、Android Studio または コマンドラインツール から Android sdkmanager を使用する必要があります。いずれの方法を選択した場合でも、Edit > Preferences > External Tools ウィンドウで、Unity 用の正しい Android SDK フォルダーが選択されていることを確認してください。詳細については、依存関係のカスタマイズ を参照してください。

重要: Windows で Unity エディターをデフォルトのフォルダー (/Program Files/) にインストールした場合、アップデートを実行するには、昇格した権限 (Run as Administrator) で sdkmanager を実行する必要があります。