如何在SAP Build(原BAS)、VSC中更改UI5版本及本地预览Fiori应用验证

在SAP Build（原Business Application Studio）中更改UI5版本 #

针对不同类型的项目，操作略有区别：

基于UI5 Tooling的项目 #

• 打开项目根目录的package.json文件，找到devDependencies下的UI5相关依赖（比如@ui5/cli、@ui5/fs），直接把版本号改成你需要的目标版本
• 打开终端运行npm install（或yarn install）更新依赖
• 如果项目依赖了SAPUI5的基础库（比如sap.m、sap.ui.core），打开ui5.yaml，在framework节点里修改version值：

  framework:
    name: SAPUI5
    version: "1.120.0" # 替换成你要测试的版本号
    libraries:
      - name: sap.m
      - name: sap.ui.core
      # 其他用到的库
  

Fiori模板生成的项目 #

• 打开package.json，找到@sap/ux-ui5-tooling这类Fiori相关依赖，修改其版本（该工具会关联对应的UI5核心版本）
• 运行npm install更新依赖
• 若要精确指定UI5版本，直接修改ui5.yaml里framework节点的version字段即可

在Visual Studio Code（VSC）中更改UI5版本 #

VSC里的操作和本地项目完全一致，核心就是修改项目配置文件：

• 打开package.json，更新devDependencies下所有UI5相关依赖的版本号
• 终端执行npm install完成依赖更新
• 打开ui5.yaml，调整framework中的version到目标版本
• 如果你用的是Fiori Elements项目，建议同步修改webapp/manifest.json里sap.ui5/dependencies/minUI5Version的值，避免版本不一致的警告

在本地构建预览环境中更改UI5版本 #

除了修改项目配置文件做持久化变更，还可以临时切换版本快速测试：

临时指定版本预览 #

用UI5 CLI启动预览时，直接通过参数指定版本，不用改项目文件：

ui5 serve --framework-version 1.119.0

这个命令会临时拉取指定版本的UI5库启动服务，适合快速对比不同版本的表现

持久化修改本地构建版本 #

• 按前面的步骤修改ui5.yaml的framework版本和package.json的依赖版本
• 运行npm install更新依赖
• 执行ui5 build重新构建项目，之后启动预览就会用新的UI5版本

注意事项 #

• 跨大版本切换时（比如从1.110.x到1.120.x），可能会有API废弃或变更的情况，记得检查浏览器控制台的报错
• Fiori Elements项目要注意UI5版本和Fiori Elements的兼容性，避免出现渲染异常
• 测试不同版本前，建议清理依赖环境（删除node_modules和package-lock.json后重新安装），避免缓存影响

内容的提问来源于stack exchange，提问作者TechAffinate