【Unity】僕はそろそろResourcesフォルダを卒業しようと思う

Addressableがいい感じになってきたしそろそろResourcesフォルダを使った開発を卒業しようという話です。

Resourcesフォルダは非推奨
- なぜ非推奨なのか？
- Resourcesを使ってもいいケース
Addressableアセットシステムを使う
実際にAddressableをResourcesの代わりとして使ってみる
便利ツールの紹介
- アドレス設定を自動化するEZAddresser
- Unity Addressable Importer
Addressableアセットシステム関連記事

Unity2019.3.5
Addressables 1.7.5

Resourcesフォルダは非推奨

Resourcesフォルダはお手軽にアセットを読み込む際には便利な方法です。
しかし実はResourcesフォルダによるアセットの読み込みはUnityが公式としてもはや推奨していない方法になります。
実際に下の記事には、Resourcesフォルダのベストプラクティスの項に「Don't use it.」と書かれています。

learn.unity.com

なぜ非推奨なのか？

使うべきでない理由として、上の記事では以下の3点が挙げられています。

細かなメモリ管理が難しくなる
Resourcesに入っているアセットが多いとアプリの立ち上げ時間やビルド時間が長くなる
プラットフォームに応じたリソースの配信ができない

1.に関して補足すると、ResourcesにはResources.UnloadAssets()というAPIが用意されていますが、
これは単純にそのアセットのアンロードを行うだけであり、参照カウンタによる厳密なメモリ管理や依存関係を含めたアンロードを行う機能は備えていません。
またResources.UnloadUnusedAssets()というAPIもありますが、こちらは使っていないリソースを一気にアンロードするというかなりざっくりした機能です。

Resourcesを使ってもいいケース

ただし以下のようなケースに限って言えば便利な機能であるとされています。

プロトタイプ作成時（※これは今は事情が変わっていそう（下記参照））
アプリが立ち上がっている間常駐するリソース
メモリをそんなに食わないものに使用する場合
プラットフォーム間でリソースを切り替える必要がない場合
アプリ立ち上げ処理用に使う場合

個人的にはこれに加えてエディタ用のツールを作る際には使うべきケースも多いと思います。

ただしこのケースが挙げられた記事はAddressableアセットシステムの登場以前に書かれたものであり、
Addressableが登場した今となっては「1. プロトタイプ作成時」にもResourcesは使わないほうが良いかと思います。
このあたりについては次節以降で詳しく説明します。

Addressableアセットシステムを使う

じゃあResourcesを使わずにどうするのかというと、Addressableアセットシステムを使います。
AddressableアセットシステムはUnity2019.2か3あたりで本リリースされた、リソース管理の仕組みです。

「アドレス」を使ってロードする

Addressableアセットシステムの大きな特徴として「アドレス」があります。
アドレスとはアセット毎に付けることができる任意の名前であり、それを指定することでリソースを読み込みます。

ソースコードとしては以下のような感じになります。

// アドレスを使ってロードする
Addressables.LoadAssetAsync<GameObject>("ExamplePrefab");

設定一つで組み込み/DLCを切り替え

またAddressableは開発のワークフローを強く意識した作りになっており、
設定項目を切り替えるだけでそのアセットをアプリに組み込むアセットとするかダウンロードコンテンツとするかを変更できます。

そしてどちらの場合でも読み込みの仕方は変わりません。設定を切り替えるだけです。

Addressables.LoadAssetAsync<GameObject>("ExamplePrefab");

プロトタイプからAssetBundleに移行するためのコストがゼロに

さて、アプリのプロトタイプや本開発の初期フェーズではとりあえずResourcesフォルダを使うことも多いと思います。
この場合には、Resourcesフォルダからの相対パスを指定してアセットを読み込むことになります。
例えばAssets/Resources/Prefabs/ExamplePrefab.prefabを読み込むには以下のように記述します。

Resources.LoadAsync("Prefabs/ExamplePrefab.prefab");

しかしプロジェクトが進むにつれて、このように読んでいたリソースをResourcesフォルダ外に移動してAssetBundleとして切り出す必要が出てきます。
AssetBundleの読み込みはAssetBundle名とアセット名を使って行います。

var assetBundle = AssetBundle.LoadFromFile("SomeFolder/some_bundle.bundle");
assetBundle.LoadAssetAsync<GameObject>("Assets/Prefabs/ExamplePrefab.prefab");

