Тестирование надстройки Office в Trident

  • Статья

Если вы планируете поддерживать более старые версии Windows и Office, надстройка должна работать во встраиваемом элементе управления браузера с именем Trident, который предоставляется Интернетом Обозреватель 11. Командная строка позволяет переключиться с более современного веб-представления, используемого надстройками, на Trident для этого тестирования. Сведения о том, какие версии Windows и Office используют элемент управления WebView Обозреватель 11, см. в статье Браузеры и элементы управления webview, используемые надстройками Office. В этой статье "webview" относится к сочетанию элемента управления webview и обработчика JavaScript.

Важно!

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

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

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

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

Если вы планируете поддерживать более старые версии Windows и Office, надстройка должна работать во встраиваемом элементе управления браузера с именем Trident, который предоставляется Интернетом Обозреватель 11. Командная строка позволяет переключиться с более современного веб-представления, используемого надстройками, на Trident для этого тестирования. Сведения о том, какие версии Windows и Office используют элемент управления WebView Обозреватель 11, см. в статье Браузеры и элементы управления webview, используемые надстройками Office.

Важно!

Trident не поддерживает версии JavaScript, более поздние, чем ES5. Если вы хотите использовать синтаксис и функции ECMAScript 2015 или более поздней версии, необходимо использовать транспилер или polyfill или и то, и другое. Дополнительные сведения об этих параметрах см. в статье Поддержка старых веб-представлений Майкрософт и версий Office.

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

Примечание.

  • Office в Интернете не удается открыть в Интернете Обозреватель 11, поэтому вы не можете (и не нужно) тестировать надстройку на Office в Интернете с Обозреватель Интернета.

  • Для работы веб-надстроек Office необходимо отключить конфигурацию усиленной безопасности Internet Explorer (ESC). Если вы используете компьютер Windows Server в качестве клиента при разработке надстроек, обратите внимание, что esc включена по умолчанию в Windows Server.

Переключение на веб-представление Trident

Совет

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

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

  • Проект был разработан с помощью Visual Studio и IIS. Это не Node.js.
  • Вы хотите быть абсолютно надежным в тестировании.
  • Вы не можете использовать канал бета-версии для Microsoft 365 на компьютере разработки.
  • Вы разрабатываете на Компьютере Mac.
  • Если по какой-либо причине программа командной строки не работает.

Переключение с помощью командной строки

Если проект основан на Node.js (т. е. не разработан с помощью Visual Studio и IIS), вы можете заставить Office в Windows использовать элемент управления webview EdgeHTML, предоставляемый устаревшей версией Edge, или элемент управления Trident webview, предоставляемый Интернетом Обозреватель для запуска надстроек, даже если у вас есть сочетание версий Windows и Office, в которых обычно используется более новое веб-представление. Дополнительные сведения о том, какие браузеры и веб-представления используются различными сочетаниями версий Windows и Office, см. в разделе Браузеры и элементы управления webview, используемые надстройками Office.

Примечание.

Средство, используемое для принудительного изменения в webview, поддерживается только в канале подписки на бета-версию Microsoft 365. Присоединитесь к программе предварительной оценки Microsoft 365 и выберите параметр Канал бета-версии , чтобы получить доступ к сборкам Office Beta. См. также сведения об Office: какую версию Office я использую?.

Строго, это переключатель webview этого средства (см. шаг 2), который требует канала бета-версии. Средство имеет другие переключатели, для которых нет этого требования.

  1. Если проект не был создан с помощью генератора Yeoman для надстроек Office , необходимо установить средство office-addin-dev-settings. Выполните следующую команду в командной строке.

    npm install office-addin-dev-settings --save-dev

    Важно!

    Средство office-addin-dev-settings не поддерживается на Mac.

  2. Укажите веб-представление, которое office будет использовать с помощью следующей команды, в командной строке в корневой части проекта. Замените <path-to-manifest> относительным путем, который является только именем файла манифеста, если он находится в корне проекта. Замените <webview> на или edge-legacyie . Обратите внимание, что параметры называются в честь браузеров, в которых были созданы веб-представления. Параметр ie означает "Trident", edge-legacy а параметр означает "EdgeHTML".

    npx office-addin-dev-settings webview <path-to-manifest> <webview>

    Ниже приведен пример.

    npx office-addin-dev-settings webview manifest.xml ie

    В командной строке должно появиться сообщение о том, что для типа webview теперь задано значение IE (или Устаревшая версия Edge).

  3. По завершении настройте Office на возобновление с помощью веб-представления по умолчанию для сочетания версий Windows и Office с помощью следующей команды.

    npx office-addin-dev-settings webview <path-to-manifest> default

Установите версию Office, которая использует интернет-Обозреватель

Используйте следующую процедуру, чтобы установить версию Office (скачаемую из подписки На Microsoft 365), которая использует устаревшая версия Microsoft Edge webview (EdgeHTML) для запуска надстроек, или версию, которая использует интернет-Обозреватель (Trident).

  1. В любом приложении Office откройте вкладку Файл на ленте, а затем выберите Учетная запись Office или Учетная запись. Нажмите кнопку Сведения об имени узла (например, О Word).

  2. В открывшемся диалоговом окне найдите полный номер сборки xx.x.xxxxx и создайте его копию.

  3. Скачайте средство развертывания Office.

  4. Запустите скачанный файл, чтобы извлечь средство. Вам будет предложено выбрать, где установить средство.

  5. В папке, в которой установлено средство (где setup.exe находится файл), создайте текстовый файл с именем config.xml и добавьте следующее содержимое.

    <Configuration>
  <Add OfficeClientEdition="64" Channel="SemiAnnual" Version="16.0.xxxxx.xxxxx">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

  6. Измените Version значение.

    • Чтобы установить версию, которая использует EdgeHTML, измените ее на 16.0.11929.20946.
    • Чтобы установить версию, которая использует Trident, измените ее на 16.0.10730.20348.

  7. При необходимости измените значение OfficeClientEdition"32" на , чтобы установить 32-разрядную версию Office, и при необходимости измените Language ID значение для установки Office на другом языке.

  8. Откройте командную строку от имени администратора.

  9. Перейдите в папку с файлами setup.exe и config.xml .

  10. Выполните следующую команду.

    setup.exe /configure config.xml

    Эта команда устанавливает Office. Установка может занять несколько минут.

  11. Очистите кэш Office.

Важно!

После установки убедитесь, что вы отключили автоматическое обновление Office, чтобы office не обновлялся до версии, которая не использует webview, с которой вы хотите работать, прежде чем завершить его использование. Это может произойти в течение нескольких минут после установки. Выполните указанные ниже действия.

  1. Запустите любое приложение Office и откройте новый документ.
  2. Откройте вкладку Файл на ленте и выберите Учетная запись Office или Учетная запись.
  3. В столбце Сведения о продукте выберите Параметры обновления, а затем — Отключить Обновления. Если этот параметр недоступен, office уже настроен на автоматическое обновление.

Когда вы закончите использовать старую версию Office, переустановите новую версию, изменив config.xml файл и изменив Version номер сборки, скопированный ранее. Затем повторите setup.exe /configure config.xml команду в командной строке администратора. При необходимости повторно включите автоматическое обновление.

См. также