前置き
UE4でゲームを作り出す時点で適当な名前を付けてしまって後から変えたくなった、更にプラグイン等の導入でC++化してしまった私の備忘録です。
Twitterでは文字数全然足りなかったので…。
C++コード打つ方はこんなことで困らないと思うので、需要は無いかもしれませんが、私のような人もいるかもしれませんので参考に残しておこうと思います。
BPのみのプロジェクトであれば、おかずさんの記事に解決方法がありますのでそちらを参照してください。
ご説明頂いている通りにクローン化をするとC++化したプロジェクジェクトの場合、slnファイルやその他の名前が元のままになります。
でも、動いてUEのプロジェクト名が変わればそれでいいんだよ、という方には以下の記事は参考になりません。
今回は、そういうところもなんか気持ち悪い！！！という稀な方向けです。
また、今回の記事はあくまでも私の環境ではこれで問題なかった、という内容ですので全ての環境で同じ手順かどうかはわかりませんことと、類似部分はある程度省きますのでこの点をご留意ください。
※ソースファイルを直接書き換えますので不安な方はやめておきましょう。
最悪直せなくなってプロジェクトが開けなくなる恐れがありますので自己責任でお願いします。
手順
※Unreal Engine4.27.2での記事です。
1.変更したい元のプロジェクトのクローンを作成
2.一部ファイルを直接書き換え
1.変更したい元プロジェクトのクローンを作成
色々触って動かなくなってしまうなどのトラブルが発生する可能性がありますので必ずクローンしてバックアップをしておきましょう。
クローンボタンを押して新しいプロジェクト名を入力することになりますが、警告が出ます。
ここではTESTProjectからHogeに変更するとします。
構わず続けるを押しましょう。
クローンが出来ました。
が、しかしslnファイルの名前がそのまま、Sourceフォルダ内もいくつかそのままの名前のものがあります。
更にC++クラスを追加しようとすると警告が発生します。
複数ファイルのリネームと、中身を直接書き換えを行って解決したいと思います。
2.一部ファイルを直接書き換え
注意)この作業を始めると問題なく書き換えが全て終わるまで.uprojectがエラーで開けなくなります。
書き換えが必要なファイル/フォルダ
・/TESTProject.sln
・/Source/TESTproject.Target.cs
・/Source/TESTprojectEditor.Target.cs
・/Source/TESTProject/TESTProject.Build.cs
・/Source/TESTProject/TESTProject.cpp
・/Source/TESTProject/Hoge.h
・Pluginによって追加された.hファイル
・自身で追加した.hファイル
・/Config/DefaultEngine.ini
・Hoge.uproject
・その他、旧プロジェクト名が存在するファイル
このファイル達の中に、以前のプロジェクト名である、"TESTProject"という文字列が残っています。
これを全て"Hoge"置換えていきます。
合わせて、このファイル達のファイル名もHoge.Target.csなどのように全てリネームします。
TESTProject.slnを開いてファイル名も書き換えもVisualStudio上で行うのをオススメします。
例)
TESTProject.cpp(3箇所ありますが全て置換え)
MyCharacter.h(自分で追加したC++クラス。ここは全て大文字)
Hoge.uproject(ここにもあります)
書き換えが終わったらVisualStudioを閉じてHoge.uprojectを起動してみます。
上のように出るのでリビルトということではいを選択。
あら、どこかおかしいようです。
この時点で絶望を感じますが、Logを確認してみましょう。
/Saved/Logsフォルダ内の更新日時が一番新しい.logファイルを確認。
どうやらHoge.Target.csがおかしいらしい。
ということで元ファイルの同じ.csファイルと比べて確認してみたら書き換えた部分からTargetが抜けてしまっていたようです。
HogeTargetに修正。
それでは気を取り直して再度Hoge.uprojectを開きます。
正しく書き換えが完了していれば以下のようにビルドが走るはずです。
無事にプロジェクトを開くことができました。
右上のプロジェクト名もHogeになっていますね。
では、警告が出ていた新規C++クラスの追加を確認してみましょう。
とりあえず適当にActorクラスを追加してみます。
無事に警告なしで追加することができました！！
まとめ
あらゆる箇所を元プロジェクト名から新プロジェクト名にひたすら書き換える、というだけでした。
書き換え漏れやミスも、Logファイルをたどってどこでエラーが出てるかを確認して修正すれば大丈夫です。
ヘッダーとかよくわかってませんがとりあえずこれで問題なく動いておりますし、Windowsパッケージ化、Androidパッケージ化も試しましたがエラーは出ませんでした。
ニッチな需要かとは思いますが参考になれば幸いです。