测试编辑器插件

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

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

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

创建测试部署

测试部署是插件和测试文档的组合。开发了脚本版本并希望将其作为插件进行测试后,请按以下步骤操作:

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

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

运行测试部署

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

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

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

测试详情

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

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