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