Atualizar e manter seu Suplemento do Office

Depois de publicar seu suplemento, você deve mantê-lo atualizado com todas as alterações importantes das bibliotecas upstream. A aplicação de patch a problemas de segurança é fundamental para aumentar a confiança do cliente. Como essas alterações não têm efeito sobre o manifesto publicado, seus clientes não precisarão realizar nenhuma ação para obter as versões mais recentes do seu suplemento.

Escolha seu cenário

Alterações interruptivas no Office.js

Esforçamo-nos para evitar fazer alterações interruptivas na superfície e no comportamento da API. No entanto, há casos em que precisamos fazer atualizações interruptivas por motivos de segurança ou confiabilidade. Nesses casos raros, as etapas a seguir são executadas para garantir que os usuários do seu suplemento não sejam afetados.

Política de substituição

As ferramentas podem ser preteridas quando algo melhor estiver disponível, e as APIs na Biblioteca JavaScript do Office (Office.js) que estão geralmente disponíveis (GA) podem ser preteridas quando sua tarefa for melhor executada com APIs mais recentes. A Microsoft se esforça ao máximo para declarar preterições com pelo menos 24 meses de antecedência. A substituição não significa necessariamente que o recurso ou a API será removido e inutilizável pelos desenvolvedores. Mas após 24 meses, a Microsoft não dará mais suporte à ferramenta ou à API, e a ferramenta poderá ser desativada e a API poderá ser removida da versão GA do Office.js.

Quando uma API é marcada como preterida, é altamente recomendável que você migre para as APIs de substituição o mais rápido possível. Em alguns casos, anunciaremos que novos aplicativos devem começar a usar as novas APIs pouco tempo depois que as APIs originais forem preteridas. Nesses casos, apenas os aplicativos ativos que usam atualmente as APIs preteridas podem continuar a usá-las.

Importante

O período de preterição de 24 meses será acelerado se esperar tanto representar um risco de segurança para o seu suplemento ou para a Microsoft.

Garantia de Aplicativo

O serviço App Assure da Microsoft cumpre a promessa da Microsoft de compatibilidade de aplicativos: seus aplicativos funcionarão no Windows e no Microsoft 365 Apps. Os engenheiros do App Assure estão disponíveis para ajudar a resolver quaisquer problemas que você possa ter sem custo adicional.

Se você encontrar um problema de compatibilidade de aplicativo, os engenheiros do App Assure trabalharão com você para ajudá-lo a resolve-lo. Nossos especialistas irão:

  • Ajudar você a solucionar problemas e identificar uma causa raiz.
  • Forneça orientações para ajudá-lo a corrigir o problema de compatibilidade do aplicativo.
  • Engage com fornecedores independentes de software (ISVs) em seu nome para corrigir alguma parte de seus aplicativos, para que ele funcione na versão mais moderna de nossos produtos.
  • Trabalhe com as equipes de engenharia de produtos da Microsoft para corrigir bugs do produto.

Para saber mais sobre o App Assure, assista Traga seus aplicativos para o Microsoft Edge com o App Assure: dicas e truques. Para enviar sua solicitação de compatibilidade de aplicativo com o App Assure, preencha o formulário de registro do Microsoft FastTrack ou envie um email para achelp@microsoft.com.

Atualizar seu suplemento

Quando você atualiza seu suplemento, há duas partes a serem consideradas: o aplicativo Web e o pacote de suplemento, incluindo o manifesto.

Atualizar o aplicativo Web

Atualizações em seu aplicativo Web não exigem nenhuma ação de seus usuários. Carregue novos arquivos HTML, CSS, código e outros arquivos para seu aplicativo Web e CDNs e seus usuários começarão a ver os novos recursos automaticamente. Alguns artefatos do suplemento, como ícones de botão, são armazenados em cache quando o suplemento é instalado pela primeira vez. Talvez os usuários não vejam os ícones atualizados inicialmente. Se os usuários ficarem confusos ao ver os ícones mais antigos, fechar e reabrir o aplicativo do Office deverá fazer com que a versão mais recente dos artefatos seja baixada. Se isso não acontecer, você poderá instruí-los sobre como fechar todos os aplicativos do Office e, em seguida, limpar o cache do Office. Isso removerá os artefatos armazenados em cache de todos os suplementos instalados, mas eles serão baixados novamente na próxima vez que o aplicativo do Office for iniciado, portanto, o único efeito disso é um atraso muito pequeno na exibição dos ícones.

Atualizar os arquivos do pacote do aplicativo

As alterações no manifesto ou em outros arquivos no pacote do aplicativo exigem que os usuários atualizem. Se você publicou seu suplemento no Microsoft Marketplace, será necessário atualizar seu envio. Mais informações sobre esse processo são encontradas no artigo Atualizar uma oferta existente.

Sempre que você fizer uma alteração no manifesto ou em qualquer arquivo no pacote do aplicativo, deverá aumentar o número de versão do manifesto. (Isso inclui alterações nas URLs no manifesto que apontam para arquivos de configuração complementares no pacote do aplicativo, como arquivos de configuração do Copilot.)

  • Se o suplemento usar o manifesto unificado, consulte a propriedade version.
  • Se o suplemento usar o manifesto somente do suplemento (nesse caso, não há pacote do aplicativo), consulte Elemento Version.

Se o suplemento for implantado por um ou mais administradores em suas organizações, algumas alterações de manifesto exigirão que o administrador dê consentimento às atualizações. Os usuários são impedidos do suplemento até que o consentimento seja concedido. As alterações de manifesto a seguir exigem que o administrador dê consentimento novamente.

Manter seu suplemento seguro

Os projetos de suplemento criados com o Gerador Yeoman para Suplementos do Office ou com o Microsoft 365 Agents Toolkit dependem de várias bibliotecas da Microsoft e de outras pessoas. Essas bibliotecas são atualizadas independentemente de qualquer atividade do Microsoft 365. Seus projetos devem ser mantidos atualizados à medida que você desenvolve, publica e mantém seu suplemento. As ferramentas a seguir podem ajudar a garantir que seu projeto esteja usando versões seguras de todas as bibliotecas dependentes.

Essa orientação também se aplica a cópias de exemplos obtidos do Suplemento do Office, exemplos de código e outras fontes.

Solução de problemas

  • Meus usuários não podem acessar o suplemento atualizado. Verifique se a versão do manifesto foi incrementada e se o envio do Marketplace foi atualizado.
  • As caixas de diálogo de consentimento do Administrador não estão aparecendo. Certifique-se de que as permissões/escopos/eventos realmente foram alterados. Teste em seu locatário de desenvolvimento.

Envolvimento da comunidade

Conforme as atualizações forem propostas para a Plataforma de Desenvolvedor do Microsoft 365, estaremos atentos aos comentários. Relate preocupações, possíveis consequências ou outras perguntas aos canais listados em Recursos adicionais dos Suplementos do Office.

Mantenha-se informado sobre novos recursos e práticas recomendadas em evolução por meio de nossa Chamada da Comunidade mensal de Suplementos do Office.

Confira também

  • Last updated on