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

Статья
10/23/2024

Надстройки Office — это веб-приложения, которые отображаются с помощью iframes при запуске в Office в Интернете. В Office для классических и мобильных клиентов надстройки Office используют встроенный элемент управления браузера (также известный как веб-представление). Для запуска JavaScript надстройкам также требуется модуль JavaScript. Встроенный браузер и обработчик предоставляются браузером, установленным на компьютере пользователя. В этой статье "webview" относится к сочетанию элемента управления webview и обработчика JavaScript.

Выбор используемого веб-представления зависит от:

Операционная система компьютера.
Выполняется ли надстройка в Office в Интернете, в Office, скачанных из подписки На Microsoft 365, в Office 2016 или более поздней версии.
В бессрочных версиях Office в Windows, независимо от того, выполняется ли надстройка в варианте "розничная" или "корпоративная лицензия".

Важно!

Веб-представления из Интернет-Обозреватель и устаревшая версия Microsoft Edge по-прежнему используются в надстройках Office

Некоторые сочетания платформ и версий Office, включая корпоративные бессрочные версии через Office 2019, по-прежнему используют элементы управления webview, которые поставляются с Internet Обозреватель 11 (называется Trident) и устаревшая версия Microsoft Edge (называемые "EdgeHTML") для размещения надстроек, как описано в этой статье. Интернет-Обозреватель 11 был отключен в Windows 10 и Windows 11 в феврале 2023 года, и пользовательский интерфейс для его запуска был удален, но он по-прежнему установлен в этих операционных системах. Таким образом, Trident и другие функции из Интернета Обозреватель по-прежнему могут вызываться программными средствами Office.

Мы рекомендуем (но не требовать), чтобы вы продолжали поддерживать эти сочетания, по крайней мере в минимальном порядке, предоставляя пользователям надстройки корректное сообщение о сбое при запуске надстройки в одном из этих веб-представлений. Учитывайте следующие дополнительные моменты:

Office в Интернете больше не открывается в интернет-Обозреватель или устаревшая версия Microsoft Edge. Следовательно, AppSource не тестирует надстройки в Office в этих веб-браузерах.
AppSource по-прежнему тестирует сочетание версий платформы и классических приложений Office, использующих Trident или EdgeHTML. Однако он выдает предупреждение только в том случае, если надстройка не поддерживает эти веб-представления. Надстройка не отклоняется AppSource.
Средство Script Lab больше не поддерживает Trident.

Дополнительные сведения о поддержке Trident или EdgeHTML, включая настройку корректного сообщения об ошибке в надстройке, см. в разделе Поддержка старых веб-представлений Майкрософт и версий Office.

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

Платформы, отличные от Windows

Для этих платформ только платформа определяет используемый браузер.

ОС	Версия Office	Браузер
любой	Office в Интернете	Браузер, в котором открыт Office. (Но обратите внимание, что Office в Интернете не будет открываться в Интернете Обозреватель. При попытке сделать это откроется Office в Интернете в Edge.)
Mac	любой	Safari с WKWebView
iOS	любой	Safari с WKWebView
Android	любой	Chrome

Важно!

Условный доступ не поддерживается для надстроек Office в iOS или Android. Эти надстройки используют WKWebView на основе Safari или WebView на основе Android, а не элемент управления браузером на основе Edge.

Windows

Надстройка, запущенная в Windows, может использовать любой из трех различных веб-представлений:

WebView2, предоставляемый Microsoft Edge (на основе Chromium).
EdgeHTML, предоставляемый устаревшая версия Microsoft Edge.
Trident+, который предоставляется Интернетом Обозреватель 11. "+" в конце означает, что надстройки Office используют дополнительные функции из Интернета Обозреватель 11, которые не встроены в сам Trident.

Бессрочные версии Office в Windows

Для бессрочных версий Office в Windows используемый браузер определяется версией Office, независимо от того, является ли лицензия розничной или корпоративной, а также установлен ли Пограничный WebView2 (на основе Chromium). Версия Windows не имеет значения, но обратите внимание, что надстройки Office не поддерживаются в версиях до Windows 7 и Office 2021 и более поздних версиях не поддерживаются в версиях, предшествующих Windows 10.

Чтобы определить, является ли Office 2016 или Office 2019 розничным или корпоративным, используйте формат версии и номера сборки Office. (Для Office 2021 и более поздних версий различие между корпоративной лицензией и розничной торговлей не имеет значения.)

Розничная торговля. Как для Office 2016, так и для 2019 формат имеет формат , оканчивающийся YYMM (xxxxx.xxxxxx)двумя блоками из пяти цифр, например 2206 (Build 15330.20264).
С корпоративной лицензией:
- Для Office 2016 формат имеет формат , заканчивающийся 16.0.xxxx.xxxxxдвумя блоками из четырех цифр, например 16.0.5197.1000.
- Для Office 2019 формат имеет формат , заканчивающийся 1808 (xxxxx.xxxxxx)двумя блоками из пяти цифр, например 1808 (Build 10388.20027). Обратите внимание, что год и месяц всегда 1808являются .

