用途:帮助开发者将 Odoo 自定义模块从旧版本迁移到新版本,系统梳理各版本间的破坏性变更、废弃方法、字段重命名与视图语法变化。
主要能力:按源版本与目标版本给出破坏性变更清单及修改前后代码对照;生成针对模块功能的迁移检查表;说明版本间差异。已列出的变更包括:v16→v17 的视图可见性由 attrs="{'invisible': [...]}" 改为 invisible="condition",必填/只读由 attrs 改为 required/readonly 内联表达式,Chatter 由 <div class="oe_chatter"> 改为 <chatter/>,JS 由旧式 define(['web.core']) 改为 ES module import;v15→v16 的 website_published 改为 is_published,公司上的 alias_domain 移至 mail.alias.domain 模型,mail_thread_id 废弃改用 message_ids。
使用方式:提及 @odoo-migration-helper,指定源版本与目标版本并粘贴模块代码,即可获得变更清单与修复建议,再按检查表验证。
最佳实践:每个版本先用 --update=your_module 测试;参考官方 Odoo Upgrade Guide 获取自动预升级分析报告;查看 OCA 迁移说明与模块 HISTORY.rst;迁移后运行 npm run validate;按 v14→v15→v16→v17 顺序逐级迁移,不要跳版本;更新 manifest.py 中的版本号(如 17.0.1.0.0);确认 OCA 模块已有目标版本分支。
限制:仅覆盖 v14 至 v17,不涉及 v13 及更早版本;Odoo.sh 自动升级路径的额外步骤未涵盖;企业版专有模块可能存在未记录的破坏性变更,需在带企业版许可的预发布环境测试;JavaScript OWL 组件迁移(v15 Legacy → v16 OWL)未完整覆盖。