VRChat 非公式日本語ドキュメント

Updating the SDK

SDKをアップデートする必要がある場合は、アップデートを適切に進行させ、古いファイルや競合するファイルが残らないようにするため、以下の手順に従ってください。

バージョン管理

使用方法を心得ているのであれば、Git などのバージョン管理ソフトウェアを使用してプロジェクトを管理すると便利です。バージョン管理の恩恵を受けるために、リポジトリを GitHub などのサービスへアップロードする必要はありません。念のため、SDK をアップグレードする前にコミットを作成しておきましょう。

VRChat Creator Companion

VCCを使用すれば、SDKを最新の状態に保つのは非常に簡単です。使い方の詳細は VRChat Creator Companionのドキュメント を参照してください！

VCCへの移行

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

手動アップデート

VCCを使用している場合、手動アップデートについて心配する必要はありません。 しかし、必要に応じて、VRChatアカウントにサインインした上で VRChatウェブサイト からSDKをダウンロードすることも可能です。

Legacy SDK3

caution

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

SDK3の場合、基本的には古いSDKの上から新しいSDKをインポートする「インプレース・アップグレード（上書き更新）」を行うだけでアップデートが可能です。 これはSDK3-Avatarsにおいて特に重要です。誤った方法でアップデートすると、Animator内のState Behaviorsが失われる可能性があるため注意してください！

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

SDK3 - World

  1. Unityを閉じます。
  2. Unityプロジェクトをバックアップします！Libraryフォルダをバックアップする必要はありません。これらのファイルはUnityによって自動生成されます。
2020.3.2より前のSDK3からアップグレードする場合

これは一般的ではない手順であり、通常は行う必要はありません。

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

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

SDK3 - Avatars

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

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

もしSDK3 - Avatarsパッケージの「完全な削除再インストール」を実行しなければならない場合は、必ず先にプロジェクトをバックアップしてください。State Behaviorsを再設定する必要があるため、内容を確実に記録しておいてください。

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

SDK3 for AvatarsをAvatar Dynamics SDKに初めてアップグレードする際、いくつかのエラーが発生することがあります。これは、インストールプロセス中にSDKがBurstおよびMathematicsパッケージをインストールしようとし、Unityがそれを早期にインポートしようとして先行してしまうために発生します。

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

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

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

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

高度なアップデート手順

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

  1. Unityを閉じます。
  2. プロジェクトを別のフォルダにバックアップします（Libraryフォルダはバックアップしないでください。これらのファイルはUnityによって自動生成されます）。
  3. SDKフォルダとPluginsフォルダ、および関連する.METAファイルを削除します。
  4. アップグレード対象のプロジェクトにおいて、VRChat SDK3の参照先を Packages/vpm-manifest.json から新しいSDKバージョンに変更します。
  5. Unity Hubで空のUnityプロジェクトを作成し、新しい「ダミー」Unityプロジェクトを用意します。
  6. ダミープロジェクトに最新のVRChat SDKをインストールします。
  7. ダミープロジェクトで新しく追加された SDK/Plugin フォルダと関連する .meta ファイルを、元のプロジェクトにコピーします。
  8. 完了です。これでアップグレードしたプロジェクトを開くことができます。

Unityのアップデート

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

最終更新: