Apps Script 项目部署是指可用作 Web 应用、插件或 API 可执行文件的脚本版本。通过创建和管理部署,您可以迭代代码、跟踪更改,以及控制用户可以访问的确切代码版本。
部署有两种类型:
- Head 部署,始终与当前项目代码同步。
- 版本化部署,与特定项目版本相关联。
主要部署
主部署是当前的项目代码。创建 Apps Script 项目时,您会自动为该项目创建一个主部署。
主部署始终与最近保存的代码保持同步。例如,如果您创建了版本化部署,然后修改了代码,主部署会反映这些更改,而版本化部署会保持不变。
使用 Head 部署来测试代码。请勿将 Head 部署用于公开用途。
有版本编号的部署
版本化部署可提供项目代码的特定版本。这样,用户就可以继续使用正常运行的版本,而您可以对代码进行更改和改进。
发布供公众使用的应用时,请始终使用版本化部署。您可以同时有多个处于有效状态的版本化部署。
重要提示:您无法转移版本型部署的所有权。如果您将脚本项目的所有权转移给其他用户,则项目中现有版本型部署的所有者不会发生变化。如果管理员删除了部署所有者的账号,您可能会遇到其部署的脚本错误。
创建版本化部署
如需部署 Google Workspace 插件、编辑器插件、Google Chat 应用或 API 可执行文件的版本,您必须先将 Apps Script 的 Google Cloud 项目关联从默认项目切换为标准项目。
如需创建版本型部署,请按以下步骤操作:
- 打开 Apps 脚本项目。
- 在右上角,依次点击部署 > 新建部署。
- 点击“选择类型”旁边的“启用部署类型”图标 。
- 选择要部署的部署类型。对于 Google Workspace 插件、编辑器插件和 Google Chat 应用,请选择插件。
输入有关部署的信息,然后点击部署。
查看版本化部署
如需查看 Apps 脚本项目的部署,请点击顶部的部署 > 管理部署。
如需查看特定版本的代码,请参阅查看旧版。
修改版本化部署
您可以修改版本型部署,以更改其说明或版本。如需修改部署,请按以下步骤操作:
- 打开 Apps 脚本项目。
- 依次点击 Deploy > Manage deployments。
- 选择要更改的有效部署,然后点击“修改”图标 。
进行更改,然后点击部署。
如果您想修改已归档的部署,则必须重新部署该部署,然后按照上述步骤操作。
如需部署对项目代码所做的更改,请创建新版本并修改部署以使用该版本。使用该部署的所有用户都会自动使用新版本。
查找部署 ID
系统会自动为每个部署创建一个关联的字符串 ID。如需查找此 ID,请按以下步骤操作:
- 打开 Apps 脚本项目。
- 在右上角,依次点击部署 > 管理部署。
选择一项有效的部署以查找其 ID。
部署 ID 仅显示在有效的部署中。
测试部署
部署测试方式取决于您构建的应用类型。
Google Workspace 插件
如需测试 Google Workspace 插件部署,请参阅 测试 Google Workspace 插件。
编辑器插件
如需测试编辑器插件部署,请参阅测试编辑器插件。
Web 应用
如需测试 Web 应用部署,请参阅 测试 Web 应用部署。
Google Chat 应用
如需测试 Chat 应用部署,您必须先 为脚本创建版本化部署,以便访问其部署 ID。
获取部署 ID 后,请在 Chat API 配置中指定该 ID,然后按照相应步骤测试互动功能。
可执行的 API
如需测试 API 可执行文件部署,您必须先 创建版本化部署。创建部署后,请按以下步骤操作:
- 在 Apps Script 项目的右上角,依次点击部署 > 测试部署。
- 在“选择类型”旁边,依次点击“启用部署类型”图标 > API 可执行文件。
- 复制并使用该网址测试 API 可执行文件部署。
归档版本化部署
您无法删除版本化部署。您可以将其归档。
如需归档版本化部署,请执行以下操作:
- 打开 Apps 脚本项目。
- 依次点击 Deploy > Manage deployments。
- 选择要归档的部署,然后点击“归档部署”图标 。
重新部署已归档的部署
- 打开 Apps 脚本项目。
- 在右上角,依次点击部署 > 管理部署。
- 在左侧的已归档下,选择要重新部署的部署,然后依次点击“修改”图标 > 部署。