应在发布之前对插件进行全面测试,以确保插件按预期运行。借助 Apps 脚本,您可以在具体的 Google 文档表格、表单或幻灯片文件中测试开发中的编辑器插件。这可用于:
- 验证以独立脚本编写的插件在应用于工作表、文档、演示文稿或表单时能否按预期运行。
- 验证插件安装流程是否按预期运行,尤其是对于不同的初始授权生命周期状态(已安装和/或已启用)。
- 验证插件在对特定文档及其内容执行操作时能否按预期运行。
- 测试并对比插件的当前版本和旧版本。
创建测试部署
测试部署是插件和测试文档的组合。开发脚本版本并希望将其作为插件进行测试后,请按以下步骤操作:
- 如果您还没有电子表格、文档、演示文稿或表单,请先创建一个,以测试该插件。
- 打开包含该插件的脚本项目。
- 依次点击部署 > 测试部署。
- 点击选择类型旁边的“启用部署类型”图标 ,然后选择编辑器插件。
- 点击创建新测试或添加测试。
- 选择代码版本或选择最新代码。
- 在 Config 部分,选择测试的初始授权状态。
- 在测试文档下,点击未选择任何文档。选择您要用于测试插件的表格、文档、幻灯片或表单文件,然后点击插入。
- 点击保存测试。
所有已保存的测试部署都将显示在 Test Deployment 对话框中。这样,您以后便可以重新访问同一测试部署。
运行测试部署
如果您有一个或多个已保存的测试部署,可以按照以下步骤运行其中一个:
- 打开包含该插件的脚本项目。
- 依次点击部署 > 测试部署。
- 在 Saved Tests 下,选择要运行的已保存的测试部署旁边的单选按钮,然后点击 Execute。
测试文档会在新标签页中打开。该插件处于测试部署中指定的授权状态。您可以通过与插件的菜单和界面元素交互来验证插件是否按预期运行。
测试详情
以这种方式测试编辑器插件时,需要注意以下几点:
- 测试时不支持可安装的触发器。依赖于安装式触发器的功能不可测试。
- 运行设置为使用最新代码进行测试的测试部署时,您可以刷新测试文档,查看保存到插件脚本的更改。
- 测试文档具有一个网址,您可以将该网址分享给原始测试文档的编辑者。这样,您可以在测试和开发时更轻松地与他人协作。
- 如果您的插件使用属性服务,则属性将保留,并在下次运行测试部署时保持可用。
- 此外,任何使用插件和测试文档组合的测试部署均可访问相同的属性信息。例如,如果您创建了两个测试部署,则在运行第一个测试时保存的属性可用,在运行第二个测试时可以使用的属性,但前提是部署使用相同的脚本和测试文档。
- 如果您运行测试部署,如果您之前未运行过该脚本,那么系统可能会提示您进行授权。请注意,在测试期间向脚本授权也会在测试之外授权脚本。