Share via

SharePoint 框架 v1.4 发行说明

  • 项目

发布日期：2017 年 12 月 7 日

重要

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

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

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

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

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

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

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

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

提示

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

新增特性和功能

@microsoft/sp-tslint-rules

  • 引入新的 no-require-ensure 规则，以便于弃用 require.ensure() ，以支持 import 关键字

@microsoft/sp-build-web

  • 启用要合并到 *.sppkg 文件中并由 SharePoint 托管的生成资产

@microsoft/sp-build-core-tasks

  • 将asyncComponents选项添加到 config.json。 此设置可用于避免导致库意外同步加载而不是异步加载的导入
  • 引入在 Web 部件或扩展清单中指定图标相对路径的功能

@microsoft/generator-sharepoint

  • 生成客户端扩展项目时向库添加缺少的波形符
  • 启用 skipLibCheck 以解决 lodash 和 es2015.collection 中"WeakMap"的不一致声明
  • 将 launch.json 和 extensions.json 添加到生成器 SharePoint 解决方案

@microsoft/sp-http

  • 将 SPHttpClientBatch 从 @alpha 提升为 @beta
  • SPHttpHeader 枚举和SPHttpClientResponse.correlationId属性的初始 beta 版本

@microsoft/sp-loader

  • 禁止加载在 1.0 之前使用 SPFx 预览版生成的组件

@microsoft/sp-module-interfaces

  • 将 preloadListItemProperties 添加到客户端应用程序清单的 preloadOptions 部分
  • 在 Web 部件清单中添加“标记”属性
  • 引入在 Web 部件或扩展清单中指定图标相对路径的功能
  • 启用 preloadComponents 字段以与其他客户端组件清单类型一起使用

@microsoft/sp-webpart-base

  • 将 shouldNotPersist 添加到 IWebPartPropertyMetadata，以允许标记不应保留在服务器上的 Web 部件属性

@microsoft/sp-lodash-subset

  • 添加 escaperegex() 函数
  • 使用 lodash-cli 显著减小@microsoft/sp-lodash-子集的捆绑包大小
  • 添加 find() 函数

本版本中的更改

  • 将 @types/es6-collections 替换为 typescript 编译器的内置 es2015.collection 库
  • 从一些现已正式支持的 API 中删除 beta 标记

@microsoft/generator-sharepoint

  • 使用较旧版本的 config.json 文件更新生成器，因为自动升级会干扰较旧的分支（如本地）
  • 在生成的 package.json 中包括缺少的 ajv 依赖项
  • 删除过时的 JSON 架构设置
  • 修复了分析本地配置文件的问题
  • 修复了在创建没有模板的 Web 部件时，将"WebPart"附加到类名两次的问题
  • 删除了之前会删除部分组件名称的启发式，因为客户发现这样会令人困惑
  • 修复了扩展的本地化文件被覆盖的问题
  • 修复了 Knockout Web 部件模板的数据绑定问题
  • 为 Fabric 引起的"CSS 类 ms-Grid 不是 camelCase"警告添加抑制
  • 更新 Yeoman 生成器以使用 @microsoft/sp-office-ui-fabric-core ，而不是直接引用 office-ui-fabric
  • 将生成器的 React 类型声明更新为使用较新的 React-DOM，并删除弃用的 React-addons 包

@microsoft/loader-cased-file

  • 更新依赖项并修复导致警告的一些问题

@microsoft/sp-office-ui-fabric-core

  • 从 @microsoft/sp-office-ui-fabric-core 中删除 Z-index 支持

@microsoft/sp-client-preview

  • 将 @types/es6-collections 替换为 TypeScript 编译器的内置 es2015.collection 库

@microsoft/sp-build-core-tasks

  • 修复了不遵守 --locale 参数的问题
  • 将批处理添加到 dev-deploy 和 upload-cdn
  • 修复了图标 URL 生成的次要问题：图标 URL 缺少 CDN 前缀
  • 更新了 Webpack 加载程序以消除弃用警告

@microsoft/sp-webpart-base

  • 修复了属性窗格无法正确刷新的问题
  • 修复了属性窗格按钮中的 ariaLabel 功能问题
  • 修复了复选框标题较长时的 Internet Explorer 兼容性问题
  • 删除 @beta 的指定 WebPartContext

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

@microsoft/sp-build-core-tasks

  • 弃用 UNIT_TEST Webpack 宏，因为这种做法太容易在生产捆绑包中意外包含测试代码

@microsoft/sp-core-library

  • 已弃用的 IServiceCollection 和 UrlQueryParameterCollection

@microsoft/sp-webpart-base

  • 弃用 IWebPartContext