Versões do Office e conjuntos de requisitos

Existem várias versões do Office em várias plataformas, e nem todas elas são compatíveis com todas as APIs da Biblioteca JavaScript do Office (Office.js). Nem sempre você terá controle sobre a versão do Office que os usuários instalaram. Para lidar com essa situação, fornecemos um sistema chamado "conjuntos de requisitos" ou "recursos" para ajudá-lo a determinar se um aplicativo do Office dá suporte aos recursos necessários em seu Suplemento do Office. Um conjunto de requisitos é um grupo nomeado de membros da API. Alguns exemplos são, BindingEvents, , ExcelApi 1.5AddinCommandse WordApi 1.3.

Como verificar sua versão do Office

Office no Windows

Para identificar a versão do Office no Windows, de dentro de um aplicativo do Office, selecione o menu Arquivo e escolha Conta. A versão do Office é exibida na seção Informações do Produto . Por exemplo, a captura de tela a seguir indica a versão 1802 do Office (build 9026.1000).

Office no Mac

Para identificar a versão do Office no Mac, siga as diretrizes em Sobre o Office: Qual versão do Office estou usando?.

Implantação

A maneira como o suplemento é implantado pode afetar a disponibilidade do suplemento nas várias plataformas e clientes. Para saber mais sobre as opções de implantação, confira Implantar e publicar suplementos do Office.

Disponibilidade dos conjuntos de requisitos do Office

Os suplementos do Office podem usar conjuntos de requisitos de API para determinar se o aplicativo do Office dá suporte aos membros da API que ele precisa usar. O suporte ao conjunto de requisitos varia de acordo com o aplicativo do Office, a versão do aplicativo do Office e a plataforma. Para obter informações detalhadas sobre as plataformas, conjuntos de requisitos e APIs comuns compatíveis com cada aplicativo do Office, consulte Disponibilidade de aplicativos cliente e plataformas do Office para suplementos do Office. Confira também a seção anterior Como marcar sua versão do Office.

Um suplemento só pode usar APIs em conjuntos de requisitos compatíveis com a versão do aplicativo do Office em que o suplemento está sendo executado. A maioria das APIs nas APIs comuns da Biblioteca JavaScript do Office é agrupada em conjuntos de requisitos de acordo com o recurso que elas suportam; por exemplo, os AddinCommands conjuntos de requisitos dão suporte à personalização da faixa de opções e o conjunto de requisitos dá suporte à DialogApi Caixa de Diálogo do Office. Para saber mais sobre conjuntos de requisitos comuns da API, confira Conjuntos de requisitos comuns da API do Office.

Os aplicativos do Office que têm APIs específicas do aplicativo (Excel, OneNote, PowerPoint e Word) também têm conjuntos de requisitos explícitos específicos do aplicativo. Por exemplo, o primeiro conjunto de requisitos para a API do Excel foi ExcelApi 1.1, e o primeiro conjunto de requisitos para a API do Word foi WordApi 1.1. O Outlook também tem conjuntos de requisitos específicos do aplicativo, embora não tenha uma arquitetura de API específica do aplicativo como o Excel, o OneNote, o PowerPoint e o Word. Há determinados subconjuntos de APIs comuns que são usados somente no Outlook. Eles são agrupados em conjuntos de requisitos chamados Mailbox, como Mailbox 1.1.

Para saber exatamente quais conjuntos de requisitos específicos do aplicativo estão disponíveis para uma versão específica do aplicativo do Office, consulte os seguintes artigos do conjunto de requisitos específicos do aplicativo.

• Conjuntos de requisitos de API JavaScript para Excel (ExcelApi)
• Conjuntos de requisitos de API JavaScript para OneNote (OneNoteApi)
• Conjuntos de requisitos da API JavaScript do Outlook (Caixa de correio)
• Conjuntos de requisitos da API JavaScript do PowerPoint (PowerPointApi)
• Conjuntos de requisitos de API JavaScript para Word (WordApi)

O número de versão de um conjunto de requisitos específicos do aplicativo, como o "1.1" no ExcelApi 1.1, é relativo ao aplicativo do Office. O número de versão de um determinado conjunto de requisitos (por exemplo, ExcelApi 1.1) não corresponde ao número de versão do Office.js ou aos conjuntos de requisitos para outros aplicativos do Office. Os conjuntos de requisitos para os diferentes aplicativos do Office são lançados em taxas diferentes. Por exemplo, ExcelApi 1.5 foi lançado antes do conjunto de requisitos WordApi 1.3.

A biblioteca de API JavaScript do Office (Office.js) inclui todas as APIs em todos os conjuntos de requisitos. Embora exista algo como conjuntos de requisitos ExcelApi 1.3 e WordApi 1.3, há nenhum conjunto de requisitos Office.js 1.3. A versão mais recente do Office.js é mantida como um único ponto de extremidade do Office fornecida por meio da CDN (rede de distribuição de conteúdo). Para obter mais detalhes sobre a CDN do Office.js, incluindo como a versão e a compatibilidade com versões anteriores são tratadas, consulte Noções básicas sobre a API JavaScript do Office.

Especificar aplicativos do Office e conjuntos de requisitos

Há várias maneiras de especificar quais aplicativos e conjuntos de requisitos do Office são exigidos por um suplemento, e é importante entender como o Office processa a configuração do conjunto de requisitos e a verificação do tempo de execução. Recomendamos que você leia os seguintes artigos.

• Especificar aplicativos do Office e requisitos de API com o manifesto somente do suplemento
• Especifique os aplicativos do Office e os requisitos de API com o manifesto unificado do Microsoft 365
• Como usar a propriedade "requirements" no manifesto unificado para o Microsoft 365
• Entender a lógica da configuração de requisitos da API
• Verificar a disponibilidade da API em tempo de execução

Confira também

• Instalar a última versão do Office
• Visão geral dos canais de atualização do Microsoft 365 Apps
• Reinvente a produtividade com o Microsoft 365 e o Microsoft Teams