Unityでコンポーネントを簡単に置き換える方法

Question

シーンやプレハブでUnityEngine.UI.Textをアタッチしている部分をすべて
それを継承したMultilingualTextというコンポーネントに置き換えたいのですが、
手動で1つ1つRemoveしてAddしてフォント等の設定を変更して・・と手作業していくしかないのでしょうか。
もっと簡単な方法があれば教えてください。

◆環境
Unity2017 3.1f1

Answer 1

数が多いと面倒ですし、修正漏れも起こりそうですよね...
EditorUtility.CopySerializedでコンポーネントの設定を書き写すことができるそうですので、これを使って楽ができるんじゃないでしょうか。

プロジェクトに「Editor」フォルダを用意して下記のようなスクリプトを置き...

using System;
using System.Collections.Generic;
using System.Linq;
using UnityEditor;
using UnityEditor.AnimatedValues;
using UnityEngine;
using UnityEngine.UI;

public class ComponentReplacer : EditorWindow
{
	// ウィンドウを開いたときのデフォルトの置き換え元、置き換え先を変える場合はこの2つを書き換える
	private static readonly Type DefaultFromType = typeof(Text);
	private static readonly Type DefaultToType = typeof(MultilingualText);

	private AnimBool showInfo;
	private string fromTypeString = $"{DefaultFromType.FullName}, {DefaultFromType.Assembly.GetName().Name}";
	private string toTypeString = $"{DefaultToType.FullName}, {DefaultToType.Assembly.GetName().Name}";

	// 「Utility」→「Replace Components」で置き換えウィンドウを開く
	[MenuItem("Utility/Replace Components")]
	private static void OpenWindow()
	{
		var window = GetWindow<ComponentReplacer>("Replace Components");
		window.Show();
	}

	// エラーメッセージ表示用のAnimBoolを作成
	private void OnEnable()
	{
		this.showInfo = new AnimBool(true);
		this.showInfo.valueChanged.AddListener(this.Repaint);
	}

	private void OnGUI()
	{
		using (new EditorGUILayout.VerticalScope())
		{
			// 「From Type」、「To Type」の文字列と対応する型を探す
			var infoMessage = string.Empty;
			var infoType = MessageType.None;
			Type fromType = null;
			Type toType = null;
			try
			{
				this.fromTypeString = EditorGUILayout.TextField("From Type", this.fromTypeString);
				fromType = Type.GetType(this.fromTypeString, true);
				if (!typeof(Component).IsAssignableFrom(fromType))
				{
					// 置き換え元の型がComponentから派生していなければ失敗
					throw new Exception($"{this.fromTypeString} is not compatible with {typeof(Component)}.");
				}

				this.toTypeString = EditorGUILayout.TextField("To Type", this.toTypeString);
				toType = Type.GetType(this.toTypeString, true);
				if (!fromType.IsAssignableFrom(toType))
				{
					// 置き換え先の型が置き換え元の型から派生していなければ失敗
					throw new Exception($"{this.toTypeString} is not compatible with {fromType}.");
				}
			}
			catch (Exception exception)
			{
				infoMessage = exception.Message;
				infoType = MessageType.Error;
			}

			// もしエラーメッセージが出ていたら表示する
			this.showInfo.target = !string.IsNullOrEmpty(infoMessage);
			using (var fadeGroup = new EditorGUILayout.FadeGroupScope(this.showInfo.faded))
			{
				if (fadeGroup.visible)
				{
					EditorGUILayout.HelpBox(infoMessage, infoType, true);
				}
			}

			// 選択されているゲームオブジェクトやそれらの子階層からfromTypeコンポーネントを探し、
			// 1つ以上見つかって、かつエラーが出ていなければ「Replace」ボタンを使用可能にする
			var selectedObjects = Selection.gameObjects;
			var selectedComponents =
				selectedObjects.SelectMany(gameObject => gameObject.GetComponentsInChildren(fromType)).Distinct();
			using (new EditorGUI.DisabledScope((infoType == MessageType.Error) || !selectedComponents.Any()))
			{
				if (GUILayout.Button("Replace"))
				{
					this.Replace(fromType, toType, selectedComponents);
				}
			}
		}
	}

	private void Replace(Type fromType, Type toType, IEnumerable<Component> components)
	{
		Debug.Log($"{fromType} -> {toType}");
		foreach (var component in components)
		{
			var gameObject = component.gameObject;
			Debug.Log($"\t{gameObject.name}");
			Undo.SetCurrentGroupName($"Replace Components");

			// まず元のコンポーネントをゲームオブジェクトごと複製
			var cloneObject = Instantiate(gameObject, gameObject.transform.parent);
			var cloneComponent = cloneObject.GetComponent(fromType);

			// 元のコンポーネントは削除し、置き換え先のコンポーネントをアタッチ
			Undo.DestroyObjectImmediate(component);
			var newComponent = Undo.AddComponent(gameObject, toType);

			// 複製しておいた元コンポーネントから新しいコンポーネントにデータをコピー
			EditorUtility.CopySerialized(cloneComponent, newComponent);

			// 複製は不要になったので削除する
			DestroyImmediate(cloneObject);
		}
	}
}

• 処理対象のオブジェクトを選択する（複数選択、あるいは親オブジェクトを選択してもけっこうです）。
• 「Utility」→「Replace Components」で置き換えウィンドウを開く。
• 「From Type」に置き換え元、「To Type」に置き換え先の型を入力する（完全修飾・アセンブリ名付きでないと型が見つからないという不便な作りですが、そんなに多用するものでもないかと思いますのでご容赦ください...）。
• 処理対象が1つ以上選択されており、エラーもなければ「Replace」ボタンが使用可能になるのでクリックする。
• 取り消す場合はメニューの「Edit」→「Undo Replace Components」を実行する。

というのはどうでしょう。

Comments

[yrema]

参考にさせていただきます。ありがとうございます。