office-addins - 为 Office 应用商店提交加载项时，应在 list 文件中引用哪个版本的 Excel API？

Question

将 Excel 加载项提交到 Office 商店时。 list 文件中应引用哪个版本的 Excel API？

我们经历过因为没有引用最新版本的 Excel API 而被拒绝的经历。但是如果我们的 Excel 加载项支持旧版本的 API。我们不应该引用这个吗？

Answer 1

Office.js 库的版本控制有几个方面。

首先，是实际 JavaScript 源文件的版本控制。幸运的是，这部分非常简单:您总是想要最新最好的 Office.js 产品，可以通过我们的 CDN 方便地获得:https://appsforoffice.microsoft.com/lib/1/hosted/Office.js .这些文件也作为 NuGet 包提供，以允许企业防火墙开发，但 NuGet 可能比 CDN 滞后几周——无论如何，需要任何存储绑定(bind)的加载项引用 CDN 位置。因此，就 Office.js 版本而言，那里并没有真正的版本控制:只有一个且唯一的常青、经常更新、始终向后兼容、商店需要的 CDN 版本。

(关于 CDN 的主题:我们还有一个 beta CDN，可在 https://appsforoffice.microsoft.com/lib/beta/hosted/Office.js 获得。这个非常适合测试新实现但尚未正式标记为完成的功能，您将在我们的开放规范中找到:http://dev.office.com/reference/add-ins/openspec。但是，其中的任何新 API 都应被视为严格的“测试版”，它们很可能会被重命名、重新分组或推迟——因此您的应用不应依赖它们，因为我们明确保留在 beta 分支上打破 pack-compat 的权利。一个 API 在 IntelliSense ande 文档中被列为完整之前，直到它在生产 CDN 上可用，*并且直到它的 isSetSupported 返回 true —— 稍后会详细介绍)。

版本控制更有趣的一点是每个主机提供的实际 API 功能。 Office.js 库将具有最新的 JS 代码以能够运行它们，但较旧的主机可能无法支持某些功能。例如，如果您查看 https://dev.office.com/reference/add-ins/requirement-sets/excel-api-requirement-sets ，您将看到 2016 年的 Excel API 浪潮——分组在“ExcelApi”要求集下——迄今为止有三个版本:1.1、1.2 和 1.3。 ExcelApi 1.1 是 2015 年 9 月随 Office 2016 RTM 一起提供的； 1.2 2016年3月上旬发货；和 1.3 刚刚发布，并且正在向 CDN 推出。每个 API 集版本都有一个对应的 Office 主机版本支持这个 API 集(对于大多数 API，必须同时有 JS 和主机端的更改；很少有东西可以是纯 JS 的添加)。版本号列在表中，表下方有链接可找到从内部版本号到日期的映射。

每个 API 集版本都包含许多相当大的功能，以及对现有功能的增量改进。每个需求集的主题(如上面的链接)将提供每个功能的详细列表。在编程时，如果您使用的是 JavaScript 或 TypeScript IntelliSense，您应该能够看到作为 IntelliSense 的一部分显示的每个 API 的 API 版本:

您可以通过以下两种方式之一使用需求集。您可以在 list 中声明“我需要 API 集 ExcelApi 1.2，否则我的加载项根本不起作用”——这很好，但是当然您无法为旧主机提供服务，因此您的加载项甚至不会出现在那里。或者，如果您的加载项可以sorta在 1.1 环境中工作，但您希望在支持它的较新主机上点亮其他功能，您可以使用 list 仅声明所需的最小 API 集(例如 ExcelApi 1.1)，然后通过 isSetSupported API 对更高版本号进行运行时检查。 Neat ways to get environment (i.e. Office version)对此 isSetSupported API 检查有非常详细的解释。

希望这对您有所帮助!