Версия Office	Розничная и корпоративная лицензия	WebView2 установлен?	Браузер
Office 2024	Всё равно	Да¹	WebView2 (Microsoft Edge² Chromium)
Office 2021	Всё равно	Да¹	WebView2 (Microsoft Edge² Chromium)
Office 2019	Розничная торговля	Да¹	WebView2 (Microsoft Edge² Chromium)
Office 2019	Розничная торговля	Нет	EdgeHTML (устаревшая версия Microsoft Edge)^{2, 3} Если Edge не установлен, используется Trident+ (Интернет-Обозреватель 11).
Office 2019	Корпоративная лицензия	Всё равно	Trident+ (Интернет Обозреватель 11)
Office 2016	Розничная торговля	Да¹	WebView2 (Microsoft Edge² Chromium)
Office 2016	Розничная торговля	Нет	EdgeHTML (устаревшая версия Microsoft Edge)^{2, 3} Если Edge не установлен, используется Trident+ (Интернет-Обозреватель 11).
Office 2016	Корпоративная лицензия	Всё равно	Trident+ (Интернет Обозреватель 11)

¹ В версиях Windows до Windows 11 необходимо установить элемент управления WebView2, чтобы Office смог внедрить его. Он устанавливается с бессрочной Office 2021 или более поздней версии, но не устанавливается автоматически с Microsoft Edge. Если у вас есть более ранняя версия Office с бессрочной лицензией, используйте инструкции по установке элемента управления в Microsoft Edge WebView2 / Внедрение веб-содержимого ... с Microsoft Edge WebView2.

² При использовании EdgeHTML или WebView2 экранный диктор Windows (иногда называемый "средством чтения с экрана") считывает <title> тег на странице, открывающейся в области задач. В Trident+экранный диктор считывает строку заголовка области задач, которая происходит из имени надстройки, указанного в манифесте надстройки.

³ Если надстройка использует только манифест надстройки и включает <элемент Runtimes> в манифест или использует унифицированный манифест и содержит свойство extensions.runtimes.lifetime, то она не будет использовать EdgeHTML. Если условия для использования WebView2 выполнены, надстройка использует WebView2. В противном случае используется Trident+. Дополнительные сведения см. в разделах Среды выполнения и Настройка надстройки Outlook для активации на основе событий.

Версии Office для Windows по подписке на Microsoft 365

Для Office в Windows по подписке используемый браузер определяется операционной системой, версией Office и установленным ли элементом управления WebView2.

ОС	Версия Office	WebView2 установлен?	Браузер
Windows 11 Windows 10 Windows 8.1 Windows Server 2022 Windows Server 2019 Windows Server 2016	Microsoft 365 ver. >= 16.0.13530.20424¹	Да²	WebView2 (Microsoft Edge³ Chromium)
Окно 11 Windows 10 версии >= 1903	Microsoft 365 ver. >= 16.0.13530.20424¹	Нет	EdgeHTML (устаревшая версия Microsoft Edge)^{3, 4}
Windows 11 Windows 10 версии >= 1903	Microsoft 365 ver. >= 16.0.11629 И< 16.0.13530.20424¹	Всё равно	EdgeHTML (устаревшая версия Microsoft Edge)^{3, 4}
Windows 11 Windows 10 версии >= 1903	Microsoft 365 ver. < 16.0.11629¹	Всё равно	Trident+ (Интернет Обозреватель 11)
Windows 10 версии < 1903 Windows 8.1	Microsoft 365	Нет	Trident+ (Интернет Обозреватель 11)
Windows 7	Microsoft 365	Всё равно	Trident+ (Интернет Обозреватель 11)

¹ Дополнительные сведения см. на странице журнала обновлений и о том, как найти версию клиента Office и канал обновления .

² В версиях Windows до Windows 11 необходимо установить элемент управления WebView2, чтобы Office смог внедрить его. Он устанавливается вместе с Microsoft 365 версии 2101 или более поздней, но не устанавливается автоматически вместе с Microsoft Edge. Если у вас более ранняя версия Microsoft 365, используйте инструкции по установке элемента управления в Microsoft Edge WebView2 / Внедрение веб-содержимого ... с Microsoft Edge WebView2. В сборках Microsoft 365 до версии 16.0.14326.xxxxx необходимо также создать раздел реестра HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 и присвоить dword:00000001ей значение .

³ При использовании EdgeHTML или WebView2 экранный диктор Windows (иногда называемый "средством чтения с экрана") считывает <title> тег на странице, открывающейся в области задач. В Trident+экранный диктор считывает строку заголовка области задач, которая происходит из имени надстройки, указанного в манифесте надстройки.

