创建和管理部署

Apps 脚本项目部署是一种脚本版本,可用作 Web 应用、插件或 API 可执行文件。通过创建和管理部署,您可以迭代代码、跟踪更改,并控制用户可以访问的确切代码版本。

部署有两种类型:

  • 头部署:始终同步到当前项目代码。
  • 版本控制的部署,此类部署与特定项目版本相关联。

Head 部署

头部署是当前的项目代码。创建 Apps 脚本项目时,系统会自动为该项目创建 Head 部署。

头部署始终与最近保存的代码保持同步。例如,如果您创建版本化部署,然后修改代码,则头部署会反映这些更改,而版本化部署将保持不变。

使用头部署来测试代码。请勿将头部署用于公共用途。

采用版本控制的部署

采用版本控制的部署,会提供特定版本的项目代码。这样,在您更改和改进代码时,用户就可以继续使用可正常运行的版本。

当应用发布给公众使用时,请始终使用版本化部署。您可以同时拥有多个活跃的版本控制部署。

重要提示:您无法转移采用版本控制的部署的所有权。如果您将脚本项目的所有权转移给某人,则该项目中现有版本化部署的所有者不会更改。如果管理员删除部署所有者的帐号,您可能会遇到其部署的脚本错误。

创建版本控制的部署

如需部署某个版本的 Google Workspace 插件、编辑器插件、Google Chat 应用或 API 可执行文件,您必须先将 Apps 脚本的 Google Cloud 项目关联从默认项目切换为标准项目

如需创建版本控制的部署,请按以下步骤操作:

  1. 打开 Apps 脚本项目。
  2. 在右上角,依次点击部署 > 新建部署
  3. 点击选择类型旁边的“启用部署类型”图标
  4. 选择要部署的部署类型。对于 Google Workspace 插件、编辑器插件和 Google Chat 应用,请选择插件
  5. 输入有关部署的信息,然后点击部署

查看采用版本控制的部署

如需查看 Apps 脚本项目的部署情况,请点击顶部的部署 > 管理部署

如需查看特定版本的代码,请参阅查看之前的版本

修改采用版本控制的部署

您可以修改版本控制的部署,以更改其说明或版本。如需修改部署,请按以下步骤操作:

  1. 打开 Apps 脚本项目。
  2. 点击部署 > 管理部署
  3. 选择要更改的活动部署,然后点击“修改”图标
  4. 进行更改,然后点击部署

    如果您要修改已归档的部署,则必须重新部署,然后按照上述步骤操作。

    如果要部署对项目代码的更改,请创建一个新版本并修改部署以使用该版本。使用该部署的任何用户都会自动使用新版本。

查找部署 ID

每个部署都会自动为其创建一个关联的字符串 ID。要查找此 ID,请按以下步骤操作:

  1. 打开 Apps 脚本项目。
  2. 在右上角,依次点击部署 > 管理部署
  3. 选择活跃部署以查找其 ID。

    部署 ID 仅显示在活跃部署上。

测试部署

测试部署的方式取决于您构建的应用类型。

Google Workspace 插件

如需测试 Google Workspace 插件部署,请参阅 测试 Google Workspace 插件

编辑器插件

如需测试编辑器插件部署,请参阅测试编辑器插件

Web 应用

如需测试 Web 应用部署,请参阅 测试 Web 应用部署

Google Chat 应用

如需测试 Chat 应用部署,您必须先为脚本 创建版本控制部署,才能访问其部署 ID。

获得部署 ID 后,请按照相应步骤启用 Google Chat API。在“配置”页面的“权限”下,仅指定您的电子邮件地址,以便您可以安装和测试您的应用。

API 可执行文件

如需测试 API 可执行部署,您必须先 创建版本化部署。创建部署后,请按以下步骤操作:

  1. 在 Apps 脚本项目的右上角,依次点击 Deploy > Test Deployments
  2. 在“选择类型”旁边,依次点击“启用部署类型” > API 可执行文件
  3. 复制并使用该网址来测试您的 API 可执行文件部署。

归档采用版本控制的部署

您无法删除版本化部署。不过,您可以将它们归档。

如需归档采用版本控制的部署,请执行以下操作:

  1. 打开 Apps 脚本项目。
  2. 点击部署 > 管理部署
  3. 选择要归档的部署,然后点击“Archive deployment”

重新部署已归档的部署

  1. 打开 Apps 脚本项目。
  2. 在右上角,依次点击部署 > 管理部署
  3. 在左侧的已归档下,选择要重新部署的部署,然后点击“修改”图标 > 部署