AAR プラグインと Android ライブラリ

AAR プラグイン

Android Archive (AAR) plug-ins are bundles that include compiled Java and native (C/C++) code, resources, and an Android Manifest. The .aar file itself is a zip archive which contains all of the Assets. For more details, see Android Developer documentation on creating an Android Library.

AAR プラグインをプロジェクトに追加するには、 .aar ファイルを任意のプロジェクトフォルダーにコピーし、 Unity 上でそれを選択し、インスペクターウインドウで Import Settings （インポート設定）を開いてください。この .aar ファイルを Android と互換性を持つファイルとしてマーキングするために、 Android のチェックボックスをオンにしてください。

AAR は、推奨される Unity の Android アプリケーションのプラグイン形式です。

Android ライブラリプロジェクト

Android ライブラリプロジェクトは AAR プラグイン同様、ネイティブおよび Java コード、リソース、 Android マニフェストを含んでいます。ただし Android ライブラリは単一のアーカイブファイルではなく、特殊な構造を持つディレクトリに全てのアセットが含まれたものです。詳細は Android 開発者向けドキュメンテーションの、 Android ライブラリの作成に関するページを参照してください。

事前コンパイル済みの Android ライブラリプロジェクトを Assets/Plugins/Android フォルダーにインポートします。「事前コンパイル済み」ということは、 Unity へのインポートを行う前に、全ての .java ファイルが .jar ファイルにコンパイルされて該当 Android Studio プロジェクトの bin/ あるいは libs/ フォルダー内に置かれているということです。プロジェクトがビルドされる際、これらのフォルダーから AndroidManifest.xml が自動的にメインのマニフェストファイルに合併されます。

Unity は、 Assets/Plugins/Android の全てのサブフォルダーを、 Android ライブラリである可能性があるものとして扱い、これらのサブフォルダーからのアセットのインポートを無効化します。このサブフォルダーは、 AndroidManifest.xml ファイルを含んでいて project.properties ファイルに文字列 android.library=true が含まれている場合には、 Android ライブラリとして認識されます。

詳細は、Android 開発者向けドキュメンテーションの、ライブラリ モジュールに関するページ を参照してください。

追加の Android アセットとリソースの供給

Unity アプリケーションにアセットを加える必要がある場合は、変更しないで出力パッケージにコピーし、Assets/Plugins/Android/assets ディレクトリにインポートします。それらは APK の assets/ ディレクトリに表示され、Java コードの getAssets() Android API によってアクセスされます。

• 2017–05–18 Page published

• 5.5 のアップデート機能