Unityのマイナーアップデート

VRChatは、Unityのマイナーバージョン間でアップデートが行われることがあります。例えば、Unity 2022.1.1からUnity 2022.1.2へといった更新です。

新しいUnityバージョンをインストールする

1. 開いているすべてのUnityプロジェクトを閉じます。

2. 現在サポートされているUnityバージョンを確認し、Unity Hub経由で新しいバージョンのUnityをインストールしてください。

   • 同ページにはスタンドアロンインストーラーも記載していますが、Hubの使用を強く推奨します。本ドキュメントでは、Hubを使用していることを前提としています。

プロジェクトをコピーする

1. プロジェクトをコピー、またはバックアップしてください。
   • VRChat Creator Companion（VCC）を使用している場合、プロジェクト移行前に自動的にコピーを提案してくれます。「Make Backup」ボタンを使用してプロジェクトのバックアップを作成できます。
   • それ以外の場合は、プロジェクトフォルダ全体を複製し、新しい名前を付けてください。
   • プロジェクト全体をUnity Packageとしてエクスポートしてください。これには時間がかかり、エラーが発生する可能性があります。

Gitのようなバージョン管理システムを利用できる上級者であれば、それを使用してください。

プロジェクトを開きます。

1. 新バージョンでプロジェクトのコピーを開きます。

   • アップグレードに関する警告が表示されますが、問題ありません。肯定的なボタンをクリックして進めてください。

2. しばらくすると移行が完了します。これで完了です！

補足情報とヒント

マイナーバージョンのアップグレードでは、SDKの更新が常に必要とは限りません。もし必要な場合は、このタイミングで行います。

1. アップグレード後、プロジェクトを閉じます。
2. VCCを使用してSDKをアップグレードしてください。

Unityの警告

移行中に表示されるUnityの警告の中には、そのまま無視して進めて問題ないものがいくつかあります。以下によく見られる例を挙げます。

コピーの整理

プロジェクトが大規模な場合、移行に時間がかかることがあります。特にプロジェクトが巨大な場合は、移行不要なフォルダがいくつかあります。以下のフォルダはコピーから安全に削除できます。

/Library/
/Temp/
/Obj/
/Build/
/Builds/
/Logs/
/UserSettings/

バージョンの警告

SDKが誤ったバージョンであると警告を出すことがありますが、正しいバージョンであることを確認している場合は無視して問題ありません。

問題ありません！正しいバージョンを使用していることが確実であれば、このメッセージは無視して構いません。