` | `` | | 必填/只读 | `attrs="{'required': [...]}"` | `required="condition"` | | Python 最低版本 | 3.10 | 3.10+ | | JS 模块 | 旧版 `define(['web.core'])` | ES module `import` 语法 | ### Odoo 15 → 16 | 主题 | 旧版 (v15) | 新版 (v16) | |---|---|---| | 网站发布标志 | `website_published = True` | `is_published = True` | | 邮件别名 | 公司上的 `alias_domain` | 迁移至 `mail.alias.domain` 模型 | | 报表渲染 | `_render_qweb_pdf()` | `_render_qweb_pdf()`（相同，但签名已变更） | | 会计分录 | `account.move.line` 分组 | 行聚合规则已更新 | | 邮件线程 | `mail_thread_id` | 已废弃；使用 `message_ids` | ## 示例 ### 示例 1：将 `attrs` 可见性迁移至 Odoo 17 ```xml ``` ### 示例 2：迁移 Chatter 块 ```xml

``` ### 示例 3：迁移 website_published 标志（v15 → v16） ```python # v15 record.website_published = True # v16+ record.is_published = True ``` ## 最佳实践 - ✅ **推荐**：每个版本推送生产前，用 `--update=your_module` 测试 - ✅ **推荐**：使用官方 [Odoo 升级指南](https://upgrade.odoo.com/) 获取自动预升级分析报告 - ✅ **推荐**：社区模块需检查 OCA 迁移说明和模块的 `HISTORY.rst` - ✅ **推荐**：迁移后运行 `npm run validate`，尽早发现 manifest 或 frontmatter 问题 - ❌ **避免**：跳过中间版本——必须按 v14→v15→v16→v17 顺序，不可跳跃 - ❌ **避免**：忘记更新 `__manifest__.py` 中的 `version`（如 `17.0.1.0.0`） - ❌ **避免**：假设 OCA 模块已就绪——需检查其 GitHub 分支是否支持目标版本 ## 限制 - 仅覆盖 **v14 至 v17**——不涉及 v13 及更早版本（manifest 前时代的模块结构完全不同） - **Odoo.sh 自动升级**路径有额外步骤，此处未覆盖；请参阅 Odoo.sh 文档 - **企业版专属模块**（如 `account_accountant`、`sign`）可能存在未记录的破坏性变更；需在预发环境使用企业版许可证测试 - JavaScript OWL 组件迁移（v15 Legacy → v16 OWL）是复杂话题，本技能未完全覆盖