Conjuntos de requisitos da API JavaScript do ExcelExcel JavaScript API requirement sets

Os conjuntos de requisitos são grupos nomeados de membros da API. Os Suplementos do Office usam conjuntos de requisitos especificados no manifesto ou usam uma verificação de tempo de execução para determinar se um aplicativo do Office dá suporte para as APIs necessárias para um suplemento. Para saber mais, confira Versões do Office e conjuntos de requisitos.Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office application supports APIs that an add-in needs. For more information, see Office versions and requirement sets.

Disponibilidade do conjunto de requisitosRequirement set availability

Os suplementos do Excel são executados em várias versões do Office, incluindo o Office 2016 ou posterior no Windows, Office na Web, Mac e iPad.Excel add-ins run across multiple versions of Office, including Office 2016 or later on Windows, and Office on the web, Mac, and iPad. A tabela a seguir lista conjuntos de requisitos do Excel, ou seja, os aplicativos do cliente Office que oferecem suporte a esse conjunto de requisitos, e as versões ou números de compilação desses aplicativos.The following table lists the Excel requirement sets, the Office client applications that support each requirement set, and the build versions or number for those applications.

Observação

Para usar APIs em qualquer um dos conjuntos de requisitos numerados ou ExcelApiOnline, faça referência à biblioteca production no CDN: https://appsforoffice.microsoft.com/lib/1/hosted/office.js.To use APIs in any of the numbered requirement sets or ExcelApiOnline, you should reference the production library on the CDN: https://appsforoffice.microsoft.com/lib/1/hosted/office.js.

Para obter informações sobre o uso de APIs de visualização, confira o artigo APIs de visualização do JavaScript para Excel.For information about using preview APIs, see the Excel JavaScript preview APIs article.

Conjunto de requisitosRequirement set Office no WindowsOffice on Windows
(conectado a uma assinatura do Microsoft 365)(connected to a Microsoft 365 subscription)
Office no iPadOffice on iPad
(conectado a uma assinatura do Microsoft 365)(connected to a Microsoft 365 subscription)
Office no MacOffice on Mac
(conectado a uma assinatura do Microsoft 365)(connected to a Microsoft 365 subscription)
Office na WebOffice on the web
VisualizaçãoPreview Use a versão mais recente do Office para experimentar APIs de visualização (pode ser necessário ingressar no Programa Office Insider).Please use the latest Office version to try preview APIs (you may need to join the Office Insider program).
ExcelApiOnlineExcelApiOnline Não disponívelN/A N/DN/A Não disponívelN/A Mais recente (confira a página conjunto de requisitos)Latest (see requirement set page)
ExcelApi 1.12ExcelApi 1.12 Versão 2008 (Build 13127.20408) ou posteriorVersion 2008 (Build 13127.20408) or later 16.40 ou posterior16.40 or later 16.40 ou posterior16.40 or later Setembro de 2020September 2020
ExcelApi 1.11ExcelApi 1.11 Versão 2002 (Build 12527.20470) ou posteriorVersion 2002 (Build 12527.20470) or later 16.35 ou posterior16.35 or later 16.33 ou posterior16.33 or later Maio de 2020May 2020
ExcelApi 1.10ExcelApi 1.10 Versão 1907 (Build 11929.20306) ou posteriorVersion 1907 (Build 11929.20306) or later 16.0 ou posterior16.0 or later 16.30 ou posterior16.30 or later Outubro de 2019October 2019
ExcelApi 1.9ExcelApi 1.9 Versão 1903 (Build 11425.20204) ou posteriorVersion 1903 (Build 11425.20204) or later 16.0 ou posterior16.0 or later 16.24 ou posterior16.24 or later Maio de 2019May 2019
ExcelApi 1.8ExcelApi 1.8 Versão 1808 (Build 10730.20102) ou posteriorVersion 1808 (Build 10730.20102) or later 16.0 ou posterior16.0 or later 16.17 ou posterior16.17 or later Setembro de 2018September 2018
ExcelApi 1.7ExcelApi 1.7 Versão 1801 (Build 9001.2171) ou posteriorVersion 1801 (Build 9001.2171) or later 16.0 ou posterior16.0 or later 16.9 ou posterior16.9 or later Abril de 2018April 2018
ExcelApi 1.6ExcelApi 1.6 Versão 1704 (Compilação 8201.2001) ou posteriorVersion 1704 (Build 8201.2001) or later 15.0 ou posterior15.0 or later 15.36 ou posterior15.36 or later Abril de 2017April 2017
ExcelApi 1.5ExcelApi 1.5 Versão 1703 (Compilação 8067.2070) ou posteriorVersion 1703 (Build 8067.2070) or later 15.0 ou posterior15.0 or later 15.36 ou posterior15.36 or later Março de 2017March 2017
ExcelApi 1.4ExcelApi 1.4 Versão 1701 (build 7870.2024) ou posteriorVersion 1701 (Build 7870.2024) or later 15.0 ou posterior15.0 or later 15.36 ou posterior15.36 or later Janeiro de 2017January 2017
ExcelApi 1.3ExcelApi 1.3 Versão 1608 (build 7369.2055) ou posteriorVersion 1608 (Build 7369.2055) or later 15.0 ou posterior15.0 or later 15.27 ou posterior15.27 or later Setembro de 2016September 2016
ExcelApi 1.2ExcelApi 1.2 Versão 1601 (build 6741.2088) ou posteriorVersion 1601 (Build 6741.2088) or later 15.0 ou posterior15.0 or later 15.22 ou posterior15.22 or later janeiro de 2016January 2016
ExcelApi 1.1ExcelApi 1.1 Versão 1509 (build 4266.1001) ou posteriorVersion 1509 (Build 4266.1001) or later 15.0 ou posterior15.0 or later 15.20 ou posterior15.20 or later janeiro de 2016January 2016

