Тестирование и отладка дополнений Apps Script для Google Workspace

Когда вы публикуете надстройку, пользователи могут установить ее через главное приложение или через Google Workspace Marketplace . Прежде чем публиковать, протестируйте надстройки, которые вы разрабатываете, в рамках хост-приложений, которые они расширяют.

На этой странице описано, как установить надстройку, находящуюся в стадии разработки (называемую неопубликованной надстройкой или надстройкой разработчика ), для тестирования или личного использования. Вы также можете отлаживать надстройки с помощью отладчика и точек останова Apps Script IDE.

Предварительные условия

  • У вас должен быть доступ редактора к проекту сценария дополнения.
  • Чтобы другие люди в вашей организации могли протестировать надстройку, предоставьте им доступ редактора к проекту сценария. Подробную информацию о предоставлении доступа см. в разделе «Сотрудничество с другими разработчиками» .

Установить неопубликованное дополнение

Вы можете установить неопубликованные надстройки из диалогового окна «Развертывания » Apps Script.

Выполните следующие действия, чтобы установить неопубликованное дополнение Google Workspace для тестирования:

  1. Откройте проект скрипта в редакторе Apps Script.
  2. Щелкните Развертывание > Тестовые развертывания .
  3. Нажмите Установить .
  4. Внизу нажмите Готово .

Вы можете позволить другим пользователям протестировать надстройку, поделившись проектом Apps Script со своей учетной записью (требуется доступ для редактирования). Затем предложите пользователям выполнить описанные выше шаги.

После установки дополнение сразу же становится доступным в хост-приложениях, которые оно расширяет. Возможно, вам придется обновить вкладку ведущего приложения, прежде чем появится надстройка. Вы также должны авторизовать дополнение перед его использованием.

Удаление неопубликованного дополнения

Чтобы удалить неопубликованное развертывание надстройки, выполните следующие действия:

  1. Откройте проект скрипта в редакторе Apps Script.
  2. Щелкните Развертывание > Тестовые развертывания .
  3. Нажмите Удалить .
  4. Внизу нажмите Готово .

Эти действия немедленно удаляют развертывание, и надстройка больше не отображается ни в одном ведущем приложении. Вы можете переустановить развертывание в любое время, повторив процедуру установки .

Тестирование лучших практик

При тестировании надстройки Google Workspace обязательно следуйте рекомендациям по разработке надстроек. Кроме того, обязательно сделайте следующее:

  1. Навигация по тестовой карте тщательно работает во всех хост-приложениях, которые расширяет надстройка. Убедитесь, что надстройка работает правильно при переходе пользователя от контекста к контексту, а также между неконтекстными и контекстными карточками.

  2. Используйте примеры тестовых данных , чтобы оценить поведение вашего дополнения.

  3. Если ваша надстройка подключается к стороннему API или другой службе, убедитесь, что к службе доступен доступ и она ведет себя должным образом. Убедитесь, что ваше дополнение правильно обрабатывает данные авторизации и входа в систему .

  4. Убедитесь, что любые ошибки обрабатываются корректно. Используйте карточки ошибок там, где это необходимо.

  5. Обратите внимание на производительность дополнения. Если вы вносите изменения в код и надстройка начинает тормозить, возможно, вам придется удалить или переработать эту функцию.