SDKのアップデート

SDKをアップデートする必要がある場合は、アップデートが正常に完了し、古いファイルや競合するファイルが残らないように、以下の手順に従ってください。

バージョン管理

バージョン管理ソフト（Gitなど）の使い方がわかる場合は、それらを使用してプロジェクトを管理すると便利です。バージョン管理のメリットを享受するために、リポジトリをGitHubなどのサービスにアップロードする必要はありません。念のため、SDKをアップグレードする前にコミットを作成しておきましょう。

VRChat Creator Companion

VCCを使用すれば、SDKを簡単に最新の状態に保つことができます。使い方はVRChat Creator Companionのドキュメントをご覧ください！

VCCへの移行

プロジェクトをVCCへ移行する方法については、こちらのガイドをご確認ください。

手動アップデート

VCCを使用している場合、手動でのアップデートを気にする必要はありません。ただし、必要であれば、VRChatアカウントにサインインした後、VRChatウェブサイトからSDKをダウンロードできます。

レガシーSDK3

caution

これらの手順は、レガシーSDK（Assets\VRCSDK）を使用しているユーザーにのみ適用されます。SDKがPackagesフォルダー（Packages\com.vrchat.base）にある場合は、以下の手順に従わないでください。

SDK3の場合、古いSDKに新しいSDKを上書きインポートするだけでアップデートできるはずです（インプレースアップグレードといいます）。SDK3-Avatarsの場合は特に重要で、アップデート方法を誤るとAnimatorのState Behaviorsが失われる可能性があります！

念には念を入れるなら、SDKをアップデートする前に必ずプロジェクトのバックアップを取ってください。

SDK3 - World

Unityを閉じます。
Unityプロジェクトをバックアップしてください！Libraryフォルダーのバックアップは不要です。これらのファイルはUnityによって自動生成されます。

2020.3.2より前のSDK3アップグレード

これは一般的な手順ではなく、通常実行する必要はありません。

2020.3.2より古いバージョンのSDKからアップグレードする場合は、プロジェクトのAssetsフォルダーに移動し、VRCSDKおよびUdonフォルダーと、VRCSDK.metaおよびUdon.metaファイルを削除してください。

Unityプロジェクトを開きます。
新しいSDK3 - Worldを古いものの上からインポートします。

SDK3 - Avatars

SDK3 - Avatarsに対して「削除して再インストール」は行わないでください！

Unityを閉じた状態でSDKフォルダーを削除し、SDKがインストールされていない状態でUnityを開くと、State Behaviorsが失われます。これらは繊細であり、完全に削除するアップグレードを行うと維持されません。プロジェクトのバックアップをこまめに取り、State Behaviorsの設定を保存・記録しておくようにしてください。

もしSDK3 - Avatarsパッケージを完全に削除して再インストールしなければならない場合は、まずプロジェクトのバックアップを取ってください。State Behaviorsを再度設定する必要があるため、記録をしっかりと残しておいてください。

Unityを閉じます。
Unityプロジェクトをバックアップしてください！Libraryフォルダーをバックアップする必要はありません。これらのファイルはUnityによって自動生成されます。
Unityプロジェクトを開きます。
新しいSDK3 - Avatarsを古いものの上からインポートします。インポート完了後にエラーが発生した場合は、その後Unityを再起動してみてください。

SDK3 - Avatarsのアップデート時に発生する想定内のエラー

SDK3 - AvatarsをAvatar Dynamics SDKに初めてアップグレードする際、いくつかのエラーが発生するのは想定内の挙動です。これは、インストールプロセス中にSDKがBurstおよびMathematicsパッケージをインストールしようとする際、Unityがそれらを早期にインポートしすぎてしまうことに起因します。

エラーを消去するかUnityを再起動すれば、これらのエラーは解消されるはずです。

SDK3 - Avatars - 別プロジェクトを使用したアップグレード手順

上記の手順でアップグレードがうまくいかない場合は、代わりに以下の方法を試してください：

Unityを閉じます。
新規の空プロジェクトを作成します。
そのプロジェクトに新しいSDK3 - Avatarsパッケージをインポートします。
そのUnityプロジェクトを閉じます。
エクスプローラーを使用して（まだUnityは開かないでください！）、アップグレード対象のプロジェクトからVRCSDK3フォルダーを削除します。このガイドで指示があるまで、Unityは開かないでください。
アップグレード対象プロジェクトの Packages/vpm-manifest.json を開き、VRChat SDK3の参照先を新しいSDKバージョンに書き換えます。
SDKをインポートした新しい空プロジェクトから、VRCSDK3フォルダーをアップグレード対象のプロジェクトへコピーします。
ファイルのコピーが完了したら、Unityを起動してアップグレードしたプロジェクトを開きます。空プロジェクトは削除して構いません。

高度なアップデート手順

複雑なトリガー設定を使用したワールドを含むプロジェクトでSDKを再インストールする場合、より安全なSDKの更新方法は以下の通りです。

Unityを閉じます。
プロジェクトを別のフォルダーにバックアップします（Libraryフォルダーは自動生成されるファイルであるため、バックアップしないでください）。
SDKおよびPluginsフォルダー、およびそれらに関連する.metaファイルを削除します。
Packages/vpm-manifest.json内のVRChat SDK3の参照を、アップグレード先のプロジェクトの新しいSDKバージョンに書き換えます。
Unity Hubを使用して空のUnityプロジェクトを作成し、新しい「ダミー」Unityプロジェクトを作成します。
ダミープロジェクトに最新のVRChat SDKをインストールします。
ダミープロジェクトで新たに追加されたSDK/Pluginsフォルダーと、それに関連する.metaファイルを、元のプロジェクトにコピーします。
完了です。これでアップグレードしたプロジェクトを開くことができます。

Unityのアップデート

以前のバージョンのUnityからアップデートする場合は、弊社がサポートする最新バージョンへのアップデートガイドをご覧ください！

最終更新: 2025年1月13日