通过

SharePoint 框架 v1.4.1 发行说明

  • 项目

发布时间：2018 年 2 月 15 日

重要

此页面提供与特定 SPFx 发行版本相关的详细信息。 此页面不包含开发 SPFx 解决方案（包括 SPFx Node.js、Yeoman 和其他工具）而必须安装的其他 SPFx 必备组件。

若要了解有关这些必备组件的详细信息，请参阅设置 SharePoint 框架开发环境。

将项目从 v1.4. 升级到 v1.4.1

  1. 在项目的 package.json 文件中，标识所有 SPFx v1.4 包。 对于每个 SPFx 程序包：

    1. 卸载现有的 v1.4 程序包：

      npm uninstall @microsoft/{spfx-package-name}@1.4

    2. 安装刷新的 v1.4.1 程序包：

      npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact

提示

适用于 Microsoft 365 的 CLI 提供了一个简单的分步指南，可用于将你的解决方案升级到最新 SharePoint 框架版本。

新增特性和功能

节点 v8 (LTS) 和 NPM v5 支持

SPFx 现在提供 Node.js v8 (LTS) 和 NPM v5 支持。

已报告的问题位于此处：https://github.com/SharePoint/sp-dev-docs/issues/1002

我们已经更新了 设置 SharePoint 框架开发环境 文章。

新 API（开发人员预览）

以下是可用于 SharePoint Online 中预览使用的新 API。 这些还 不 能在生产中使用。

@microsoft/sp-http

  • AadHttpClient 类的初始 beta 版本
  • AadTokenProvider 类的初始 beta 版本

@microsoft/sp-client-preview

  • MSGraphClient 类的初始 beta 版本

可从 Office SharePoint 开发文档中找到这些新 API 的教程。

AadHttpClient（开发人员预览版）

AadHttpClient 用于对 Azure AD 应用程序执行 REST 调用，例如在 Azure 中托管的第三方 WebAPI。

  • 如果要与 SharePoint 通信，请改用 SPHttpClient 类。
  • 如果要与 Microsoft Graph 通信，请使用 MSGraphClient 类。

可从 Office SharePoint 开发文档中找到有关此新 API 的详细信息：

MSGraphClient（开发人员预览版）

MSGraphClient 用于对 Microsoft Graph 执行 REST 调用。 Microsoft Graph JavaScript 客户端库是围绕Microsoft Graph API 的轻型包装器。 此类允许开发人员启动对 MSGraph 进行 REST 调用，而无需初始化 MSGraph 客户端库。

如果需要自定义配置，则需要为每个请求提供具有该自定义配置的 MSGraphClient API 函数。

重要

请注意，此 API 将替换以前发布的 GraphHttpClient，现在该版本被视为已弃用。

AadTokenProvider

此类是 AadHttpClient 和 MSGraphClient 用于从 Azure AD 获取 OAuth2 令牌的内部类。 尽管该类当前标记为公共类，但我们计划将其更改为内部类。 出于此原因，解决方案应仅依赖于 AadHttpClient 和 MSGraphClient 类。

此版本中的更改

  • 我们修复了生成器中阻止激活新版本 SPFx 包的问题。
  • 症状 - 部署新版本的 SharePoint 框架包，并且在 Web 部件选取器中不再看到 Web 部件。

    • #775

    • 修复：要完全成功修复此问题，需要在 SharePoint Online 租户中执行以下步骤。

      1. 从网站级别删除现有 SharePoint 框架解决方案的所有实例
      2. 从应用目录中删除 SharePoint 框架解决方案
      3. 将使用 1.4.1 版本生成的新 SharePoint 框架解决方案上传到应用目录
      4. 将 SharePoint 框架解决方案安装回站点。

      注意

      对于租户范围的 SharePoint 框架解决方案，此问题 不会 发生，并且 SharePoint 外接程序也不会发生此问题。

      提示

      你可能会利用 应用程序生命周期管理 (ALM) API 自动执行此所需过程。

此版本中的启用项和已删除项

  • 该 GraphHttpClientAPI 已弃用，以支持此版本中引入的新 MSGraphClient。 GraphHttpClient 将在今后的版本中删除。