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

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

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

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

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

If you want Unity to split the app output package into APK and OBB for you, open the Player settings (menu: Edit > Project Settings, then select the Player category), and in the Publishing Settings panel, enable the Split Application Binary property.

The Publishing Settings panel of the Player settings, with the Split Application Binary checkbox highlighted
The Publishing Settings panel of the Player settings, with the Split Application Binary checkbox highlighted

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

Build and Run を選択すると、Unity によって APK と OBB ファイルがデバイスにインストールされます。__Build __ を選んで、ADB ユーティリティーを使って手動でアプリケーションをインストールしたい場合は、最初に APK をインストールしてからデバイスの正しい場所に OBB をコピーしなくてはなりません。OBB ファイル名は Google に必要な形式に共通するものでなければなりません。詳細は、Android デベロッパードキュメントの APK Expansion Files セクションを参照してください。

アプリケーションが始まっても 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 編集レビュー を行ってパブリッシュされたページ

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

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