如何测试面向SharePoint 2019开发的SPFx应用程序?
方案1:本地SPFx v1.4.1环境离线调试
- 先卸载全局安装的高版本SPFx脚手架:
npm uninstall -g @microsoft/generator-sharepoint - 安装SharePoint 2019支持的最高版本SPFx脚手架:
npm install -g @microsoft/generator-sharepoint@1.4.1 - 提前切换Node.js版本到8.x,这是SPFx v1.4.1唯一兼容的Node.js版本,更高版本会出现依赖安装、运行报错
- 如果现有项目是基于高版本SPFx开发的,需要统一降级所有
@microsoft/sp-前缀的依赖版本到1.4.1,删除node_modules文件夹和package-lock.json文件后重新执行npm install修复依赖 - 调试时直接执行
gulp serve,启动本地SPFx工作台即可测试React应用的所有功能,不需要连接任何SharePoint环境,大部分SPFx上下文能力、页面交互逻辑都可以在本地工作台完成验证
方案2:API兼容适配+本地数据模拟
- SPFx v1.4.1不支持后续版本新增的封装Graph API、列表操作新接口,所有调用SharePoint能力的逻辑优先使用SPFx v1.4.1支持的REST API实现,避免调用高版本独有接口
- 在config/serve.json中配置模拟的SharePoint上下文参数、列表返回数据,完全对齐SharePoint 2019的接口返回结构,不需要远程连接就可以验证数据交互逻辑
方案3:本地SharePoint 2019虚拟机全量验证
- 如果需要100%还原客户环境的运行效果,可以自行搭建SharePoint 2019本地虚拟机,微软提供了预装完整环境的评估版镜像,可免费使用180天,足够完成全量测试
- 打包应用时执行
gulp package-solution --ship生成sppkg安装包,上传到本地虚拟机的应用目录部署后,即可完全模拟客户环境的运行状态
注意事项
- SPFx v1.4.1默认适配React 15.x版本,不要在项目中引入更高版本的React相关依赖,避免出现渲染兼容问题
- 不要使用高版本SPFx新增的项目配置、打包参数,避免生成的安装包无法在SharePoint 2019环境中正常部署
内容的提问来源于stack exchange,提问作者Martijn Ebbens
相关产品推荐
相关产品推荐

