Manter seu Suplemento do Office

  • Artigo

Depois de publicar seu suplemento, você deve mantê-lo atualizado com quaisquer alterações importantes de bibliotecas upstream. Corrigir problemas de segurança é fundamental para criar a confiança do cliente. Como essas alterações não têm efeito no manifesto publicado, seus clientes não precisarão tomar nenhuma ação para obter as versões mais recentes do suplemento.

Alterações de interrupção no Office.js

A Plataforma de Desenvolvedores do Microsoft 365 está comprometida em garantir a compatibilidade do seu suplemento. Nós nos esforçamos para evitar fazer alterações de interrupção na superfície e no comportamento da API. No entanto, há casos em que precisamos fazer atualizações de interrupção por uma questão de segurança ou confiabilidade. Nesses casos raros, as etapas a seguir são tomadas para garantir que os usuários do suplemento não sejam afetados.

Política de preterição

APIs ou ferramentas com alternativas melhores podem ser preteridas. A Microsoft passa por um melhor esforço para declarar algo como preterido com pelo menos 24 meses de antecedência de retirá-lo. Da mesma forma, para APIs individuais que geralmente estão disponíveis (GA), a Microsoft declara uma API como preterida com antecedência de pelo menos 24 meses antes de removê-la da versão de GA.

A preterição não significa necessariamente que o recurso ou a API serão removidos e inutilizáveis pelos desenvolvedores. Isso mostra que, após o período de 24 meses, a Microsoft não dará mais suporte à API ou ao recurso.

Quando uma API é marcada como preterida, é altamente recomendável que você migre para a versão mais recente assim que 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 preterimento de 24 meses será acelerado se a espera por tanto tempo representar um risco de segurança para seu suplemento ou Microsoft.

Garantia de Aplicativo

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

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

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

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

Alterações nos modelos do Yeoman e nas dependências da Web

O Gerador yeoman para suplementos do Office depende de várias bibliotecas da Microsoft e outras. Essas bibliotecas são atualizadas independentemente de qualquer atividade do Microsoft 365. Todos os projetos criados com o gerador devem ser mantidos atualizados conforme 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 bibliotecas dependentes.

Essa orientação também se aplica a cópias de amostras colhidas dos exemplos de código de suplemento do Office e de outras fontes.

office.js pacote NPM

O pacote de NPM do office-js é uma cópia do que está hospedado na CDN (rede de distribuição de conteúdo)Office.js. Destina-se a cenários em que o acesso direto à CDN não é possível. O pacote NPM não se destina a fornecer referências em versão para office.js. Recomendamos sempre usar a CDN para garantir que você esteja usando a versão mais recente das APIs JavaScript do Office.

Práticas recomendadas atuais

Embora nos esforcemos para manter a compatibilidade inversa, os padrões e práticas que recomendamos evoluem continuamente. Nossa documentação se esforça para apresentar as melhores práticas atuais. Para se manter informado sobre novos recursos que podem melhorar sua funcionalidade existente, junte-se à chamada mensal da Comunidade de Suplementos do Office.

Implantar atualizações

Ao adicionar recursos ou corrigir bugs no suplemento, você precisará implantar as atualizações. Se o suplemento for implantado por um ou mais administradores em suas organizações, algumas alterações de manifesto exigirão que o administrador consenta com as atualizações. Os usuários serão bloqueados do suplemento até que o consentimento seja concedido. As alterações de manifesto a seguir exigirão que o administrador consenta novamente.

Observação

Sempre que você fizer uma alteração no manifesto, você deve aumentar o número de versão do manifesto.

Envolvimento da comunidade

À medida que as atualizações são propostas para a Plataforma de Desenvolvedores do Microsoft 365, estaremos ouvindo comentários. Informe preocupações, possíveis consequências ou outras perguntas aos canais listados nos recursos adicionais de Suplementos do Office.