通过

SharePoint 框架 v1.0.0 发行说明

欢迎使用 SPFx 1.0 的正式发布版。 到目前为止，这是一次令人激动且有趣的旅行，并且将继续如此。 这只是第一个版本 - 请期待不断推出的改进和功能。

发布时间：2017 年 2 月 22 日

重要

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

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

将项目从预览版升级到 v1.0.0

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

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

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

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

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

提示

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

新增特性和功能

你可以获取更新的 npm 包，并在本地工作台中使用它们，一切都应正常运行。 但是，代码将分阶段在几天内推出到服务器。 到下周的某个时间，100% 的服务器场都将拥有它。 我们这样做是为了监视推出过程，并确保没有任何问题。

现在是否可以使用 SPFX 和客户端 Web 部件？

其实有两个方面的因素在起作用。 一个是代码在所有服务器场上都可用，第二个是为给定租户启用功能。

与代码在服务器场中的推出方式类似，功能将推出给租户。 我们将从目前具有 SPFX 的同一批首次发布租户（不是用户，是租户）开始。 在数周内将推出给所有租户。

你将知道它是否已到达给定租户，因为将包上传到应用目录时会显示它有效。 即使无法上传包的租户仍然可以试用 SPFx，它们将仅限于本地和托管的工作台（位于 _layouts/15/workbench.aspx）。

本版本中的更改

  • 实际 SharePoint 框架代码中只有少量更改。 RC0 和 GA 之间的大部分工作与稳定性和长远性相关。 我们明确的目标是，现在创建的部件应在接下来数年内一直有效。 但是对基础服务所做的修复可以继续提供，而不会出现问题，不会加载 7 个不同的次要版本和修补程序版本的框架代码，等等。 对于某些组件，仍有一些需要完善的部分 - 我们将逐步完成。
  • 代码本身的最大变化是，我们将严格的 null 检查标志合并到 SPFX 中，这意味着你也可以在你的项目中启用此标志。 它稍微更改了 API，但只有在你自己启用严格 null 检查时才会注意到。
  • 其他明显的更改位于通过运行 Yeoman 生成器生成的默认代码中。 v1.0.0 是程序包的版本。 现在，我们使用严格的版本 引用 @types/* ， () 不再出现 lodash 错误。
  • 提供功能 XML 支持（以及升级）。 这可用于在“提升”模式下预配 Web 部件所需的字段、内容类型和列表。 我们将对此进行更详细的介绍。
  • 我们已在经典页面上完成序列化格式。 你应删除并重新添加你的 Web 部件。 我们将在短时间内支持旧的序列化格式，然后它将停止工作。
  • require('./config/docs.config.html'); 现在返回 GA 中的对象，而不是像 RC0 这样的字符串

已知问题

我们已暂时从 react 模板中删除 office-ui-fabric-react ，直到我们可以将包调整为不会过时的形式。 我们预计这需要几周的时间。