⁴ Если надстройка использует только манифест надстройки и включает <элемент Runtimes> в манифест или использует унифицированный манифест и содержит свойство extensions.runtimes.lifetime, то она не будет использовать EdgeHTML. Если условия для использования WebView2 выполнены, надстройка использует WebView2. В противном случае используется Trident+. Дополнительные сведения см. в разделах Среды выполнения и Настройка надстройки Outlook для активации на основе событий.

Работа с Trident+ (Интернет Обозреватель 11)

Trident+ не поддерживает версии JavaScript, более поздние, чем ES5. Если у любого из пользователей надстройки есть платформы, использующие Trident+, то использовать синтаксис и функции ECMAScript 2015 или более поздней версии можно двумя способами.

Напишите код в ECMAScript 2015 (также называется ES6) или более поздней версии JavaScript или в TypeScript, а затем скомпилируйте код в ES5 JavaScript с помощью компилятора, например babel или tsc.
Напишите в ECMAScript 2015 или более поздней версии JavaScript, но также загрузите библиотеку polyfill , например core-js , которая позволяет IE выполнять код.

Дополнительные сведения об этих параметрах см. в статье Поддержка старых веб-представлений Майкрософт и версий Office.

Кроме того, Trident+ не поддерживает некоторые функции HTML5, такие как мультимедиа, запись и расположение. Дополнительные сведения см. в статье Определение веб-представления, в котором выполняется надстройка во время выполнения.

Устранение неполадок EdgeHTML и WebView2 (Microsoft Edge)

Работники службы не работают

Надстройки Office не поддерживают рабочие роли службы при использовании EdgeHTML. Они поддерживаются в WebView2.

Полоса прокрутки не отображается в области задач

По умолчанию полосы прокрутки в EdgeHTML и WebView2 скрыты до наведении указателя мыши. Чтобы полоса прокрутки отображалась постоянно, стиль CSS, применяемый к элементу <body> страниц в области задач, должен содержать свойство -ms-overflow-style со значением scrollbar.

При отладке с помощью Microsoft Edge DevTools надстройка аварийно завершает работу или перезагружается

Установка точек останова в средствах разработки Microsoft Edge для EdgeHTML может привести к тому, что Office будет думать, что надстройка зависла. В этом случае выполняется автоматическая перезагрузка надстройки. Чтобы избежать этого, добавьте следующий раздел реестра и значение на компьютере разработчика: [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000.

При попытке открытия надстройки появляется сообщение "ОШИБКА НАДСТРОЙКИ. Не удается открыть эту надстройку из localhost"

Одна из известных причин заключается в том, что EdgeHTML требует, чтобы localhost получил исключение замыкания на себя на себя на компьютере разработки. Следуйте инструкциям из статьи Не удается открыть надстройку из localhost.

Получение ошибок при попытке загрузить PDF-файл

Непосредственное скачивание больших двоичных объектов в виде PDF-файлов в надстройке не поддерживается в EdgeHTML или WebView2. Обходной путь — создать простое веб-приложение, которое скачивает BLOB-объекты в виде PDF-файлов. В надстройке Office.context.ui.openBrowserWindow(url) вызовите метод и передайте URL-адрес веб-приложения. Откроется веб-приложение в окне браузера за пределами Office.

Документы, защищенные WIP

Надстройки должны выполняться в документе с WIP (Windows Information Protection) и использовать WebView2 (Microsoft Edge Chromium)). Добавьте процесс WebView2 msedgewebview2.exeв список защищенных приложений в политике WIP предприятия. Администратор добавляет эту политику WIP через Intune со следующими значениями.

Имя: Webview2
Издатель: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Название продукта: MICROSOFT EDGE WEBVIEW2
Файл: MSEDGEWEBVIEW2.EXE
Минимальная версия: *
Максимальная версия: *

Если политика WIP не добавлена, надстройка по умолчанию использует старую среду выполнения. В разделах Бессрочные версии Office для Windows и версии Office для Windows с подпиской на Microsoft 365, приведенные выше в этой статье, замените EdgeHTML (устаревшая версия Microsoft Edge) на WebView2 (Microsoft Edge Chromium), где бы они ни отображались.

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

Откройте файл.
Перейдите на вкладку Файл на ленте.
Выберите Сведения.
В верхнем разделе страницы Сведений сразу под именем файла документ с поддержкой WIP будет иметь значок портфеля, за которым следует Управляемые по труду (...).

Примечание.

Поддержка WebView2 в документах с поддержкой WIP была добавлена со сборкой 16.0.16626.20132. Если вы используете более старую сборку, среда выполнения по умолчанию использует EdgeHTML (устаревшая версия Microsoft Edge) независимо от политики.

Поделиться через