Обзор отладки надстроек Office

  • Статья

Отладка надстроек Office — это по сути то же самое, что и отладка любого веб-приложения. Однако один набор инструментов не подходит для всех разработчиков надстроек. Это связано с тем, что надстройки разрабатываются в разных операционных системах и могут запускаться на нескольких платформах. В этой статье вы найдете подробное руководство по отладке для вашей среды разработки.

Совет

Эта статья посвящена отладке в узком смысле слова — заданию точек останова и пошаговому выполнению кода. Чтобы получить рекомендации по тестированию и устранению неполадок, начните со статей Тестирование надстроек Office и Устранение ошибок при разработке надстроек Office.

Примечание.

Хотя необходимо протестировать надстройку на всех платформах, которые она будет поддерживать, отладка для среды, отличной от компьютера разработчика, требуется крайне редко. По этой причине термины "компьютер разработки" и "среда разработки" используются в этой статье применительно к среде, в которой выполняется отладка. Если проблема с кодом возникает только на платформе, отличной от платформы компьютера разработки, и для ее решения необходимо задать точки останова или выполнить код пошагово, то среда, в которой выполняется отладка, не является средой разработки в прямом смысле слова.

Серверный код или клиентский код?

Отладка серверного кода надстройки Office — это то же самое, что и отладка серверной части любого веб-приложения. Ознакомьтесь с инструкциями по отладке для вашей интегрированной среды разработки или других инструментов. Ниже приведены примеры отладки для самых популярных инструментов.

В остальной части этой статьи рассматривается только отладка клиентского JavaScript (который можно транскомпилировать из TypeScript).

Особые случаи

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

Общие рекомендации

При поиске рекомендаций по отладке клиентского кода первая переменная обозначает операционную систему компьютера разработки.

Отладка в Windows

Ниже приведены общие рекомендации по отладке в Windows. Отладка в Windows зависит от вашей интегрированной среды разработки.

Сведения об используемой среде выполнения см. в статье Браузеры и элементы управления webview, используемые надстройками Office и средами выполнения в надстройках Office.

Совет

В последних версиях Office одним из способов определить элемент управления webview, который использует Office, является меню личных данных в любой надстройке, где он доступен. (Меню личных данных не поддерживается в Outlook.) Откройте меню и выберите Сведения для безопасности. В диалоговом окне Сведения для системы безопасности в Windows среда выполнения сообщает о Microsoft Edge, устаревшей версии Microsoft Edge или Internet Explorer. Среда выполнения не включена в диалоговое окно в более ранних версиях Office.

Отладка на компьютере Mac

Используйте Веб-инспектор Safari. Инструкции приведены в статье Отладка надстроек Office на компьютере Mac.

Отладка в Linux

Не существует классической версии Office для Linux, поэтому вам потребуется загрузить неопубликованную надстройку в Office в Интернете для тестирования и отладки. Руководство по отладке см. в статье Отладка надстроек в Office в Интернете.

Примечание.

Мы не рекомендуем разрабатывать надстройки Office на компьютере с Linux, за исключением особых случаев, когда вы можете быть уверены, что все пользователи надстройки будут использовать ее через Office в Интернете с компьютера с Linux.

Отладка надстроек в промежуточной или рабочей среде

Чтобы отладить надстройку, которая уже находится в промежуточной или рабочей среде, подключите отладчик из пользовательского интерфейса надстройки. Инструкции см. в статье Подключение отладчика из области задач.

См. также