Browsers e controlos webview utilizados pelos Suplementos do Office

Artigo
07/17/2024

Os Suplementos do Office são aplicações Web que são apresentadas através de iframes quando são executados no Office na Web. No Office para clientes de ambiente de trabalho e dispositivos móveis, os Suplementos do Office utilizam um controlo de browser incorporado (também conhecido como webview). Os suplementos também precisam de um mecanismo JavaScript para executar o JavaScript. Tanto o browser incorporado como o motor são fornecidos por um browser instalado no computador do utilizador. Neste artigo, "webview" refere-se à combinação de um controlo webview e de um motor JavaScript.

A vista Web utilizada depende de:

O sistema operativo do computador.
Quer o suplemento esteja a ser executado no Office na Web, no Office transferido a partir de uma subscrição do Microsoft 365 ou no Office 2016 perpétuo ou posterior.
Nas versões perpétuas do Office no Windows, se o suplemento está em execução na variação "revenda" ou "licenciamento em volume".

Importante

Os Webviews do Internet Explorer e do Microsoft Edge Legado ainda são utilizados nos Suplementos do Office

Algumas combinações de plataformas e versões do Office, incluindo versões perpétuas licenciadas em volume através do Office 2019, ainda utilizam os controlos webview fornecidos com o Internet Explorer 11 (denominado "Trident") e o Microsoft Edge Legacy (denominado "EdgeHTML") para alojar suplementos, conforme explicado neste artigo. O Internet Explorer 11 foi desativado no Windows 10 e Windows 11 em fevereiro de 2023 e a IU para o iniciar foi removida; mas ainda está instalado nesses sistemas operativos. Assim, o Trident e outras funcionalidades do Internet Explorer ainda podem ser chamados através de programação pelo Office.

Recomendamos (mas não exija) que continue a suportar estas combinações, pelo menos de forma mínima, ao fornecer aos utilizadores do seu suplemento uma mensagem de falha correta quando o suplemento for iniciado numa destas webviews. Tenha estes pontos adicionais em mente:

O Office na Web já não é aberto no Internet Explorer ou no Microsoft Edge Legado. Consequentemente, o AppSource não testa suplementos no Office nestes browsers.
O AppSource ainda testa combinações de plataformas e versões de ambiente de trabalho do Office que utilizam Trident ou EdgeHTML. No entanto, apenas emite um aviso quando o suplemento não suporta estas webviews; o suplemento não é rejeitado pelo AppSource.
A ferramenta Script Lab já não suporta Trident.

Para obter mais informações sobre como suportar o Trident ou o EdgeHTML, incluindo a configuração de uma mensagem de falha correta no seu suplemento, consulte Suportar webviews da Microsoft mais antigos e versões do Office.

As secções seguintes especificam que browser é utilizado para as várias plataformas e sistemas operativos.

Plataformas não Windows

Para estas plataformas, só a plataforma determina o browser que é utilizado.

SO	Versão do Office	Navegador
qualquer	Office na Web	O navegador no qual o Office está aberto. (No entanto, tenha em atenção que o Office na Web não será aberto no Internet Explorer. Tentar fazê-lo abre o Office na Web no Edge.)
Mac	qualquer	Safari com WKWebView
iOS	qualquer	Safari com WKWebView
Android	qualquer	Chrome

Importante

O Acesso Condicional não é suportado para Suplementos do Office em iOS ou Android. Estes suplementos utilizam o WKWebView baseado no Safari ou o WebView baseado no Android e não um controlo de browser baseado no Edge.

Windows

Um suplemento em execução no Windows pode utilizar qualquer uma das três webviews diferentes:

WebView2, que é fornecido pelo Microsoft Edge (baseado em Chromium).
EdgeHTML, que é fornecido pelo Microsoft Edge Legado.
Trident+, que é fornecido pelo Internet Explorer 11. O "+" no final indica que os Suplementos do Office utilizam funcionalidades adicionais do Internet Explorer 11 que não estão incorporadas no próprio Trident.

Versões perpétuas do Office no Windows

Para versões perpétuas do Office no Windows, o browser utilizado é determinado pela versão do Office, se a licença é de revenda ou de licenciamento em volume e se o Edge WebView2 (baseado em Chromium) está instalado. A versão do Windows não importa, mas tenha em atenção que os Suplementos Web do Office não são suportados em versões anteriores ao Windows 7 e o Office 2021 não é suportado em versões anteriores ao Windows 10.

Para determinar se o Office 2016 ou o Office 2019 é revenda ou licenciado em volume, utilize o formato da versão do Office e do número de compilação. (Para o Office 2021, a distinção entre licenciamento em volume e revenda não importa.)