Observação

Versões permanentes dos conjuntos de requisitos de suporte do Office como a seguir:Perpetual versions of Office support requirement sets as follows:

  • O Office 2019 é compatível com o ExcelApi 1.8 e versões anteriores.Office 2019 supports ExcelApi 1.8 and earlier.
  • O Office 2016 é compatível somente com o conjunto de requisitos do ExcelApi 1.1.Office 2016 only supports the ExcelApi 1.1 requirement set.

Versões do Office e números de buildOffice versions and build numbers

Para saber mais sobre as versões do Office e os números de build, confira:For more information about Office versions and build numbers, see:

Como usar os conjuntos de requisitos do Excel no tempo de execução e no manifestoHow to use Excel requirement sets at runtime and in the manifest

Observação

Esta seção pressupõe que você esteja familiarizado com a visão geral dos conjuntos de requisitos em Versões e conjuntos de requisitos do Office e Especificar aplicativos do Office e requisitos de API.This section assumes you're familiar with the overview of requirement sets at Office versions and requirement sets and Specify Office applications and API requirements.

Os conjuntos de requisitos são grupos nomeados de membros da API.Requirement sets are named groups of API members. Um Suplemento do Office pode executar uma verificação de tempo de execução ou usar conjuntos de requisitos especificados no manifesto para determinar se um aplicativo do Office dá suporte às APIs necessárias ao suplemento.An Office Add-in can perform a runtime check or use requirement sets specified in the manifest to determine whether an Office application supports the APIs that the add-in needs.

Verificando o suporte ao conjunto de requisitos no tempo de execuçãoChecking for requirement set support at runtime

O exemplo de código a seguir mostra como determinar se o aplicativo do Office, onde o suplemento está em execução, dá suporte ao conjunto de requisitos da API especificado.The following code sample shows how to determine whether the Office application where the add-in is running supports the specified API requirement set.

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

Definindo o suporte ao conjunto de requisitos no manifestoDefining requirement set support in the manifest

Você pode usar o elemento Requirements no manifesto do suplemento para especificar os conjuntos de requisitos mínimos e/ou os métodos de API exigidos pelo suplemento para ser ativado.You can use the Requirements element in the add-in manifest to specify the minimal requirement sets and/or API methods that your add-in requires to activate. Se a plataforma ou o aplicativo do Office não for compatível com os conjuntos de requisitos ou métodos de API especificados no Requirements elemento do manifesto, o suplemento não será executado nesse aplicativo ou plataforma, e não será exibido na lista de suplementos mostrados no Meus suplementos . Se o seu suplemento exige um conjunto específico de requisitos para funcionalidade total, mas pode fornecer um valor mesmo para os usuários nas plataformas que não têm suporte para o conjunto de requisitos, recomendamos verificar o suporte a requisitos no tempo de execução conforme descrito acima, em vez de definir o suporte ao conjunto de requisitos no manifesto.If the Office application or platform doesn't support the requirement sets or API methods that are specified in the Requirements element of the manifest, the add-in won't run in that application or platform, and it won't display in the list of add-ins that are shown in My Add-ins . If your add-in requires a specific requirement set for full functionality, but it can provide value even to users on platforms that do not support the requirement set, we recommend that you check for requirement support at runtime as described above, instead of defining requirement set support in the manifest.

O exemplo de código a seguir mostra o elemento Requirements em um manifesto de suplemento que especifica se o suplemento deve ser carregado em todos os aplicativos cliente do Office que dão suporte ao conjunto de requisitos ExcelApi, versão 1.3 ou superior.The following code sample shows the Requirements element in an add-in manifest which specifies that the add-in should load in all Office client applications that support ExcelApi requirement set version 1.3 or greater.

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

Confira tambémSee also