加载中...
beta

# 介绍

OpenUPM是一项用于托管和构建开源UPM软件包的服务。UPM是“Unity软件包管理器”的缩写。OpenUPM由两部分组成:可托管的UPM软件包仓库和与之配合的自动构建管线。我们的初衷是创建一个Unity的平台,来发现、共享和分发开源的UPM软件包,以及围绕此构建一个开源社区。

免责声明

OpenUPM是一项开源服务,而不是Unity Technologies优美缔软件提供的一项服务。

# 基本原理

# Scoped Registry和命令行工具

Unity支持scoped registry(带作用域的软件包仓库)。该功能允许开发人员架设自己的软件包仓库来托管自制软件。 OpenUPM提供了一个开放的UPM软件包仓库(地址:https://package.openupm.cn),以及相关的工具。

尽管scoped registry让复用软件变得便捷,但它的缺点是需要用户手动去维护manifest.json文件的scope字段。对使用单一命名空间的企业内部软件来说,这很简单。但是当你试图使用来自第三方的各色命名的软件包来说,如何便捷的维护该字段确实是一个挑战。而软件包通常含有包依赖链,使这个问题变得更糟。例如,软件包package-a依赖于b,而b依赖于c。那么这三个软件包都应该被添加到scope字段。这太过繁琐。

为了解决这个问题,OpenUPM开发了命令行工具OpenUPM-CLI用于帮助维护manifest.json文件。可以在常见的命令行终端中添加,删除,搜索和查看软件包。例如,使用Bash,Git-Bash,CMD或PowerShell。当Unity检测到manifest.json文件的更改时,它将解析该文件并安装或删除相应的软件包。

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

请访问OpenUPM-CLI快速入门学习命令行的基本用法,或访问OpenUPM-CLI自述文件来了解更多信息。更友好的Unity编辑器集成,请参考工单#10

如果你不习惯使用命令行工具,仍然可以使用软件包页面提供的其他安装方式。

# 自动构建管线

所有托管在OpenUPM上的开源UPM软件包,都会记录在GitHub的一个软件包列表文件中。构建管线定期查看该列表。当检测到含有版本信息的Git标签后,它会处理并发布新的软件包版本。如果你熟悉NPM的工作方式,会发现我们的做法与其不同。传统的软件包仓库要求软件包作者手动地提交并发布版本。而OpenUPM的构建管线自动化了这一过程。并使得任意拥有GitHub帐户的开发人员,都可以向OpenUPM平台贡献新的软件包。这一角色称之为软件包猎手。热心的软件包猎手正是OpenUPM平台发展的重要助力。

# 关于OpenUPM中文网

OpenUPM分为国际区中国区。OpenUPM中文网提供了文档的本地化和在中国大陆托管的软件仓库映像。该仓库映像每小时同国际区同步一次。

如果你对OpenUPM中文网的发展有任何的建议和诉求,请随时联系hello@openupm.com

# 为什么不选择...?

# Unity资源商店

Unity资源商店 是Unity官方推荐的发布软件、资源和服务的解决方案。它同时提供付费和免费内容。从Unity 2019.3开始,开发人员可以直接从软件包管理器窗口下载到已安装的资源。但是,通过Unity资源商店购买的资源,依旧被安装到Asset文件夹中。这是上一代的管理资源的方法,缺少依赖关系管理,也不能方便的移除软件包。使其在管理软件类资源时稍显不足。Unity会逐步推出让资源商店完全支持UPM软件包的解决方案,但这将是一个渐进的过程。OpenUPM也愿意为该进程助力。

与Unity资源商店不同,从一开始OpenUPM就专注于开源的UPM软件包。开源是软件开发领域一股无法忽视的力量。开源的Unity社区目前还不是很强大,但是发展很快,最终将在Unity开发中发挥重要作用。我们认为在很长一段时间里Unity资源商店和OpenUPM都将同步发展,彼此促进。就如同商业软件和开源软件一样,协同发展。

# 其他第三方软件仓库

其他第三方软件仓库,例如xcrew.devupm-packages.devunitynuget-registry同样提供了有价值的内容。通常由一些热情的开发人员进行维护。

如果这些UPM软件包是托管在GitHub上的,那么也可以直接贡献给OpenUPM平台。

事实上,当指定registry选项后,openupm-cli可以支持任意的第三方软件包仓库。例如,我们可以尝试在unitynuget-registry软件包仓库中搜索memory关键词。

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

# UPM和Git托管

从Unity 2019.3开始,开发人员可以直接通过Git地址安装UPM软件包。这是安装软件包的另一种快速方法。但是Git托管有两个明显的缺点:

  • 缺乏版本控制。
  • 缺少对Git依赖的支持。Git地址不是软件包依赖关系的标准语法,因此你无法使用Git地址来解析并安装依赖包。

为了克服这些障碍,UpmGitExtension是一个第三方插件,提供基于Git标签的版本控制和依赖解析。连同awesome-upm,一个更松散的精选UPM软件列表,它们组合在一起,提供了类似于OpenUPM的体验。我们认为这很棒。当然,OpenUPM网站的发现服务也许更方便些。

# 开源的力量

OpenUPM是一项开源服务。多亏了下面这些令人赞叹的开源项目和对开源项目友好的商业服务的支持:

开源软件

对开源项目友好的商业服务