Office 版本和要求集
Office 跨多个平台运行且有许多版本,它们并非全都支持 Office JavaScript API (Office.js) 中的所有 API。 Windows 上的 Office 2013 是最早支持 Office 加载项的 Office 版本。你可能无法始终控制用户安装的 Office 版本。 为了应对这种情况,我们提供了一个名为“要求集”的系统,以帮助您确定 Office 应用程序是否支持 Office 外接程序中所需的功能。
注意
- Office 跨多个平台(包括 Windows、浏览器、Mac 和 iPad)运行。
- Office 应用程序的示例包括 Office 产品:Excel、Word、PowerPoint、Outlook、OneNote 等。
- Office 通过 Microsoft 365 订阅或永久许可证提供。 永久版本通过批量许可协议或零售版提供。
- 要求集是 API 成员的命名组,
ExcelApi 1.5
例如 、WordApi 1.3
等。
如何检查 Office 版本
若要确定使用的 Office 版本,请在 Office 应用程序中,依次选择“文件”菜单和“帐户”。 Office 版本显示在 “产品信息 ”部分中。 例如,以下屏幕截图指示 Office 版本 1802 (内部版本 9026.1000) 。
注意
如果你的 Office 版本不同于此版本,请参阅 我拥有哪个版本的 Outlook? 或 关于 Office:我使用的是哪个版本的 Office? ,了解如何获取你的版本的此信息。
部署
加载项的部署方式可能会影响加载项在各种平台和客户端上的可用性。 若要了解有关部署选项的详细信息,请参阅 部署和发布 Office 外接程序。
Office 要求集可用性
Office 外接程序可以使用 API 要求集来确定 Office 应用程序是否支持需要使用的 API 成员。 要求集支持因 Office 应用程序和 Office 应用程序版本而异, (请参阅前面的如何检查 Office 版本) 部分。
某些 Office 应用程序有自己的 API 要求集。 例如,第一个 Excel API 要求集为 ExcelApi 1.1
,第一个 Word API 要求集为 WordApi 1.1
。 从那以后,便新增了多个 ExcelApi 要求集和 WordApi 要求集,以提供其他 API 功能。
此外,通用 API 中还添加了加载项命令(功能区扩展性)和对话框启动功能(对话框 API)等其他功能。 外接程序命令和对话框 API 要求集是各种 Office 应用程序共同共享的 API 集的示例。
外接程序只能在运行加载项的 Office 应用程序版本支持的要求集中使用 API。 若要确切了解哪些要求集可用于特定 Office 应用程序版本,请参阅以下特定于应用程序的要求集文章。
- Excel JavaScript API 要求集 (ExcelApi)
- OneNote JavaScript API 要求集 (OneNoteApi)
- Outlook JavaScript API 要求集 (邮箱)
- PowerPoint JavaScript API 要求集 (PowerPointApi)
- Word JavaScript API 要求集 (WordApi)
某些要求集包含可供多个 Office 应用程序使用的 API。 有关这些要求集的信息,请参阅以下文章。
- Office 通用要求集
- 加载项命令要求集
- 设备权限服务要求集
- 对话框 API 要求集
- 对话框源要求集
- 标识 API 要求集
- 图像强制要求集
- 键盘快捷方式要求集
- 嵌套应用身份验证要求集
- 打开浏览器窗口要求集
- 功能区 API 要求集
- 共享运行时要求集
要求集的版本号(如 中的 ExcelApi 1.1
“1.1”)相对于 Office 应用程序。 给定要求集的版本号 (例如, ExcelApi 1.1
) 不对应于 Office.js 的版本号或其他 Office 应用程序 (的要求集,例如Word、Outlook 等 ) 。 不同 Office 应用程序的要求集以不同的速率发布。 例如,ExcelApi 1.5
要求集先于 WordApi 1.3
要求集发布。
Office JavaScript API 库 (Office.js) 包含当前可用的所有要求集。 虽然有 ExcelApi 1.3
和 WordApi 1.3
等要求集,但并无 Office.js 1.3
要求集。 最新版 Office.js 作为一个通过内容传送网络 (CDN) 提供的 Office 终结点进行维护。 若要详细了解 Office.js CDN(包括如何处理版本控制和向后兼容性),请参阅了解 Office JavaScript API。
指定 Office 应用程序和要求集
有多种方法可以指定外接程序需要哪些 Office 应用程序和要求集。 有关详细信息,请参阅 指定 Office 应用程序和 API 要求