3
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

[Unity] 別名でシリアライズされた値のシリアライズ名を強制的に書き換える

Last updated at Posted at 2019-09-15

概要

SerializeFieldのフィールド名を変えると、Unity内部ではフィールド名をキーとして値をシリアライズしているため、参照が解決できなくなり値が失われてしまう。
そこでFormerlySerializedAsAttributeを用いることで、リネーム前のシリアライズ値を利用することが可能になる。

public class MyClass : MonoBehaviour
{
    [FormerlySerializedAs("myValue")]
    string m_MyValue;
    public string myValue
    {
        get { return m_MyValue; }
        set { m_MyValue = value; }
    }
}

しかし、FormerlySerializedAsAttributeの機能はあくまで別名でシリアライズされた値を読むことだけであり、自動的にシリアライズ名のリネームを行ってくれるという気の利いた機能までは持っていない。
シリアライズ名の書き替えが行われるには、何らかの理由で対象のオブジェクトが再保存される必要がある。オブジェクトが再保存される際には新しいシリアライズ名を用いてシリアライズが行われる。

従って、全てのオブジェクトのシリアライズ名を書き換えなければFormerlySerializedAsAttributeをコード上から削除することはできない
これはあまり好ましくないため、全てのオブジェクトのシリアライズ名を強制的に書き換える方法を考える。

解決法

以下の手順によって解決ができる。

  1. 変数名を変え、FormerlySerializedAsAttributeを設定する
  2. 対象のオブジェクトを含む全てのアセットを取得する
  3. EditorUtility.SetDirtyにより再保存フラグを立てる
  4. AssetDatabase.SaveAssetsで全てのアセットを再保存する
  5. FormerlySerializedAsAttributeを削除する

SerializeFieldを持てるのはMonobehaviourとScriptableObjectの2種類あるが、それぞれで2の対処法が異なる。

ScriptableObjectの場合

ScriptableObjectの場合、必ず単体のアセットとして存在しているため、AssetDatabase.FindAssetsを使うことで簡単に全てのアセットを取得することができる。

[MenuItem("Tools/UpdateMyScriptableObject")]
public static void UpdateMyScriptableObject()
{
    // 全ての対象アセットを取得する
    var assetGUIDs = AssetDatabase.FindAssets("t:MyScriptableObject");
    foreach (var assetGUID in assetGUIDs)
    {
        var assetPath = AssetDatabase.GUIDToAssetPath(assetGUID);
        var asset = AssetDatabase.LoadAssetAtPath<MyScriptableObject>(assetPath);
        // 再保存フラグを立てる
        EditorUtility.SetDirty(asset);
    }
    // 再保存する
    AssetDatabase.SaveAssets();
}

MonoBehaviourの場合

MonoBehaviourの場合は少し厄介になる。
対象のコンポーネントを含む全てのSceneまたはPrefabを取得する必要があるが、そのためには全てのSceneとPrefabを走査する必要がある。

[MenuItem("Tools/UpdateMyMonoBehaviour")]
public static void UpdateMyMonoBehaviour()
{
    // Prefabを走査
    var prefabGUIDs = AssetDatabase.FindAssets("t:Prefab");
    foreach (var prefabGUID in prefabGUIDs)
    {
        var assetPath = AssetDatabase.GUIDToAssetPath(prefabGUID);
        var asset = AssetDatabase.LoadAssetAtPath<GameObject>(assetPath);
        var component = asset.GetComponentInChildren<MyMonoBehaviour>();
        if (component != null)
        {
            // MyMonoBehaviourを持つ場合、再保存フラグを立てる
            EditorUtility.SetDirty(asset);
        }
    }
    AssetDatabase.SaveAssets();

    // Sceneを走査
    var sceneGUIDs = AssetDatabase.FindAssets("t:Scene");
    foreach (var sceneGUID in sceneGUIDs)
    {
        var scenePath = AssetDatabase.GUIDToAssetPath(sceneGUID);
        var scene = EditorSceneManager.OpenScene(scenePath);
        var rootGameObjects = scene.GetRootGameObjects();

        foreach (var go in rootGameObjects)
        {
            var component = go.GetComponentInChildren<MyMonoBehaviour>();
            if (component != null)
            {
                // MyMonoBehaviourを持つ場合、再保存する
                EditorSceneManager.MarkSceneDirty(scene);
                EditorSceneManager.SaveScene(scene);
                break;
            }
        }
    }
}

予め影響範囲がある程度分かっている場合は、FindAssetsの第2引数にアセットのディレクトリを指定するなどで走査範囲を狭めることで処理時間を短縮することができる。

参考

3
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?