本文介绍了如何将 Office 外接程序项目中的 JavaScript 文件(Office.js 和特定于应用程序的 .js 文件)和外接程序清单验证文件更新到版本 1.1。
在 Visual Studio 2019 或更高版本中创建的项目已使用版本 1.1。 但是,可以使用本文中的技术,偶尔会应用版本 1.1 的次要更新。
使用最新项目文件
如果使用 Visual Studio 开发外接程序,若要使用 Office JavaScript API 的最新 API 成员和
外接程序 XML 清单的 v1.1 功能
(针对 offappmanifest-1.1.xsd) 进行验证,则需要下载最新版本的 Visual Studio。 若要下载 Visual Studio,请参阅
Visual Studio IDE 页
。 在安装过程中,你需要选择 Office/SharePoint 开发工作负载。
如果使用 Visual Studio 以外的文本编辑器或 IDE 开发外接程序,则需要更新对内容分发网络 (CDN) 的引用,以便Office.js以及外接程序清单中引用的架构版本。
更新使用 Visual Studio 创建的 Office 加载项项目
对于在 Office JavaScript API 和外接程序清单架构 v1.1 发布之前创建的项目,可以使用
NuGet 包管理器
更新项目的文件,然后更新外接程序的 HTML 页面以引用它们。
请注意,更新过程
按项目
应用 - 需要对要使用 v1.1 的 Office.js 和外接程序清单架构的每个外接程序项目重复更新过程。
将项目中的 Office JavaScript API 库文件更新到最新版本
以下步骤会将Office.js库文件更新到最新版本。 这些步骤使用 Visual Studio 2019,但与以前版本的 Visual Studio 类似。
在 Visual Studio 2019 中,打开或创建新的
Office 外接程序
项目。
选择
“工具
>
”“NuGet 包管理器
>
”“管理解决方案的 Nuget 包
”。
选择“更新”
选项卡。
选择 Microsoft.Office.js。 确保包源来自
nuget.org
。
在左窗格中,选择“
安装
”并完成包更新过程。
需要执行其他步骤才能完成更新。 在外接程序 HTML 页面的
头
标记中,注释掉或删除任何现有office.js脚本引用,并引用更新的 Office JavaScript API 库,如下所示:
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
在 CDN URL 中,office.js
中的 /1/
指定在第 1 版 Office.js 中使用最新增量版本。
将项目中的清单文件更新为使用第 1.1 版架构
在外接程序的清单文件中,更新 OfficeApp> 元素的<xmlns 属性,将版本值更改为1.1
(将 xmlns 属性以外的属性保留) 不变。
<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
<!-- manifest contents -->
</OfficeApp>
将外接程序清单架构的版本更新到 1.1 后,需要删除 Capabilities 和 Capability 元素,并将其替换为 Hosts 和 Host 元素或 Requirements 和 Requirements 元素。
更新使用文本编辑器或其他 IDE 创建的 Office 加载项项目
对于在发布 Office JavaScript API 和外接程序清单架构 v1.1 之前创建的项目,需要更新外接程序的 HTML 页面以引用 v1.1 库的 CDN,并更新外接程序的清单文件以使用架构 v1.1。
更新过程 按项目 应用 - 需要针对要使用 v1.1 的 Office.js 和外接程序清单架构的每个外接程序项目重复更新过程。
你不需要 Office JavaScript API 文件 (Office.js 的本地副本和特定于应用的.js文件) 来开发 Office 外接程序 (引用 CDN 供Office.js在运行时) 下载所需文件,但如果需要库文件的本地副本 ,可以使用 NuGet Command-Line 实用工具 和 Install-Package Microsoft.Office.js
命令下载它们。
若要获取 v1.1 外接程序清单的 XSD (XML 架构定义) 的副本,请参阅 Office 外接程序清单的架构参考中的列表。
更新项目中的 Office JavaScript API 库文件以使用最新版本
在您的文本编辑器或 IDE 中打开您的加载项的 HTML 页。
在外接程序 HTML 页面的 头 标记中,注释掉或删除任何现有office.js脚本引用,并引用更新的 Office JavaScript API 库,如下所示:
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>
在 CDN URL 中,office.js
前面的 /1/
指定在第 1 版 Office.js 中使用最新增量版本。
将项目中的清单文件更新为使用第 1.1 版架构
在外接程序的清单文件中,更新 OfficeApp> 元素的<xmlns 属性,将版本值更改为1.1
(将 xmlns 属性以外的属性保留) 不变。
<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
<!-- manifest contents -->
</OfficeApp>
将外接程序清单架构的版本更新到 1.1 后,需要删除 Capabilities 和 Capability 元素,并将其替换为 Hosts 和 Host 元素或 Requirements 和 Requirements 元素。
指定 Office 应用程序和 API 要求 ]
了解 Office JavaScript API
Office JavaScript API
Office 外接程序清单的架构参考