Дополнения должны быть тщательно протестированы перед публикацией, чтобы убедиться, что они ведут себя так, как задумано. Apps Script позволяет тестировать надстройки редактора в процессе разработки на определенных файлах Google Docs Sheets, Forms или Slides. Это можно использовать для:
- Убедитесь, что надстройка, написанная в автономном скрипте, работает должным образом при применении к листу, документу, презентации или форме.
- Убедитесь, что процесс установки надстройки работает должным образом, особенно для различных исходных состояний жизненного цикла авторизации ( установлено, включено или и то, и другое ).
- Убедитесь, что надстройка работает должным образом при воздействии на конкретный документ и его содержимое.
- Протестируйте и сравните текущую и предыдущую версии дополнения.
Создайте тестовое развертывание
Тестовое развертывание — это комбинация надстройки и тестового документа. Если у вас есть разработанная версия скрипта и вы хотите протестировать ее в качестве надстройки, выполните следующие действия:
- Если у вас его еще нет, создайте электронную таблицу, документ, презентацию или форму, чтобы протестировать надстройку.
- Откройте проект скрипта, содержащий вашу надстройку.
- Щелкните Развернуть > Тестовые развертывания .
- Рядом с пунктом «Выбор типа» нажмите «Включить типов развертывания» и выберите «Надстройка редактора» .
- Щелкните Создать новый тест или Добавить тест .
- Выберите версию кода или выберите «Последний код» .
- В разделе Config выберите начальное состояние авторизации для теста.
- В разделе «Тестовый документ» щелкните «Документ не выбран» . Выберите файл «Листы», «Документы», «Презентации» или «Формы», который вы хотите использовать для тестирования надстройки, и нажмите «Вставить» .
- Щелкните Сохранить тест .
Все сохраненные тестовые развертывания отображаются в диалоговом окне Тестовые развертывания . Это позволяет вам вернуться к тому же тестовому развертыванию позже.
Запустите тестовое развертывание
Если у вас есть одно или несколько сохраненных тестовых развертываний, вы можете запустить одно из них, выполнив следующие действия:
- Откройте проект скрипта, содержащий вашу надстройку.
- Щелкните Развернуть > Тестовые развертывания .
- В разделе «Сохраненные тесты» выберите переключатель рядом с сохраненным тестовым развертыванием, которое вы хотите запустить, и нажмите «Выполнить» .
Тестовый документ откроется в новой вкладке. Надстройка находится в состоянии авторизации , указанном в тестовом развертывании. Вы можете убедиться, что надстройка работает должным образом, взаимодействуя с ее меню и элементами пользовательского интерфейса.
Детали тестирования
При тестировании надстроек редактора таким образом следует помнить о нескольких вещах:
- Устанавливаемые триггеры не поддерживаются при тестировании. Функциональность, которая зависит от устанавливаемых триггеров, не тестируется.
- При запуске тестового развертывания, настроенного для тестирования с последним кодом, вы можете увидеть изменения, сохраненные в сценарии надстройки, обновив тестовый документ.
- У тестового документа есть URL-адрес, которым вы можете поделиться с редакторами исходного тестового документа. Таким образом, вам будет легче сотрудничать с другими при тестировании и разработке.
- Если ваша надстройка использует службу свойств , свойства сохраняются и остаются доступными при следующем запуске тестового развертывания.
- Кроме того, любое тестовое развертывание, в котором используется одна и та же комбинация надстройки и тестового документа, имеет доступ к одной и той же информации о свойствах. Например, если вы создаете два тестовых развертывания, свойства, сохраненные при запуске первого, будут доступны при запуске второго и наоборот, но только в том случае, если развертывания используют один и тот же сценарий и тестовый документ.
- Если вы запускаете тестовое развертывание, вам может быть предложено авторизоваться, если вы еще не запускали сценарий. Имейте в виду, что авторизация скрипта во время тестирования также авторизует скрипт вне тестирования.