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