测试编辑器插件

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

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

创建测试部署

测试部署由插件和测试文档构成。开发脚本版本后,如果您想将其作为插件进行测试,请按以下步骤操作:

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

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

运行测试部署

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

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

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

测试详情

以这种方式测试编辑器插件时,应注意以下几点:

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