SharePoint 框架 v1.6 发行说明
此版本包含两个新功能:
- WebAPI 功能的最终版本首次在 v1.4.1 中预览
- 支持将 扩展配置为租户范围 而无需激活或配置每个站点。
发布时间:2018 年 9 月 5 日
重要
此页面提供与特定 SPFx 发行版本相关的详细信息。 此页面不包含开发 SPFx 解决方案(包括 SPFx Node.js、Yeoman 和其他工具)而必须安装的其他 SPFx 必备组件。
若要了解有关这些必备组件的详细信息,请参阅设置 SharePoint 框架开发环境。
- 在项目的 package.json 文件中,识别所有 SPFx v1.5.1 程序包。 对于每个 SPFx 程序包:
卸载现有的 v1.5.1 程序包:
npm uninstall @microsoft/{spfx-package-name}@1.5.1
安装刷新后的 v1.6 程序包:
npm install @microsoft/{spfx-package-name}@1.6.0 --save --save-exact
提示
适用于 Microsoft 365 的 CLI 提供了一个简单的分步指南,可用于将你的解决方案升级到最新 SharePoint 框架版本。
对于 WebAPI 功能,GA(正式版)中引入了几项更改。 对受 AAD 保护的资源的所有访问由第三方 AAD 应用程序和服务主体处理。 应用程序是在租户管理员第一次批准权限范围时创建的,并且该应用程序是使用零权限创建的。 因此,需要显式允许与数据建立的任何连接(通过 Microsoft Graph 或调用使用 AAD 作为其权限的终结点)。
重要
在 v1.6.0 版本之前授予的任何权限都需要重新授予,因为我们已更改了使用的 AAD 应用程序。
- 使用
MSGraphClient
。 它存在于组件(Web 部件或扩展)的环境中。 出于性能原因,将按需加载完整代码,以便通过承诺访问它。 - 使用
GraphHttpClient
停止(如果尚未停止)。 在下个月的某个时间,我们会将其从代码中完全删除。 使用它的任何解决方案都将停止工作。 - 与
MSGraphClient
类似,环境中有一个用于调用受 AAD 保护的终结点的常规AadHttpClient
,以及可用于手动获取身份验证令牌的 AadTokenProvider。
现在可以对扩展进行租户范围的配置。 (作为开发人员)跨租户部署的最简单方法是修改 \SharePoint\ClientInstance.xml 文件(使用新的 v1.6.0 解决方案创建)。 这会在应用目录(租户范围扩展)中的新列表中创建一个条目。 还可以直接以应用目录所有者的身份修改该列表。
我们正尝试远离一些常用生成工具的包装器。 前两个是 tslint 和 ts 编译器步骤。 由于这些更改,以前的代码如果不做一些更改则无法编译。
- 首先,默认情况下,源目录的根目录中需要有 一个 *.ts 文件 (,我们现在在 \src 下创建一个名为 index.ts 的文件,) 为空。
- 第二步, tslint.json 文件已更改位置(从 \config 更改为项目的根目录)和格式。 它现在只是一个标准 tslint.json 文件。 最简单的方法是创建一个新项目,并从中复制 tslint.json 文件。
- 第三步,从第 2 步中创建的新项目的根目录中获取 tsconfig.json 文件,并将其复制到原始项目的根目录。 如果更改了 tsconfig.json 文件,则需要合并它们。
我们在标记为 Beta 的 @microsoft/sp-dialog 包中发现了一些类。 我们已将它们移动到公共版。
备注
这是生成工具支持 Node.js v6 的最后一个版本。