Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
FejZa committed May 8, 2024
1 parent 6c19f0c commit 8369704
Showing 1 changed file with 37 additions and 11 deletions.
48 changes: 37 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,24 +13,50 @@ The OpenXR module for the [Reality Toolkit](https://www.realitytoolkit.io/).

Make sure to always use the same source for all toolkit modules. Avoid using different installation sources within the same project. We provide the following ways to install Reality Toolkit modules:

### Method 1: Using Package Manager for git users
### Method 1: OpenUPM CLI

1. Open the **Package Manager** using the `Window menu -> Package Manager`.

2. Inside the **Package Manager**, click on the "+" button on the top left and select `Add package from git URL...`

3. Input the following URL: https://github.com/realitycollective/com.realitytoolkit.openxr.git and click **`Add`**.

### Method 2: OpenUPM
This method requires the [OpenUPM CLI](https://openupm.com/#get-started-with-cli-optional) to be installed on your computer.

```text
openupm add com.realitytoolkit.openxr
```

### Method 3: Unity Asset Store
### Method 2: OpenUPM Scoped Registry

If you do not wish to use the [OpenUPM CLI](https://openupm.com/#get-started-with-cli-optional) you can also manually add the OpenUPM registry to your project and browse all available toolkit packages.

1. Open the [Project Settings](https://docs.unity3d.com/Manual/comp-ManagerGroup.html) window.

2. Select the **Package Manager** settings category to the left.

3. Add a new scoped registry
1. Name: **OpenUPM**
2. URL: **https://package.openupm.com**
3. Scopes: **com.realitycollective** and **com.realitytoolkit**
4. Press **Save**

![Add Scoped Registry](https://github.com/realitycollective/realitycollective.logo/blob/main/RealityToolkit/ReadmeAssets/add-scoped-registry.png?raw=true)

4. Open the [Package Manager](https://docs.unity3d.com/Manual/Packages.html) window.

5. In the top left packages filter dropdown select **My Registries**.

6. You'll now see all published toolkit packages listed for you to install.

![Add Scoped Registry](https://github.com/realitycollective/realitycollective.logo/blob/main/RealityToolkit/ReadmeAssets/package-manager-registry.png?raw=true)

### Method 3: Using Package Manager for git users

1. Open the [Package Manager](https://docs.unity3d.com/Manual/Packages.html) through this menu: **Window -> Package Manager**.

2. Inside the [Package Manager](https://docs.unity3d.com/Manual/Packages.html), click on the **+** button on the top left and select **Add package from git URL...**.

3. Input the following URL: https://github.com/realitycollective/com.realitytoolkit.openxr.git and click **Add**.

### Method 4: Unity Asset Store

This option will be available soon.
We are working on making the Reality Toolkit available via the Unity asset store and will share news, once available.

## Getting Started

Check the ["Getting Started"](https://www.realitytoolkit.io/) documentation for the Reality Toolkit and to learn more about this module.
Check the [Getting Started](https://www.realitytoolkit.io/) documentation for the Reality Toolkit and to learn more about this module.

0 comments on commit 8369704

Please sign in to comment.