更新 SharePoint 框架解决方案

已完成

在本单元中,你将了解版本控制在 SharePoint 框架解决方案中的工作原理以及升级现有组件的方式。

了解 SharePoint 框架项目中的版本号

SharePoint 框架项目有三项可进行版本控制的内容。 可以将版本分配给包中的每个组件,例如 Web 组件或扩展。 可以将版本分配给包中的“功能”。 并且可以分配包本身的版本。

组件版本控制用于文档目的。 功能和包的版本控制也用于文档,但有时需要更改版本号才能查看更改的效果。

在更改 SharePoint 框架组件的代码时,需要重新生成、捆绑、打包解决方案并将其重新部署到 SharePoint。 重新部署包时,无论包版本号是否发生更改,所有现有代码文件都会被新文件自动覆盖。

将新的 Web 部件添加到 SharePoint 框架项目时,需要重新生成、捆绑、打包解决方案并将其重新部署到 SharePoint。 重新部署包时,无论包版本号发生更改与否,新的 Web 部件都将立即可用。

向 SharePoint 框架 项目添加新扩展时,无需更改任何版本号,以便在重新生成、捆绑、打包解决方案并将其重新部署到 SharePoint 后,新扩展才可用。

如果未启用租户范围的部署,则需要同时递增包版本和预配与扩展关联的资源的功能或功能的版本号。 然后,需要重新生成、捆绑、打包解决方案并将其重新部署到 SharePoint。 通过递增包版本,可以在添加应用的网站集中更新应用。 递增“功能”版本会指示 SharePoint 需要在应用更新流程中更新“功能”。

更新 SharePoint 框架包版本

包的版本号在 ./config/package-solution.json 文件中进行定义。 SharePoint 包版本显示在租户或网站集应用程序目录中:

SharePoint 包版本的屏幕截图。

如果在不更改版本号的情况下部署更新的 SharePoint 包,则 SharePoint 仍将更新现有的已部署组件运行时文件,包括 JavaScript 捆绑包。

包版本用于文档和触发 SharePoint 应用升级流程。 将新组件添加到项目时,可能需要应用升级过程。

更新 SharePoint 框架组件和递增版本

组件的版本号在组件的清单文件中进行设置。 version 属性设置为字符串,如下图所示:

组件清单版本的屏幕截图。

如果将此值设置为 *,则会使用项目的 package.json 文件中的 version 属性。

通过在每个组件清单中设置版本号,生成的 SharePoint 包中的不同组件可以共享相同的版本号或可以具有唯一的版本号。

更新 package.json 文件中的版本

要在 SharePoint 框架项目中查看的最后一个版本号是项目的 package.json 文件中列出的版本号。 只有当将组件清单文件中的 version 属性设置为 * 而非特定值时,才使用此文件中 version 属性的值。

除了文档之外,package.jsonversion 属性的值对组件没有任何影响。 更改 version 属性不会对组件、包或 SharePoint 的行为造成影响。

虽然其仅用于文档,但每次对组件进行更改时,仍建议递增此版本。

摘要

在本单元中,你了解了版本控制在 SharePoint 框架解决方案中的工作原理以及升级现有组件的方式。