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


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

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

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

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

Важно!

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

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

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

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

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

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

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

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

ОС Версия Office Браузер
любой Office в Интернете Браузер, в котором открыт Office.
(Но обратите внимание, что Office в Интернете не будет открываться в Internet Explorer.
При попытке сделать это откроется 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+, который предоставляется Internet Explorer 11. "+" в конце указывает, что надстройки Office используют дополнительные функции internet Explorer 11, которые не встроены в сам Trident.

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

Для бессрочных версий Office в Windows используемый браузер определяется версией Office, независимо от того, является ли лицензия розничной или корпоративной лицензией, а также установлена ли edge 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 2021 Всё равно Да1 WebView2 (Microsoft Edge2 на основе Chromium)
Office 2019 Розничная торговля Да1 WebView2 (Microsoft Edge2 на основе Chromium)
Office 2019 Розничная торговля Нет EdgeHTML (устаревшая версия Microsoft Edge)2, 3
Если Edge не установлен, используется Trident+ (Internet Explorer 11).
Office 2019 Корпоративная лицензия Всё равно Trident+ (Internet Explorer 11)
Office 2016 Розничная торговля Да1 WebView2 (Microsoft Edge2 на основе Chromium)
Office 2016 Розничная торговля Нет EdgeHTML (устаревшая версия Microsoft Edge)2, 3
Если Edge не установлен, используется Trident+ (Internet Explorer 11).
Office 2016 Корпоративная лицензия Всё равно Trident+ (Internet Explorer 11)

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

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

3 Если надстройка использует только манифест надстройки и включает <элемент 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.204241 Да2 WebView2 (Microsoft Edge3 на основе Chromium)
Окно 11,
Windows 10 версии  >= 1903
Microsoft 365 ver.  >= 16.0.13530.204241 Нет EdgeHTML (устаревшая версия Microsoft Edge)3, 4
Windows 11,
Windows 10 версии  >= 1903
Microsoft 365 ver.  >= 16.0.11629 И< 16.0.13530.204241 Всё равно EdgeHTML (устаревшая версия Microsoft Edge)3, 4
Windows 11,
Windows 10 версии  >= 1903
Microsoft 365 ver.  < 16.0.116291 Всё равно Trident+ (Internet Explorer 11)
Windows 10 версии  < 1903,
Windows 8.1
Microsoft 365 Нет Trident+ (Internet Explorer 11)
Windows 7 Microsoft 365 Всё равно Trident+ (Internet Explorer 11)

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

2 В версиях 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ей значение .

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

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

Работа с Trident+ (Internet Explorer 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 365, приведенные выше в этой статье, замените EdgeHTML (устаревшая версия Microsoft Edge) на WebView2 (на основе Microsoft Edge Chromium), где бы они ни появлялись.

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

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

Примечание.

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

См. также