Android向けビルド

目次

Spatial Reality Display PluginをAndroid向けにビルドする際は、Android依存関係の解決が必要です。  
本プラグインでは、依存関係管理としてExternal Dependency Manager for Unity (EDM4U)の利用を推奨しています。

EDM4Uを利用しない場合でもビルドは可能ですが、Gradleテンプレートの手動設定が必要になります。

EDM4Uを利用する(推奨)

External Dependency Manager for Unity (EDM4U)は、Googleが提供する、Unityプロジェクトで Android 依存関係の解決を支援するツールです。  
Spatial Reality Display PluginのAndroidビルドでは、EDM4Uの利用を推奨します。

詳細については、EDM4Uの公式GitHubをご参照ください:
https://github.com/googlesamples/unity-jar-resolver

EDM4Uを自動でインストールする

Androidビルド対象時に EDM4Uが未導入の場合は、Unity Editor にインストール確認ダイアログが表示されます。

  • Yes: EDM4Uを自動インストールする
    No: インストールしない(手動設定が必要)  
    No - Do not ask again for this session: インストールせず、現在の Unity セッション中(Editorを閉じるまで)は再表示しない

自動インストールする場合は、次のUPM URLが利用されます:
https://github.com/googlesamples/unity-jar-resolver.git?path=upm

EDM4Uを手動でインストールする

自動インストールを利用しない場合は、以下の公式リポジトリを参照して手動で導入してください:
https://github.com/googlesamples/unity-jar-resolver

手動導入後は、Unityメニューに `External Dependency Manager` が表示されることを確認したうえで Androidビルドを実行してください。

Caution

EDM4Uのインストール後は、依存関係解決処理が自動的に実行されます。ただし、場合によっては依存関係が正しく解決されず、ビルドに失敗することがあります。
その場合は一度手動で依存関係解決処理を強制的に実行させる必要があります。
Assetsメニューから External Dependency Manager > Android Resolver > Force Resolveを選択し、再度 Androidビルドを試みてください。

EDM4Uを利用しない場合の設定

EDM4Uを利用しない場合は、
Assets/SRDisplayUnityPlugin/Plugins/Android/ANDROID_SETUP.md
の手順に従ってGradleテンプレートを手動設定してください。

テンプレートを未編集の場合は、以下のファイルを
Assets/SRDisplayUnityPlugin/Plugins/Android/ から Assets/Plugins/Android/ へコピーします。

  • mainTemplate.gradle
  • gradleTemplate.properties
  • settingsTemplate.gradle

テンプレートをすでに編集済みの場合は、以下の設定を反映してください。

mainTemplate.gradle
implementation 'com.github.mik3y:usb-serial-for-android:3.7.0'
implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'androidx.core:core:1.9.0'

gradleTemplate.properties
android.useAndroidX=true
android.enableJetifier=true

settingsTemplate.gradle
maven { url 'https://jitpack.io' }

Note

EDM4Uを利用しない構成では、Unity / Gradle / 依存ライブラリ更新時に手動設定の追従が必要になる場合があります。
また、他プラグインの Gradle 設定と競合する可能性があるため、差分管理を行いながら設定してください。

開発者お問い合わせ・
商用利用について