Revenda: para o Office 2016 e 2019, o formato é YYMM (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 2206 (Build 15330.20264).
Licenciado em volume:
- Para o Office 2016, o formato é 16.0.xxxx.xxxxx, terminando com dois blocos de quatro dígitos; por exemplo, 16.0.5197.1000.
- Para o Office 2019, o formato é 1808 (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 1808 (Build 10388.20027). Tenha em atenção que o ano e o mês são sempre 1808.

Versão do Office	Revenda vs. Licenciamento em volume	WebView2 instalado?	Navegador
Office 2021	Não importa	Sim¹	WebView2 (baseado no Microsoft Edge² Chromium)
Office 2019	Varejo	Sim¹	WebView2 (baseado no Microsoft Edge² Chromium)
Office 2019	Varejo	Não	EdgeHTML (Microsoft Edge Legado)^{2, 3} Se o Edge não estiver instalado, será utilizado o Trident+ (Internet Explorer 11).
Office 2019	Licenciado em volume	Não importa	Trident+ (Internet Explorer 11)
Office 2016	Varejo	Sim¹	WebView2 (baseado no Microsoft Edge² Chromium)
Office 2016	Varejo	Não	EdgeHTML (Microsoft Edge Legado)^{2, 3} Se o Edge não estiver instalado, será utilizado o Trident+ (Internet Explorer 11).
Office 2016	Licenciado em volume	Não importa	Trident+ (Internet Explorer 11)

¹ Nas versões do Windows anteriores ao Windows 11, o controlo WebView2 tem de ser instalado para que o Office o possa incorporar. Está instalado com o Office 2021 perpétuo ou posterior; mas não é instalado automaticamente com o Microsoft Edge. Se tiver uma versão anterior do Office perpétuo, utilize as instruções para instalar o controlo no Microsoft Edge WebView2/Incorporar conteúdo Web... com o Microsoft Edge WebView2.

² Quando utiliza o EdgeHTML ou o WebView2, o Narrador do Windows (por vezes denominado "leitor de ecrã") lê a <title> etiqueta na página que é aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que provém do nome do suplemento especificado no manifesto do suplemento.

³ Se o suplemento utilizar um manifesto XML e incluir o <elemento Runtimes> no manifesto ou utilizar o manifesto unificado e incluir uma propriedade "extensions.runtimes.lifetime", não utilizará EdgeHTML. Se as condições para utilizar o WebView2 forem cumpridas, o suplemento utiliza o WebView2. Caso contrário, utiliza Trident+. Para obter mais informações, veja Runtimes e Configure your Outlook add-in for event-based activation (Configurar o suplemento do Outlook para ativação baseada em eventos).

Versões de subscrição do Microsoft 365 do Office no Windows

Para a subscrição do Office no Windows, o browser utilizado é determinado pelo sistema operativo, a versão do Office e se o controlo WebView2 está instalado.

SO	Versão do Office	WebView2 instalado?	Navegador
Windows 11, Windows 10, Windows 8.1 Windows Server 2022, Windows Server 2019, Windows Server 2016	Microsoft 365 ver. >= 16.0.13530.20424¹	Sim²	WebView2 (baseado no Microsoft Edge³ Chromium)
Janela 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. >= 16.0.13530.20424¹	Não	EdgeHTML (Microsoft Edge Legado)^{3, 4}
Windows 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. >= 16.0.11629 E< 16.0.13530.20424¹	Não importa	EdgeHTML (Microsoft Edge Legado)^{3, 4}
Windows 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. < 16.0.11629¹	Não importa	Trident+ (Internet Explorer 11)
Versão do Windows 10 < 1903, Windows 8.1	Microsoft 365	Não	Trident+ (Internet Explorer 11)
Windows 7	Microsoft 365	Não importa	Trident+ (Internet Explorer 11)

¹ Consulte a página do histórico de atualizações e como encontrar a versão do cliente do Office e o canal de atualização para obter mais detalhes.

² Nas versões do Windows anteriores ao Windows 11, o controlo WebView2 tem de ser instalado para que o Office o possa incorporar. Está instalado com o Microsoft 365, Versão 2101 ou posterior, mas não é instalado automaticamente com o Microsoft Edge. Se tiver uma versão anterior do Microsoft 365, utilize as instruções para instalar o controlo no Microsoft Edge WebView2/Incorporar conteúdo Web... com o Microsoft Edge WebView2. Nas versões anteriores à versão 16.0.14326.xxxxx do Microsoft 365, também tem de criar a chave de registo HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 e definir o respetivo valor como dword:00000001.

³ Quando utiliza o EdgeHTML ou o WebView2, o Narrador do Windows (por vezes denominado "leitor de ecrã") lê a <title> etiqueta na página que é aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que provém do nome do suplemento especificado no manifesto do suplemento.

⁴ Se o suplemento utilizar um manifesto XML e incluir o <elemento Runtimes> no manifesto ou utilizar o manifesto unificado e incluir uma propriedade "extensions.runtimes.lifetime", não utilizará EdgeHTML. Se as condições para utilizar o WebView2 forem cumpridas, o suplemento utiliza o WebView2. Caso contrário, utiliza Trident+. Para obter mais informações, veja Runtimes e Configure your Outlook add-in for event-based activation (Configurar o suplemento do Outlook para ativação baseada em eventos).

Trabalhar com Trident+ (Internet Explorer 11)

O Trident+ não suporta versões JavaScript posteriores ao ES5. Se algum dos utilizadores do seu suplemento tiver plataformas que utilizem Trident+, para utilizar a sintaxe e as funcionalidades do ECMAScript 2015 ou posterior, tem duas opções.

Escreva o código no ECMAScript 2015 (também denominado ES6) ou javaScript posterior, ou em TypeScript e, em seguida, compile o seu código para ES5 JavaScript com um compilador, como babel ou tsc.
Escreva no ECMAScript 2015 ou javaScript posterior, mas também carregue uma biblioteca de polifill , como core-js , que permite ao IE executar o seu código.

Para obter mais informações sobre estas opções, consulte Suportar webviews mais antigos da Microsoft e versões do Office.

Além disso, o Trident+ não suporta algumas funcionalidades HTML5, como multimédia, gravação e localização. Para saber mais, consulte Determinar o webview em que o suplemento está a ser executado no runtime.

Resolver problemas do EdgeHTML e WebView2 (Microsoft Edge)

Os Trabalhadores de Serviços não estão a funcionar

Os Suplementos do Office não suportam Funções de Trabalho de Serviço quando o EdgeHTML é utilizado. São suportados com o WebView2.

A barra de deslocamento não aparece no painel de tarefas

Por predefinição, as barras de deslocamento no EdgeHTML e webView2 estão ocultas até pairar o cursor do rato. Para garantir que a barra de rolagem fique sempre visível, o estilo de CSS que se aplica ao elemento <body> das páginas no painel de tarefas deve incluir a propriedade (-ms- reoverflow-style) e deve ser definida como scrollbar.

Ao depurar com o Microsoft Edge DevTools, o suplemento falha ou recarrega

Definir pontos de interrupção nas DevTools do Microsoft Edge para EdgeHTML pode fazer com que o Office pense que o suplemento está bloqueado. Ele recarrega automaticamente o suplemento quando isso acontece. Para evitar isso, adicione a seguinte chave do registro e valor ao computador de desenvolvimento [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000:.

Quando o suplemento tentar abrir, o erro “ADD-IN ERROR não é possível abrir este suplemento a partir do localhost" acontece

Uma causa conhecida é que o EdgeHTML requer que seja dada ao localhost uma isenção de loopback no computador de desenvolvimento. Siga as instruções em não é possível abrir o suplemento do localhost.

Obter erros ao tentar transferir um ficheiro PDF

A transferência direta de blobs como ficheiros PDF num suplemento não é suportada com o EdgeHTML ou WebView2. A solução é criar uma aplicação Web simples que transfira blobs como ficheiros PDF. No seu suplemento, chame o Office.context.ui.openBrowserWindow(url) método e transmita o URL da aplicação Web. Esta ação irá abrir a aplicação Web numa janela do browser fora do Office.

Documentos protegidos pelo WIP

Existe um passo adicional necessário para que os Suplementos sejam executados num documento com o WIP (Windows Information Protection) e utilizem o WebView2 (baseado no Microsoft Edge Chromium). Adicione o processo WebView2, msedgewebview2.exe, à lista de aplicações protegidas na política WIP da sua empresa. Um administrador adiciona esta política wip através do Intune com os seguintes valores.

Nome: Webview2
Publisher: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Nome do Produto: WEBVIEW2 DO MICROSOFT EDGE
Ficheiro: MSEDGEWEBVIEW2.EXE
Versão Mínima: *
Versão Máxima: *

Se a política wip não tiver sido adicionada, o suplemento é predefinido para um runtime mais antigo. Nas secções Versões perpétuas do Office no Windows e versões de subscrição do Microsoft 365 do Office no Windows anteriormente neste artigo, substitua EdgeHTML (Microsoft Edge Legacy) por WebView2 (baseado no Microsoft Edge Chromium) onde quer que seja apresentado.

Para determinar se um documento está protegido por WIP, siga estes passos.

Abra o ficheiro.
Selecione o separador Ficheiro no friso.
Selecione Informações.
Na secção superior da página Informações , imediatamente abaixo do nome do ficheiro, um documento compatível com WIP terá um ícone de pasta seguido de Gerido por Trabalho (...).

Observação

O suporte para WebView2 em documentos preparados para WIP foi adicionado com a versão 16.0.16626.20132. Se estiver numa compilação mais antiga, o runtime é predefinido para EdgeHTML (Microsoft Edge Legado), independentemente da política.

Partilhar via