测试编辑器插件

应在发布之前对插件进行全面测试,以确保其运行正常。借助 Apps 脚本,您可以在特定的 Google 文档表格、表单或幻灯片文件上测试开发中的编辑器插件。这可用于:

  • 验证以独立脚本编写的插件在应用于工作表、文档、演示文稿或表单时是否能够按预期运行。
  • 验证插件安装流程是否按预期运行,特别是对于不同的初始授权生命周期状态已安装和/或已启用)。
  • 验证插件在对特定文档及其内容执行操作时是否能够按预期运行。
  • 测试并比较该插件的当前版本和之前版本。

创建测试部署

测试部署是插件和测试文档的组合。在您开发出脚本版本后,想要将其作为插件进行测试,请按以下步骤操作:

  1. 如果您还没有电子表格、文档、演示文稿或表单,请创建一个来测试插件。
  2. 打开包含插件的脚本项目。
  3. 点击部署 > 测试部署
  4. 选择类型旁边,点击“启用部署类型”,然后选择编辑器插件
  5. 点击创建新测试添加测试
  6. 选择一个代码版本或选择最新代码
  7. 在“Config”部分中,选择测试的初始授权状态
  8. 测试文档下,点击未选择任何文档。选择要用于测试插件的表格、文档、幻灯片或表单文件,然后点击插入
  9. 点击保存测试

所有已保存的测试部署都会显示在 Testdeployment 对话框中。这样,您稍后就可以重新访问相同的测试部署。

运行测试部署

如果您有一个或多个已保存的测试部署,则可以按照以下步骤运行其中一个测试部署:

  1. 打开包含插件的脚本项目。
  2. 点击部署 > 测试部署
  3. Saved Tests 下,选择要运行的已保存测试部署旁边的单选按钮,然后点击 Execute

测试文档会在新标签页中打开。该插件处于测试部署中指定的授权状态。您可以通过与插件的菜单和界面元素互动来验证插件是否按预期运行。

测试详情

以这种方式测试编辑器插件时,需要注意以下事项:

  • 测试时不支持可安装的触发器。依赖于可安装触发器的功能不可测试。
  • 运行设置为使用最新代码进行测试的测试部署时,您可以通过刷新测试文档查看已保存至插件脚本的更改。
  • 测试文档有一个网址,您可以与原始测试文档的编辑者共享该网址。这样,您就可以在测试和开发时更轻松地与他人协作。
  • 如果插件使用属性服务,则属性会保留,并会在下次运行测试部署时保持可用状态。
  • 此外,使用插件和测试文档的相同组合的任何测试部署都可以访问相同的媒体资源信息。例如,如果您创建了两个测试部署,则运行第一个测试部署时保存的属性在运行第二个测试时可用,反之亦然,但前提是这两个部署使用同一脚本和测试文档。
  • 如果运行测试部署,则您之前没有运行过该脚本,系统可能会提示您进行授权。请注意,在测试时向脚本授权,也会在测试之外向脚本授权。