Android でクラッシュしたときのバグレポート方法
Android スクリプティング

APK 拡張ファイル (OBB) のサポート

APK 拡張ファイルは、Google Play Store でアプリケーションサイズが 100MB に制限されていることに対するソリューションとして使用されています。アプリケーションが 100MB より大きな場合 (大きなゲームの場合はしばしばあり得ます) は、出力パッケージをメインの部分 (APK) と拡張ファイル (OBB) に分割する必要があります。詳しくは Android デベロッパードキュメントの APK Expansion Files を参照してください。

Unity は自動的に出力パッケージを APK と OBB に分割します。これが唯一のアプリケーションパッケージの分割方法というわけではありません。サードパーティー製のプラグインや アセットバンドル などの選択肢もあります。ただし、Unity に公式にサポートされている自動分割は APK と OBB への分割だけです。

Note: Unity only creates the main expansion file. If you want to manually create the patch expansion file, you must include a file named with your build-id; otherwise, the patch expansion file won’t load. The file can be empty, but you must place it in the Assets directory inside the patch expansion file. This file’s name must match the unity.build-id metadata, which Unity automatically adds to the manifest when you build the APK. Alternatively, you can copy this file from the main expansion file into the patch expansion file.

拡張ファイル付きアプリケーションのビルド

アプリケーション出力パッケージを APK と OBB に分割したい場合は、Player 設定 (Edit > Project Settings の順に移動してから Player を選択) を開き、Publishing Settings セクションで Split Application Binary プロパティーを有効にします。

Player Settings の Publishing Settings セクションで、Split Application Binary チェックボックスがハイライトされている
Player Settings の Publishing Settings セクションで、Split Application Binary チェックボックスがハイライトされている

両方の出力パッケージ (APK と OBB) は、アプリケーションのビルド時に指定した出力ディレクトリにコピーされます。例えば、APK は mygame.apk と名付けられ、OBB は同じディレクトリに mygame.main.obb という名前でコピーされます。

If you select Build and Run, the APK and OBB files are installed on your device by Unity. If you select Build and want to install the app manually using the ADB utility, you must first install the APK and then copy the OBB into the correct location on your device. The OBB file name must correspond the format required by Google. Refer to the expansion files section of the Android Developer documentation for more information.

アプリケーションが起動しても OBB を見つけて読み込みができない場合は、最初のシーンのみ使用可能です (詳しくは、後述の「APK と OBB へのデータの分割方法」を参照)。OBB ファイルのコンテンツを個別に使用しないでください。ひとつの大きい APK ファイルを扱うように、APK と OBB を固有のバンドルとして扱ってください。 

APK と OBB へのデータの分割方法

Split Application Binary オプションが有効のとき、アプリケーションは以下のように分割されます。

  • APK - 実行ファイル (Java とネイティブ)、プラグイン、スクリプト、最初のシーン (インデックス 0) のデータから構成されます。

  • OBB - 上記以外のすべて。残りのシーンすべて、リソース、ストリーミングアセットを含みます。

それでもなお、Google Play Store でパブリッシュするには APK が大きすぎる (100MB より大きい) 場合は、最初のシーンのサイズを可能な限り減らすようにします。

OBB 拡張ファイルのダウンロード

Unity アセットストア は Unity のための Google Play market_downloader ライブラリの適応バージョンにアクセスできるプラグインを提供しています。このプラグインを使って Google Play Store から OBB や外部ソースをダウンロードしたり、それを正しいディレクトリに移動することができます。

Google Play Store で OBB ファイルを取得する方法

OBB 拡張ファイルは APK といっしょに Google Play Store にパブリッシュしなければなりません。APK といっしょにパブリッシュされた OBB ファイルはすべて、ユーザーが Google Play Store からアプリケーションをインストールするときに自動的にダウンロードされます。

Google Play Store のエラーの場合、または、ユーザーが OBB ファイルをデバイスから削除した場合に、欠けている OBB ファイルをダウンロードするアプリケーションコードを含んでおくとよいでしょう。OBB ファイルのダウンロードに関する詳しい情報は、Android デベロッパーのドキュメントの APK Expansion file セクションを参照してください。

Google Play ストアを利用せずに OBB ファイルを取得する方法

Google Play ストアを使用したくなければ、自身で OBB ファイルをホストすることもできます。ただし、Google Play ストアを使用せずに OBB ファイルをホストすることは、上級のユーザーのみに推奨されます。


  • 2017–05–25 Page published

  • バージョン 5.5 の更新機能

Android でクラッシュしたときのバグレポート方法
Android スクリプティング