如何将OJet 7.x应用升级至10.0及获取对应oraclejet.zip包

核心注意点 #

• Oracle JET 从 9.0 版本开始，官方不再提供独立的全量 oraclejet.zip 手动分发包，原有“下载zip解压覆盖项目”的升级方式到10.0版本已完全失效
• 升级前必须完成现有项目全量代码备份，避免自定义配置、业务代码丢失

完整升级操作流程 #

1. 本地环境准备
   • 安装适配的Node.js LTS版本（OJet 10.0 官方支持 Node.js 12.x、14.x 版本，请勿使用未验证的高版本Node避免依赖安装报错）
   • 全局安装对应10.0版本的OJet命令行工具，执行命令：npm install -g @oracle/ojet-cli@10.0.0
2. 旧项目清理与依赖替换
   • 进入原7.x项目根目录，删除旧依赖、缓存、历史打包输出目录：node_modules/、ojet_modules/、dist/、本地存储的旧版OJet zip包
   • 修改项目根目录package.json文件，将所有@oracle/开头的OJet相关依赖版本统一指定为10.0.0，删除手动配置的OJet静态资源引入路径
   • 执行依赖安装命令：npm install
3. 版本兼容迁移
   • 在项目根目录执行自动迁移命令：ojet migrate，命令会自动完成跨版本的配置适配，包括：jetconfig.json字段调整、自定义主题路径迁移、路由配置规则更新
   • 手动排查跨版本废弃API：重点调整不兼容的组件调用逻辑，常见适配项包括：
     • 旧版Knockout绑定组件的调用方式，适配10.0版本的组件API变更
     • 旧版数据提供层（DataProvider）的接口调用逻辑，替换为10.0版本兼容的方法
4. 升级效果验证
   • 启动本地开发服务验证功能：执行ojet serve，确认页面渲染、组件交互、权限逻辑、路由跳转无异常
   • 执行生产打包验证：ojet build --release，确认打包流程无报错、输出资源完整可用

10.0版本资源获取说明 #

• 无官方公开的独立oraclejet.zip分发包可下载，所有OJet 10.0的核心运行资源，会在npm依赖安装阶段自动下载到项目的node_modules/@oracle/目录下，无需单独获取zip包
• 若需离线环境使用对应版本资源，可在联网环境完成依赖安装后，将node_modules/@oracle/全目录拷贝到离线项目的对应路径，效果等价于原有手动解压zip的操作

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