Тестирование и отладка надстроек Office на не локальном сервере

  • Статья

Когда вы завершили разработку и тестирование на локальном узле и хотите запустить и протестировать надстройку с не локального сервера или облачной учетной записи, вы можете использовать средство office-addin-debugging для любого проекта надстройки на основе Node.js. (Средство не поддерживается в проектах, созданных с помощью Visual Studio.)

Примечание.

Если вы работаете на компьютере с Windows, у вас может быть другой вариант для нелокного тестирования. См . раздел Загрузка неопубликованных надстроек Office для тестирования из сетевого ресурса.

Проекты, созданные с помощью набора средств Teams или генератора Office Yeoman (Yo Office)

Если проект был создан с помощью набора средств Teams или генератора Office Yeoman (Yo Office), средство отладки office-addin-debugging уже установлено, а файл package.json содержит start скрипты и stop , которые вызывают это средство. Чтобы использовать его для тестирования, не являющегося локальным, обновите доменную часть URL-адресов в манифесте, чтобы она указывала на промежуточный сервер (или CDN при необходимости). Затем запустите npm run start в командной строке (или терминале Visual Studio Code), чтобы загрузить неопубликованную надстройку для тестирования и отладки.

Важно!

Средство отладки office-addin-debugging регистрирует надстройку в реестре Windows или в специальной папке на компьютере Mac. Для надстройки Outlook она также регистрирует надстройку в Exchange. Чтобы избежать незначительных ошибок при разработке, всегда завершайте сеанс тестирования, выполняя npm run stop , чтобы убедиться, что эти регистрации удалены и серверный процесс полностью остановлен. При закрытии сервера вручную, окна командной строки (или терминала), Visual Studio Code или приложения Office эти регистрации не удаляются.

Другие проекты

Если проект не был создан с помощью набора средств Teams или Yo Office, запустите средство с npx в корне проекта. Вызовите его с помощью команды start , за которой следует относительный путь к манифесту. Ниже приведен пример.

npx office-addin-debugging start manifest.json

Эта команда загружает неопубликованную надстройку для тестирования и отладки. Средство также работает с манифестом только надстройки.

Существует множество вариантов для start команды. Дополнительные сведения см. в разделе README для средства office-addin-debugging.

Важно!

Средство отладки office-addin-debugging регистрирует надстройку в реестре Windows или в специальной папке на компьютере Mac. Для надстройки Outlook она также регистрирует надстройку в Exchange. Чтобы избежать незначительных ошибок при разработке, всегда завершайте сеанс тестирования, выполняя npx office-addin-debugging stop , чтобы убедиться, что эти регистрации удалены и серверный процесс полностью остановлен. При закрытии сервера вручную, окна командной строки (или терминала), Visual Studio Code или приложения Office эти регистрации не удаляются. Если вы использовали --prod параметр с командой start , используйте тот же параметр с командой stop .