Partilhar via

Desinstalar suplementos em desenvolvimento

  • Artigo

Os suplementos removidos de forma incompleta podem deixar artefactos no computador, como botões personalizados do friso ou entradas de registo, durante o desenvolvimento. Neste artigo, chamamos a estes "suplementos fantasma".

Os suplementos do Outlook também podem adicionar estes artefactos a outros computadores quando inicia sessão no Outlook com o mesmo ID que utilizou para desenvolver o suplemento.

Importante

Quando inicia sessão no Outlook, este é transferido a partir do Exchange e de sideloads, todos os manifestos de suplementos do Outlook associados ao seu ID, incluindo suplementos que está a desenvolver num computador diferente com o mesmo ID. Por exemplo, todos os botões do friso personalizados definidos no manifesto serão apresentados para o suplemento.

Se os URLs no manifesto apontarem para um servidor não localhost e esse servidor estiver em execução e acessível para o computador que não está em desenvolvimento, o Outlook coloca em cache os ficheiros do suplemento no sistema de ficheiros local e o suplemento é normalmente executado normalmente no computador. Caso contrário, o suplemento não funciona, mas aparecem partes visíveis do mesmo, como botões do friso personalizados. Têm as etiquetas definidas no manifesto. Os ícones de botão do suplemento também são apresentados se alguma vez tiverem sido colocados em cache localmente no computador que não está em desenvolvimento e a cache nunca tiver sido limpa. Os ficheiros de ícone não são armazenados com o Exchange, por isso, se nunca tiverem sido colocados em cache no computador que não está em desenvolvimento (ou se a cache tiver sido limpa), os botões têm ícones predefinidos.

Até que o registo do suplemento seja removido do Exchange, o suplemento continuará a aparecer. Consulte Remover um suplemento fantasma para obter informações sobre como remover o registo no Exchange.

Este artigo fornece algumas orientações para minimizar a possibilidade destes problemas e para resolve-los se ocorrerem.

Evitar os problemas

Quando um suplemento é sideloaded, ocorrem várias coisas:

  • Um servidor Web, normalmente no localhost, é iniciado para servir os ficheiros do suplemento (como os ficheiros HTML, CSS e JavaScript).
  • Estes mesmos ficheiros são colocados em cache no seu computador de desenvolvimento.
  • O suplemento está registado no computador de desenvolvimento. O registo é feito com entradas de Registo num computador Windows ou com determinados ficheiros guardados no sistema de ficheiros num Mac.
  • A maioria das ferramentas para sideload de suplementos abre automaticamente a aplicação do Office que o suplemento visa. As ferramentas também povoam a aplicação com botões do friso personalizados ou itens de menu de contexto definidos no manifesto do suplemento.
  • Para um suplemento do Outlook, o manifesto do suplemento é registado no serviço Exchange.

Utilizar a instalação de desinstalação da sua ferramenta

Para impedir suplementos fantasma, termine todos os testes, depuração e sideloading sessão com a opção de desinstalação (também denominada não necessária) fornecida pela ferramenta que utilizou para iniciar a sessão. Ao fazê-lo, reverte os efeitos do sideload, conforme indicado anteriormente neste artigo.

A lista seguinte identifica, para cada ferramenta, como desinstalar, mas não descreve detalhadamente os procedimentos ou a sintaxe. Certifique-se de que utiliza as ligações para obter instruções completas.

Observação

Algumas destas ferramentas não fecham a aplicação do Office que foi aberta automaticamente. Nesse caso, feche a aplicação manualmente imediatamente após terminar a sessão.

  • Gerador Yeoman para Suplementos do Office (Yo Office): utilize o npm stop script na mesma linha de comandos onde iniciou a sessão com npm start. Para obter mais informações, consulte os vários artigos nas secções Introdução e Inícios rápidos e Remover um suplemento sideload.
  • Toolkit do Teams para Visual Studio Code: selecione Executar | Parar Depuração no Visual Studio Code. Para obter mais informações, veja o último passo de Criar um projeto de Suplemento do Outlook que também se aplica a suplementos que não são do Outlook.
  • Kit de desenvolvimento de suplementos do Office para Visual Studio Code: com a extensão Kit de desenvolvimento de suplementos do Office aberta, selecione Parar pré-visualização do Suplemento do Office. Para obter mais informações, consulte Parar de testar o seu suplemento.
  • ferramenta office-addin-debugging: utilize o office-addin-debugging stop comando na mesma linha de comandos onde iniciou a sessão com office-addin-debugging start. Para obter mais informações, consulte Sideload com a ferramenta Office-Addin-Debugging.
  • CLI do Teams Toolkit: utilize o teamsapp uninstall comando na mesma linha de comandos onde iniciou a sessão com teamsapp install. Para obter mais informações, veja Sideload with the Teams Toolkit CLI (Sideload com a CLI do Teams Toolkit).
  • Visual Studio: selecione DEPURAR | Parar depurar no menu ou prima Shift+F5 ou clique no botão "parar" vermelho quadrado na barra de depuração. Em alternativa, fechar a aplicação do Office também interrompe a sessão e desinstala o suplemento. Para obter mais informações, veja Primeira vista do depurador do Visual Studio.

Remover um suplemento fantasma

Para remover um suplemento fantasma, tem de remover os artefactos que foram criados no último sideload, remover o registo local e, para os suplementos do Outlook, remover o registo no Exchange.

O processo para remover o suplemento varia consoante o suplemento seja para o Outlook ou para outra aplicação do Office.

Observação

No manifesto unificado do Microsoft 365, pode ser configurado um suplemento para suportar o Outlook e uma ou mais aplicações do Office; ou seja, existe mais do que um membro da matriz "extensions.requirements.scopes" no manifesto e um dos membros é "mail" (ou a propriedade "extensions.requirements.scopes" não está presente). Trate um suplemento configurado desta forma como um suplemento do Outlook.

