ドキュメント

Unity Engine

Unity Engine

アプリケーションパッチ適用

完全なビルドではなく、アプリケーションパッチを実行してイテレーションスピード度を向上させます。
読み終わるまでの所要時間 7 分最終更新 5日前

Android 用アプリケーションの構築には、かなりの時間がかかる場合があります。開発中のイテレーションを高速化するには、アプリケーションパッケージを再構築する代わりにパッチを適用します。アプリケーションパッケージにパッチを適用すると、Unity は最後のパッチ以降に変更されたファイルのみを処理し、接続された Android デバイスに送信します。

アプリケーションのパッチ適用

アプリケーションにパッチを適用するには、Unity エディターを使用します。独自のビルドパイプラインを実装する場合は、スクリプティング API を使用します。
アプリケーションに初めてパッチをパッチすると、Unity はデバイスにパッチアプリケーション環境を設定します。つまり、最初のパッチは、以降のパッチよりも時間がかかります。

エディターから

Unity エディターからアプリケーションにパッチを適用する
  1. ビルドプロファイルウィンドウ (メニュー:ファイル> ビルドプロファイル)。
  2. 「プラットフォーム」パネルのプラットフォームのリストから、Android を選択するか、Android プラットフォームのビルドプロファイルを作成します。
  3. プラットフォーム設定セクションで、
    Development Build

    ?

    を有効にします。
  4. ビルド トゥ デバイス設定で、パッチを選択するか、Unity のビルド終了後にパッチを実行する場合は、パッチアンドランを選択します。

スクリプティング API の使用

独自のビルドパイプラインを実装する場合は、スクリプティング API を使用してアプリケーションにパッチを適用できます。これを行うには、 BuildOptions.BuildScriptsOnly オプションと BuildOptions.PatchPackage オプションを BuildPipeline.BuildPlayer メソッドに渡します。
例を次に示します。
BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();buildPlayerOptions.scenes = new[] { "Assets/Scene1.unity"};buildPlayerOptions.target = BuildTarget.Android;// Use Patch & Run for all builds for optimal turn-around times.// (In prior versions, an initial regular Build & Run was necessary.)buildPlayerOptions.options = BuildOptions.PatchPackage | BuildOptions.AutoRunPlayer | BuildOptions.Development;BuildPipeline.BuildPlayer(buildPlayerOptions);

アプリケーションパッチの適用の仕組み

アプリケーションにパッチを適用すると、Unity は以下を行います。
  • コンパイルされたすべての Java ソースを含む最小限の APK を作成します。
  • 最後のパッチ以降に変更されたファイルを取得し、アプリケーションのキャッシュフォルダー内のディレクトリ
    /storage/emulated/0/Android/data/<PackageName>/pram-shadow-files/
    に保存します。
  • Il2cpp を使用してコンパイルされたスクリプトを含むネイティブライブラリファイルを、アプリケーションのデータディレクトリ
    /data/data/<PackageName>/pram-shadow-files/lib/
    に保存します。
アプリケーションの起動時に、APK 内のマーカー ファイルが確認されます。マーカーが存在する場合、アプリケーションはファイルの読み取りを
pram-shadow-files
ディレクトリにリダイレクトします。
ビルドと実行ではパッチファイルは消去されません。代わりに、APK のインストールを置き換えます。これにより、
pram-shadow-files
ディレクトリへのリダイレクトがディセーブルになります。つまり、後続のパッチビルドでは、変更されていないファイルを再利用できます。

パッチファイルのクリア

Android ストレージ設定を使用して、アプリケーションのキャッシュを消去できます。キャッシュをクリアすると、アプリケーションのビルドプロセスによってインストールされたパッチファイルが削除されます。
アプリケーションのキャッシュを消去する手順は、Android デバイスによって異なります。デバイスのステップを見つけるには:
  1. デバイス製造元のヘルプを参照します。
  2. デバイスの製造元を調べて、そのサポートウェブサイトへのリンクを辿ってください。
  3. アプリケーションのキャッシュをクリアする手順については、サポート Web ウェブサイト を検索してください。