Loading...
beta

# Introduction

OpenUPM is a service for hosting and building open-source UPM (Unity Package Manager) packages. OpenUPM provides a managed UPM registry and automatic build pipelines. The intention is to create a universal platform to discover, share, and distribute open-source UPM packages.

DISCLAIMER

OpenUPM is an open-source service, not an official service provided by Unity Technologies Inc.

# How It Works

# Scoped Registry and Command-Line Interface

Unity supports the scoped registry that allowing developers to setup 3rd-party registries to host custom packages. OpenUPM provides a public UPM registry at https://package.openupm.com, and a group of services and tools to support it.

The downside of the scoped registry is that you need to maintain the scope field of the manifest.json file to make it work. It's not a problem when working with a single namespace. But it's a challenge to work with a public registry with various namespaces. The dependency chain makes the issue worse. For example, the package-a depends on b, and b depends on c. It's a headache for a human to resolve all these dependencies to fill the scope field manually.

To remove the pain to install a 3rd-party package, we create a command-line tool called openupm-cli to maintain the manifest file. It can add, remove, and search packages in a terminal app, like Bash, Git-Bash, CMD, or PowerShell. When Unity detects the change of the manifest file, it will resolve it and install or remove packages for you.

+-----+   update   +---------------+   resolve   +-----+
| CLI | ---------> | manifest.json | <---------- | UPM |
+-----+            +---------------+             +-----+

Learn how to use the command-line tool at Getting Started with CLI, or visit OpenUPM-CLI Readme for references. For more information about the Unity editor integration, please follow #10.

If you are unfamiliar with the command-line, you can still use other installation options available on the package detail page.

# Automatic Build Pipelines

OpenUPM maintains a curated list of open-source UPM repositories hosting on GitHub. Our build pipelines watch the list regularly to detect versioned Git tags, bundle the asset, then publish it to the OpenUPM registry as a package. This continuous publishing approach is different from the traditional package registry that requires the package owner/maintainer to submit the new release. It enables any developer with a GitHub account to contribute new UPM packages to the platform. The role is called Package Hunter to help the community grow faster.

# Regions

For users who need to use OpenUPM services in China mainland, we suggest you switch to the China region, which provided the localized website and a mirror registry server at https://package.openupm.cn. The mirror registry synced with the global region every hour.

# Why Not ...?

# Unity Asset Store

Unity Asset Store is the official solution for publishing software, assets, and services, offering both paid and free content. However, assets are installed into the Asset folder. The old fashion way is good for managing assets, but it lacks dependency management for libraries. Unity has a progressive way to encourage its large content to convert to the UPM format. But it takes time.

Unlike the Unity asset store, OpenUPM is focusing on the open-source from day one, and our open-source community is growing fast. Both the Unity Asset Store and OpenUPM will continue growing and inspiring each other.

# Other 3rd-party Registries

The other 3rd-party registries like xcrew.dev, upm-packages.dev and unitynuget-registry offering valuable contents and usually maintained by a few passionate developers.

If repositories of these UPM packages are hosting on GitHub, then they could be contributed to the OpenUPM platform as well.

In fact that openupm-cli is designed to support any 3rd-party registries when specifying the registry option. i.e. search the unitynuget-registry.

$ openupm search memory --registry=https://unitynuget-registry.azurewebsites.net
┌───────────────────────────┬──────────────────────┬────────────┬──────────┐
│ Name                      │ Version              │ Author     │ Date     │
├───────────────────────────┼──────────────────────┼────────────┼──────────┤
│ org.nuget.system.memory   │ 4.5.3                │            │          │
└───────────────────────────┴──────────────────────┴────────────┴──────────┘

# UPM and Git Url

Since Unity 2019.3, developers can install the UPM package directly via Git URL. It's a quick way to install packages, however

  • lacking version control.
  • lacking support for the custom package with Git dependencies. Git URL is not the standard syntax of package dependency, hence you cannot resolve a custom package that depends on another custom package using Git URLs.

To overcome these barriers, UpmGitExtension is a 3rd-party plugin that providing the Git tag based version control and the dependency resolver for Git URLs. Along with awesome-upm - a curated list of UPM repositories, together they offering a similar experience with OpenUPM. While the OpenUPM platform may be a better package discovery service.

# The Power of Open Source

OpenUPM is an open-source service. It's impossible to make it work without these amazing projects and services.

Open-source software

Open-source friendly services