Skip to content

Commit

Permalink
Support OpenUPM
Browse files Browse the repository at this point in the history
  • Loading branch information
yuna0x0 committed Dec 29, 2024
1 parent f4632c7 commit 739f2a4
Show file tree
Hide file tree
Showing 3 changed files with 51 additions and 3 deletions.
25 changes: 24 additions & 1 deletion docs~/docs/getting-started/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,29 @@ It also makes updating DressingTools easier for users.

[![Installation VCC Teaser](/img/teaser-1.PNG)](/img/teaser-1.PNG)

### Via OpenUPM

:::info
[OpenUPM](https://openupm.com) is a package registry for open-source Unity packages. It can handle package updates and dependencies properly compared to UPM Git URL.

It is recommended to use OpenUPM for installation if you are not using VCC. Especially for users who are not using DressingTools for VRChat.
:::

You can install DressingTools via OpenUPM by following the instructions below.

#### A. Install via OpenUPM command-line interface (CLI)
1. If you haven't already, install the OpenUPM CLI by following the instructions on the [OpenUPM website](https://openupm.com/docs/getting-started-cli.html).

2. Run the following command in your project directory to install DressingTools, its dependencies will also be installed automatically:
```shell
openupm add com.chocopoi.vrc.dressingtools
```

#### B. Install manually via Unity Package Manager (UPM)
Follow the instructions on the OpenUPM website to install the packages manually:
- DressingTools
- [https://openupm.com/packages/com.chocopoi.vrc.dressingtools/](https://openupm.com/packages/com.chocopoi.vrc.dressingtools/)

### Via .unitypackage

:::info
Expand Down Expand Up @@ -82,7 +105,7 @@ Unity does not handle updates and dependencies properly for UPM Git URLs. Make s

[![Installation UPM Git Add from git URL](/img/installation-upmgit-install-from-git.PNG)](/img/installation-upmgit-install-from-git.PNG)

3. Add the following packages and make sure the required versions match the version of DressingTools that you are installing. Change the version after the `#` to your desired one.
3. Add the following packages from top to bottom, make sure the required versions match the version of DressingTools that you are installing. Change the version after the `#` to your desired one.

- AvatarLib
- `https://github.com/poi-vrc/AvatarLib.git#1.0.2`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,29 @@ DressingTools 是一個 **獨立的 Unity UPM 套件** 和 **不需要安裝任

[![安裝 VCC 預告片](/img/teaser-1.PNG)](/img/teaser-1.PNG)

### 透過 OpenUPM

:::info
[OpenUPM](https://openupm.com) 是一個供開源 Unity 套件的套件庫。相較於 UPM Git URL,它可以更加妥善的處理套件更新和相依性。

如果您不使用 VCC,建議使用 OpenUPM 進行安裝。特別是對於不使用 DressingTools 用於 VRChat 的用戶。
:::

您可以按照以下說明透過 OpenUPM 安裝 DressingTools。

#### A. 透過 OpenUPM 命令列介面 (CLI)
1. 如果您尚未安裝,請按照 [OpenUPM 網站](https://openupm.com/docs/getting-started-cli.html) 上的說明安裝 OpenUPM CLI。

2. 在您的專案目錄中執行以下命令以安裝 DressingTools,它的相依套件也將自動安裝:
```shell
openupm add com.chocopoi.vrc.dressingtools
```

#### B. 透過 Unity 套件管理器 (UPM) 手動安裝
按照 OpenUPM 網站上的說明手動安裝套件:
- DressingTools
- [https://openupm.com/packages/com.chocopoi.vrc.dressingtools/](https://openupm.com/packages/com.chocopoi.vrc.dressingtools/)

### 透過 .unitypackage

:::info
Expand Down Expand Up @@ -79,7 +102,7 @@ Unity 不會處理 UPM Git URL 的更新和依賴項。確保安裝正確版本

[![安裝 UPM Git](/img/installation-upmgit-install-from-git.PNG)](/img/installation-upmgit-install-from-git.PNG)

3. 新增以下套件並確保所需版本與您正在安裝的 DressingTools 版本相符。將`#`後面的版本變更為您想要的版本。
3. 從上到下新增以下套件,並確保所需版本與您正在安裝的 DressingTools 版本相符。將`#`後面的版本變更為您想要的版本。

- AvatarLib
- `https://github.com/poi-vrc/AvatarLib.git#1.0.2`
Expand Down
4 changes: 3 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,9 @@
},
"url": "https://github.com/poi-vrc/DressingTools",
"dependencies": {
"com.unity.nuget.newtonsoft-json": "2.0.2"
"com.unity.nuget.newtonsoft-json": "2.0.2",
"com.chocopoi.vrc.avatarlib": "1.1.0",
"com.chocopoi.vrc.dressingframework": "2.1.1"
},
"vpmDependencies": {
"com.vrchat.avatars": ">=3.2.0",
Expand Down

0 comments on commit 739f2a4

Please sign in to comment.