Общие сведения о тестировании, отладке и вариантах развертывания надстроек Office
В этом модуле вы изучите порядок тестирования и отладки, а также варианты развертывания надстроек Office. По завершении этого модуля вы будете знать, как загрузить вашу неопубликованную надстройку, чтобы протестировать ее, как использовать Visual Studio, Visual Studio Code или средства разработки в браузере для отладки надстройки, а также различные варианты развертывания.
Выберите оптимальный вариант развертывания для вашей надстройки Office.
При разработке надстройки Office и ее подготовке к предоставлению пользователям необходимо выбрать лучший вариант развертывания. В приведенной ниже таблице перечислены факторы, которые следует учитывать при этом.
| Фактор | Примеры |
|---|---|
| Этап жизненного цикла надстройки | локальное тестирование разработчиком, готовность к широкому применению |
| Поддержка взаимодействия и функций надстройки | надстройка области задач, контентная надстройка, команды надстроек |
| Целевые приложения Office | Excel, Outlook |
| Целевые платформы | Windows, macOS |
| Область базы пользователей | ваша организация, широкая аудитория |
Варианты развертывания
Вам доступно несколько вариантов развертывания надстройки. В приведенной ниже таблице указаны все варианты и рекомендации по их применению.
| Вариант | Описание | Оптимальное применение |
|---|---|---|
| Установка неопубликованного приложения | Установка надстройки в локальной среде. | Создание и тестирование надстройки разработчиком |
| Централизованное развертывание | Распространение надстройки среди пользователей с помощью Центра администрирования Microsoft 365. | Надстройка готова к использованию в Microsoft 365 или гибридной среде организации |
| Каталог SharePoint | Распространение надстройки среди пользователей через SharePoint. | Надстройка области задач или контентная надстройка, готовая к использованию в вашей организации, которая использует локальную среду; Excel, Word или PowerPoint являются целевыми, но macOS не является целевой платформой |
| AppSource | Выпуск надстройки для широкой аудитории. | Надстройка готова к использованию широкой аудиторией |
| Сервер Exchange Server | Распространение надстройки среди пользователей с помощью Exchange. | Надстройка Outlook готова к использованию в организации, в среде которой не используется служба удостоверений Microsoft Entra |
| Сетевая папка | Предоставление надстройки сетевым пользователям с помощью общей папки. | Для разработки и применения надстройки используется Windows |
Общие сведения о тестировании и отладке надстроек Office
На различных этапах жизненного цикла надстройки необходимо проверять ее функции и исправлять ошибки. Для тестирования и отладки надстройки доступно несколько вариантов.
Загрузка неопубликованной надстройки
Вы можете локально установить (загрузить) надстройку для тестирования и отладки в Windows, macOS и в веб-браузере. Вы также можете загрузить неопубликованную надстройку Excel или Word на iPad. Используйте Node.js, службы IIS или другой подходящий вариант размещения надстройки в Интернете на компьютере для разработки.
Создав проект с помощью генератора Yeoman для надстроек Office, вы можете выполнить команду npm run start в командной строке, чтобы запустить и загрузить неопубликованную надстройку в Excel для Windows, или команду npm run start:web, чтобы запустить ее в веб-браузере. Однако вам придется вручную загрузить неопубликованную надстройку в Excel в браузере.
Если проект создается с помощью Visual Studio (VS), вы можете запустить его в режиме отладки VS, и он автоматически загрузит неопубликованную надстройку в Excel для Windows.
Отладка надстройки
Отлаживать надстройку можно следующими способами:
- с помощью веб-браузера со встроенными средствами разработчика;
- с помощью Visual Studio, при условии что вы подготовили надстройку с использованием этой среды IDE;
- с помощью Visual Studio Code (только для проектов пользовательских функций);
- Ведение журнала среды выполнения в Windows и macOS
Если вам нужно отлаживать надстройку на определенной платформе, есть и другие инструменты, которые вам в этом помогут. Далее в этом разделе описано несколько вариантов для Windows и macOS.
Windows
В Windows 10 используемый инструмент зависит от того, где работает надстройка: в Microsoft Edge или в Internet Explorer. Надстройка считается работающей в Internet Explorer 11, если она не отвечает приведенным ниже критериям работы в Microsoft Edge.
- Windows 10 (версия 1903 или выше)
- Подписка на Microsoft 365 (сборка 16.0.11629 или более поздней версии)
В случае Microsoft Edge необходимо установить и использовать Microsoft Edge DevTools. В случае Internet Explorer откройте средства разработчика F12 для соответствующей версии Office:
- 32-разрядная версия Office: C:\Windows\System32\F12\IEChooser.exe
- 64-разрядная версия Office: C:\Windows\SysWOW64\F12\IEChooser.exe
В Office 2016 и более поздних версиях для отладки надстроек в области задач можно подключить отладчик. Если в меню персонализации доступна команда Подключить отладчик, как показано на приведенном ниже изображении, то поддерживается Visual Studio 2015 с пакетом обновления 3 или выше. Это средство поддерживает только отладку JavaScript.
Меню персонализации с элементом Подключить отладчик
Если меню персонализации отсутствует или вы уже используете Visual Studio (VS), то вы можете использовать команду Подключить к процессу в VS для отладки надстройки в Microsoft Edge или Internet Explorer по мере необходимости.
macOS
Для загруженных неопубликованных надстроек области задач и контентных надстроек можно использовать Safari Web Inspector на macOS High Sierra и Office версии 16.9.1 (сборка 18012504) или выше. Поддерживаемые приложения Office:
- Excel
- Outlook
- PowerPoint
- Word
Проверка манифеста
Вы можете проверить манифест надстройки одним из указанных ниже способов.
- Генератор Yeoman для надстроек Office
- Команда office-addin-manifest validate
- libxml
Тестирование необходимых платформ и клиентов Office
Протестируйте свою надстройку в тех версиях Office и на тех платформах, где с ней будете работать вы или ваши пользователи.
Использование в личных целях или в рамках организации
Если вашу надстройку будете использовать только вы или ваша организация, протестируйте ее в тех версиях Office и на тех платформах, где она будет применяться. Например, если вы разрабатываете надстройку Word для своей организации, где ваши коллеги обычно работают в Microsoft Edge и Word 2019 для Windows, протестируйте надстройку в этом браузере и соответствующей версии Word.
Публичное использование
Если ваша надстройка будет доступна широкой аудитории в AppSource, следует ознакомиться с политиками проверки AppSource, чтобы гарантировать, что проверка и утверждение надстройки пройдут без проблем. Вот некоторые основные требования к проверке:
- Браузеры: Internet Explorer 11 и более поздних версий, Microsoft Edge, Chrome, Firefox и Safari (macOS)
- Office: все приложения, указанные в разделе
Hostsфайла конфигурации с манифестом надстройки - Операционные системы: Windows, macOS и iPad. Если надстройка Outlook поддерживает мобильные устройства, включает iOS и Android.
Политика проверки AppSource версии 4.12 включает подробные описания требований к поддержке клиентов и платформ.
Сводка
В этом модуле вы изучили порядок тестирования и отладки, а также варианты развертывания надстроек Office. Теперь вы должны знать, как загрузить вашу неопубликованную надстройку, чтобы протестировать ее, как использовать Visual Studio, Visual Studio Code или средства разработки в браузере для отладки надстройки, а также различные варианты развертывания.