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