Se o suplemento fantasma não for um suplemento do Outlook, avance para a secção Remover os artefactos do suplemento.

Remover o registo do Exchange de um suplemento fantasma do Outlook

  1. Inicie sessão no Outlook com o mesmo ID que utilizou quando carregou o suplemento em sideload.

  2. Abra o PowerShell como Administrador.

  3. Execute os comandos a seguir. Responda "Sim" a todos os pedidos de confirmação.

    Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.4.0
Set-ExecutionPolicy RemoteSigned
Connect-ExchangeOnline

    Observação

    Se o Connect-ExchangeOnline comando devolver o erro "O controlo ActiveX '8856f961-340a-11d0-a96b-00c04fd705a2' não pode ser instanciado porque o thread atual não está num apartamento de thread único", basta executar o comando uma segunda vez. Este é um erro bem conhecido.

  4. Execute o seguinte comando: Responda "Sim" a todos os pedidos de confirmação.

    Get-App | Format-Table -Auto DisplayName,AppId

    É apresentada uma lista dos suplementos instalados no Outlook. Estes irão incluir suplementos e suplementos incorporados da Microsoft que instalou. Todos os suplementos fantasma do Outlook também serão listados.

  5. Localize o suplemento fantasma na lista. Se tiver sido criado com o Yo Office ou outra ferramenta Microsoft, é provável que tenha o nome "Suplemento do Painel de Tarefas da Contoso".

  6. Copie o ID da Aplicação (um GUID) do suplemento. Precisa dele para passos posteriores.

  7. Execute o comando Remove-App -Identity {{The GUID OF YOUR ADD-IN HERE}} (por exemplo, Remove-App -Identity 26ead0cb-10dd-4ba2-86c6-4db111876652). Este comando remove o suplemento do Exchange.

    Aviso

    A remoção do registo tem de ser propagada para todos os servidores do Exchange. Aguarde pelo menos três horas antes de continuar com o passo seguinte.

  8. Continue com a secção Remover os artefactos do suplemento.

Remover os artefactos do suplemento

Importante

Efetue este procedimento em todos os dispositivos nos quais o suplemento foi sideloaded.

  1. Termine sessão em todas as aplicações do Office e, em seguida, feche-as todas, incluindo o Outlook.
  2. Limpe a cache do Office. Se o suplemento fantasma suportar o Outlook, utilize Limpar a cache no Outlook manualmente.
  3. Continue com a secção Remover o registo local.

Remover o registo local

Importante

Efetue este procedimento em todos os computadores nos quais o suplemento foi sideloaded.

  1. Elimine o registo local do suplemento fantasma. O processo varia consoante o sistema operativo.

    1. Abra o Editor de Registo.

    2. Navegue para Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer. Esta chave lista os suplementos que estão atualmente sideloaded ou que foram sideloaded no passado e não foram totalmente desinstalados. O valor Dados para cada entrada é o caminho para o manifesto do suplemento. O valor Nome varia consoante a versão da ferramenta utilizada para criar e fazer sideload do suplemento. Se o Visual Studio tiver sido utilizado, o nome é normalmente também o caminho para o manifesto. Para outras ferramentas, o nome é normalmente o ID do suplemento. Quando uma aplicação do Office é iniciada, recarrega todos os suplementos listados nesta chave (que suportam a aplicação do Office). O recarregamento pode não ter qualquer efeito prático ou discernível se os artefactos do suplemento tiverem sido eliminados da cache ou se o manifesto já não existir no caminho ou se os ficheiros do suplemento não estiverem a ser servidos por um servidor.

      Localize a entrada do suplemento fantasma e elimine-a. Se for um suplemento do Outlook, significa que tem o ID de remover o registo do Exchange. Também pode utilizar o caminho na coluna Dados para localizar o manifesto para ajudar a identificar o suplemento ao qual a entrada se refere e ler o ID do manifesto. Se os manifestos listados na coluna Dados já não existirem no caminho especificado, elimine as entradas desses manifestos.

      O registo do Windows para a chave com o nome Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer.

    3. Expanda o ... Nó de programador na árvore de registo. Procure uma subchave cujo nome seja o ID do mesmo suplemento fantasma. Se estiver lá, elimine-o.

      O registo do Windows para a chave com o nome Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer expandido para mostrar subchaves.

    4. Navegue para Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\WEF\Developer, em que {SID} é o SID do utilizador com o qual iniciou sessão quando carregou o suplemento em sideload e repita os dois passos anteriores.

    5. Navegue para Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache. Na coluna Nome , localize todas as entradas que começam com o ID do suplemento (um GUID) e elimine-as. Em seguida, navegue para Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache, em que {SID} é o SID do utilizador com o qual iniciou sessão quando carregou o suplemento em sideload e repita o processo.

      O registo do Windows para a chave com o nome Computer\HKEY_USERS\SID\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache**, em que SID é o SID de um utilizador.

  1. Se estiver a remover um suplemento do Outlook, continue com a secção Teste para remoção de suplementos do Outlook.

Testar a remoção de suplementos do Outlook

Abra o Outlook com a mesma identidade que utilizou quando criou o suplemento. Se os artefactos do suplemento (como botões do friso personalizados) reaparecerem após alguns minutos ou se os processadores de eventos do suplemento parecerem estar ativos, a remoção do registo do suplemento do Exchange não foi propagada para todos os servidores do Exchange. Aguarde pelo menos três horas e, em seguida, repita os procedimentos nas secções Remover os artefactos do suplemento e Remover o registo local no computador onde observou os artefactos.

Veja também