通过

SharePoint 框架 v1.12.1 发行说明

  • 项目

此版本在 Web 部件 API 中引入了一个新的属性 & 事件，用于检测呈现宽度 (和更改) 、改进对 Microsoft Teams 解决方案的支持，以及更新支持的 Node.js 版本。

发布时间：2021 年 4 月 28 日

重要

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

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

将项目从 v1.11.0 升级到 v1.12.1

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

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

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

    2. 安装刷新后的 v1.12 {version-release} 程序包：

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

提示

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

新增特性和功能

  • 租户应用程序目录中的“同步到 Teams”按钮将使用解决方案中定义的 Teams 应用程序清单（如果存在）来创建 Teams 应用包并发布到 Microsoft Teams。 如果应用清单文件不存在，SharePoint 将动态生成一个文件。
  • SPWeb Web 部件类中增加了一个新的 API，以确定 Web 部件渲染宽度，并在更改时处理事件（可选）。
  • 展开列表通知以同时用于列表和文档库。
  • 通过 SharePoint 框架初步支持 Microsoft Teams 会议应用 - 对服务器端回归的全面支持正在等待修复

本版本中的更改

  • 添加对 Node.js v12.13.x & v14.15.x 的支持
    • 请参阅设置 SharePoint 框架开发环境，了解详细信息。
    • 强烈建议使用 Gulp-CLI。 我们之前的指导是全局安装 Gulp v3 或 v4，但 Gulp 团队的指导是仅全局安装 Gulp CLI。 通过使用 Gulp CLI，你可以有使用 Gulp v3 的项目和其他使用 Gulp v4 的项目。
  • 对于所有项目：
  • 对于使用 React 的项目：
    • 将 React NPM 包 (react&react-dom) 更新为 v16.9.0。
    • 将 Office UI Fabric React NPM 包 / Microsoft Fluent UI (office-ui-fabric-react) 更新为 v7.156.0。
  • 用于部署的资源默认位置已从 ./temp/deploy 更改为 ./releases/assets。 对于在 SPFx v1.12.1 之前创建的项目，应更新 ./config/deploy-azure-storage.json 文件属性 workingDir 至新位置："workingDir": "./release/assets/"。 有关详细信息，请参阅部署你的 SharePoint 客户端 Web 部件至 Azure CDN：配置 Azure 存储帐户详细信息。

此版本中的弃用和已删除项目

  • 使用 Node.js v12+ 时，不支持从全局从本地或本地安装的Gulp v3。

  • 已弃用的本地工作台 - 这是支持本地工作台的最后一个版本。

  • 这是包含适用于本地部署和 SharePoint Online 的单一生成器的最后一个版本。 你仍然可以使用旧版生成器为本地部署创建项目。

  • gulp serve 任务已弃用并重命名为 serve-deprecated。 为解决此问题，新的 SPFx v1.12.1 项目中的 gulpfile.js 已更新，从而为重命名的 serve-deprecated 任务添加别名 serve。 不过，如果你正在将项目升级到 SPFx v1.12.1，需要编辑 gulpfile.js 文件，从而使 gulp serve 任务继续工作。

    将 SPFx 项目升级到 v1.12.1 时，请在行 build.initialize(require('gulp')); 前面添加以下内容：

    var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};

Node.js v12+ 的 Gulp 版本&

Node.js v12+ 不支持 Gulp v3（参阅 lp/#2324）。

SPTx 没有变化。 请注意：SPFx 版本增加了对 Node.js v12 的支持。