Unity Gaming Services(Unity 游戏服务)CLI

您可以使用 Unity Gaming Services(Unity 游戏服务)CLI 来处理 Cloud Code 模块。借助 CLI 可以从命令行创建、部署和管理 Cloud Code 模块。

先决条件

要深入了解 CLI,请按照 Unity Gaming Services(Unity 游戏服务)CLI 入门指南中的步骤操作。

为了按照该指南操作,必须首先完成以下操作:

  1. 安装 UGS CLI

  2. 按如下方式配置 Project ID 和环境:
    ugs config set project-id <your-project-id>
    ugs config set environment-name <your-environment-name>

  3. 为服务帐户配置 Cloud Code环境管理所需的角色。请参阅接受身份验证

使用 CLI

请参阅 Cloud Code 命令行文档,了解所有命令和选项的完整参考。

注意:ugs cloud-code modules 命令也可按照 ugs cc m 的形式使用。

**注意:**CLI 目前不支持模块的自定义标签,会将它们忽略。如果要将自定义键/值对附加到模块,请使用 Cloud Code API

创建模块

要使用示例模块在本地创建解决方案,可以运行 new-file 命令:

ugs cloud-code modules new-file <module-name> <module-directory>

此命令使用示例模块创建新解决方案。

您可以按原样使用解决方案,也可以对其进行修改以满足您的需求。

**注意:**有存储限制。请查看 Cloud Code 限制

部署模块

Deploy 命令可以将 Cloud Code 模块部署到远程环境。此命令支持 .ccm 格式的预编译模块和 C# 解决方案,这些模块和解决方案在部署前会自动编译和压缩。

要一次部署多个模块,请提供多个文件路径或一个包含多个文件的目录:

ugs deploy <path-to-ccm-file> <path-to-sln-file>
ugs deploy <path-to-directory>

部署预编译的模块

要部署预编译的模块,请提供 .ccm 文件的路径作为命令的参数:

ugs deploy <path-to-ccm-file>

要了解如何将模块压缩为 .ccm 文件,请参阅打包代码

部署 C# 解决方案

要部署 C# 解决方案,请提供 .sln 文件的路径作为命令的参数。

在部署解决方案前会自动编译和压缩解决方案。结果将保存到本地临时文件夹(例如 <temp-folder>/<solution-name>)。

运行以下命令来部署解决方案:

ugs deploy <path-to-sln-file>

重要:目前,部署解决方案时,仅支持每个解决方案一个主项目。主项目是包含发布配置文件的项目。不能部署包含多个模块的解决方案。此外,请确保此解决方案的所有项目都位于文件夹层级视图中的解决方案文件下。要了解如何确定解决方案的结构,请参阅模块结构

环境同步

您可以将所有模块从一个环境移动并部署到另一个环境。

运行以下命令以生成当前环境中所有模块的存档:

ugs cloud-code modules export <out-dir> <file-name>

然后,可以通过运行以下命令导入模块并部署到另一个环境:

ugs cloud-code modules import <in-dir> <file-name> --environment-name <environment-name>

**注意:**默认情况下,Import 不会覆盖您的环境。如果要在导入之前删除现有模块,请使用 --reconcile 标志。

获取模块

要获取已部署的单个模块的相关信息,请运行以下命令:

ugs cloud-code modules get <module-name>

模块名称是包含在 .ccm 存档中的 .NET 类库的名称。还可以通过运行以下命令列出当前部署到 Cloud Code 的所有模块:

ugs cloud-code modules list

删除模块

要删除模块,请运行以下命令:

ugs cloud-code modules delete <module-name>