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