すると当然、Resourcesを使って書いていた読み込み処理を大きく修正する必要が出てきます。

これに対してAddressableでは上記の通り、設定を切り替えるだけで組み込みかダウンロードコンテンツかを切り替えられるため、このようにパスを書き換えるようなコストは発生しません。

厳密なメモリ管理

またAddressableは内部で参照カウンタを持っており、厳密なメモリ管理が可能になっています。
ロードを行うたびに参照カウンタがインクリメントされます。

// 参照カウンタがインクリメント
var handle = Addressables.LoadAssetAsync<GameObject>("ExamplePrefab");

アンロードを行うと参照カウンタがデクリメントされ、ゼロになったらそのリソースはアンロードされます。

// 参照カウンタがデクリメント
// ゼロになったらアンロード
Addressables.Release(handle);

実際にAddressableをResourcesの代わりとして使ってみる

それでは実際にAddressableアセットシステムをResourcesフォルダの代わりに使ってみます。
Addressableの細かい使い方は別の記事（最下部にまとめています）で説明するとして、ここではざっくり概要がわかるように説明します。

まずPackage ManagerからAddressablesをインストールし、Window > Asset Management > Addressables > Groupsからウィンドウを開きます。

アドレスを登録する

初期設定ではDefault Local Groupというのが組み込みリソース用のグループになります。
なおBuilt in Dataはビルド設定に含まれるシーンとResourcesフォルダに入ったものです。
Addressableの仕組みに乗らない（アドレスを振れない）のでグレーアウトされています。

というわけでこのDefault Local Groupに適当なPrefabをドラッグ&ドロップします。
アドレスには適当な文字列を入力しておきます。
今回は以下のようにAssets/Prefabs/Example.prefabをExampleというアドレスで登録しました。

読み込みスクリプトを書く

次にこれを読み込むスクリプトを書きます。

using UnityEngine;
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;

public class Example : MonoBehaviour
{
    private AsyncOperationHandle<GameObject> _handle;
    
    private async void Start()
    {
        // ロード&インスタンス化
        _handle = Addressables.InstantiateAsync("Example", Vector3.zero, Quaternion.identity);
        await _handle.Task;
    }

    private void OnDestroy()
    {
        // 解放
        Addressables.ReleaseInstance(_handle);
    }
}

エディタで再生してみると正常にGameObjectが生成されることを確認できます。

実機ビルドする

次に実機ビルドを行います。
Addressableを実機で使うためにはAddressableのビルドを行う必要があります。
ビルドを行うためにはAddressableのウィンドウからBuild > New Build > Default Build Scriptを選択します。

これによりAddressableの内部で使われているAssetBundleのビルドと、アドレスや依存関係の情報を構築されます。
組み込み用のAssetBundleはAddressableアセットシステムがアプリのビルド時にアプリ（StreamingAssets）に含めてくれます。

そのためあとは普通にアプリをビルドするだけです。

実機ビルドでも正常にリソースが読み込めることを確認できました。

Addressableのビルドを自動化する

※ 2021年12月15日追記※
こちら情報が更新され、Unity2021.2以上、Addressables 1.19.4であれば、
Addressable Asset SettingsのBuild Addressables content on Player Buildにチェックを入れれば
プレイヤービルド時にAddressblesもビルドされるようになりました。

この節のうちの以下の部分についてはそれ以前に書いた内容です

さてビルド前にいちいちAddressableをビルドするのは面倒だし忘れるので自動化します。
ビルドウィンドウからBuildボタンが押されたときにAddressableのビルドも走らせるようにします。

using UnityEditor;
using UnityEditor.AddressableAssets;
using UnityEditor.AddressableAssets.Settings;

public class AddressableBuilder
{
    [InitializeOnLoadMethod]
    private static void Initialize()
    {
        // ビルドボタンの押下をフック
        BuildPlayerWindow.RegisterBuildPlayerHandler(BuildPlayerHandler);
    }
 
    private static void BuildPlayerHandler(BuildPlayerOptions options)
    {
        // 必要に応じてClean
        AddressableAssetSettings.CleanPlayerContent(AddressableAssetSettingsDefaultObject.Settings.ActivePlayerDataBuilder);
        
        // Addressableをビルド
        AddressableAssetSettings.BuildPlayerContent();
        
        // Playerをビルド
        BuildPlayerWindow.DefaultBuildMethods.BuildPlayer(options);
    }
}