# UGS 包版本指南

> Keep your UGS packages up-to-date with recommended minimum versions for each service.

为了利用最新的 UGS 功能和更新，Unity 建议将所有使用 UGS 服务 Beta 版的项目升级到最新发布的版本。

## 要使用的包版本##package-versions-to-use

请将项目安装的包版本与以下每个服务的最低建议版本进行比较。建议不要使用任何版本号低于下列最低版本的包，这些包应进行更新。

| 服务名称          | 包名称                               | 最低版本  |
| ------------- | --------------------------------- | ----- |
| 分析            | com.unity.services.analytics      | 4.0.1 |
| 身份验证          | com.unity.services.authentication | 2.0.0 |
| Cloud Code    | com.unity.services.cloudcode      | 2.0.0 |
| Cloud Save    | com.unity.services.cloudsave      | 2.0.0 |
| Economy       | com.unity.services.economy        | 2.0.2 |
| Lobby         | com.unity.services.lobby          | 1.0.1 |
| Relay         | com.unity.services.relay          | 1.0.2 |
| Remote Config | com.unity.remote-config           | 3.0.0 |

## 在您的项目中安装建议的服务包##install-recommended-service-packages-in-your-project

上面列出的服务与任何 Unity 编辑器 2020.3 或更高版本均兼容。但是，根据具体的编辑器版本，可能无法从 [Package Manager（包管理器）](https://docs.unity3d.com/2021.2/Documentation/Manual/upm-ui.html)窗口安装服务包。下表显示了为确保每项服务完全兼容而需要使用的编辑器版本：

| 编辑器年份                | 支持 UGS 发布包的版本                                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------------------------ |
| 2019.4 (LTS)         | 2019.4.40f1 或更高版本**注意**：对于 Unity 2019，只有 Analytics 和 Authentication 具有 Verified（已验证）版本。其他 UGS 服务尚未针对此版本进行测试。 |
| 2020.3 (LTS)         | 2020.3.36f1 或更高版本**注意**：所有 UGS 包均已针对此版本进行验证。                                                                 |
| 2021.3 (LTS)         | 2021.3.5f1 或更高版本                                                                                             |
| 2022.1 (Tech Stream) | 2022.1.4f1 或更高版本                                                                                             |
| 2022.2 (Tech Stream) | 2022.2.0a17 或更高版本                                                                                            |

**注意**：如果您在编辑器版本 2021.3、2022.1 或 2022.2 的 Package Manager（包管理器）窗口中没有看到支持的 Analytics 和 Remote Config 包版本，请参阅下面的升级情形。

## 升级情形##upgrade-scenarios

### 编辑器版本支持 UGS 发布包的情形##my-editor-version-supports-ugs-release-packages

在这种情形中，您可以通过 Unity 编辑器的 [Package Manager（包管理器）](https://docs.unity3d.com/Manual/upm-ui-install.html)注册表下载并安装所有包。要使用 Package Manager（包管理器）下载并安装包，请执行以下操作：

1. 在 Unity 编辑器中，打开 **Window（窗口）**> **Package Manager（包管理器）**。
2. 在 Package Manager（包管理器）中，选择 \*\*Unity Registry（Unity 注册表）\*\*列表视图。
3. 搜索包名称，或在注册表列表中找到包。
4. 选择包，然后单击 **Install（安装）**。

您还可以在搜索栏中输入“services（服务）”，随即将返回除 Remote Config 之外的所有服务的结果。

在编辑器 2022.1 或更高版本中，您可以在 Package Manager（包管理器）的 \*\*Services（服务）\*\*选项卡中找到所有服务。

### 编辑器版本不支持 UGS 发布包的情形##my-editor-version-does-not-support-ugs-release-packages

对于编辑器 2020.3 或更高版本，在项目中安装这些包的最简单方法是使用以下代码[直接将这些包添加到项目清单中](https://docs.unity3d.com/Manual/upm-manifestPrj.html)：

```plaintext
{
    "dependencies": {
        "com.unity.services.analytics": "4.0.1",
        "com.unity.services.authentication": "2.0.0",
        "com.unity.services.cloudcode": "2.0.0",
        "com.unity.services.cloudsave": "2.0.0",
        "com.unity.services.economy": "2.0.2",
        "com.unity.services.lobby": "1.0.1",
        "com.unity.services.relay": "1.0.2",
        "com.unity.remote-config": "3.0.0"
    }
}
```

**注意：** Analytics 和 Authentication 是与编辑器版本 2019.4 兼容的服务。其他 UGS 服务尚未针对此特定版本进行验证。

### 我想升级 Analytics 和 Remote Config，但在 Package Manager（包管理器）中看不到它们##i-want-to-upgrade-analytics-and-remote-config-but-cant-see-them-in-the-package-manager

您可以将以下代码添加到包清单中：

```plaintext
"com.unity.services.analytics": "4.0.1",
"com.unity.remote-config": "3.0.0"
```

或者，您可以使用以下版本[按名称手动安装这些包](https://docs.unity3d.com/Manual/upm-ui-quick.html)：

| Name                         | 版本    |
| ---------------------------- | ----- |
| com.unity.services.analytics | 4.0.1 |
| com.unity.remote-config      | 3.0.0 |