odoo-upgrade（奥多升级）

Odoo Upgrade Assistant v5.0

When to Use

Activate when:

• Upgrading Odoo modules between versions (14-19)
• Fixing version compatibility errors
• Migrating themes or custom modules
• Resolving RPC service errors in frontend
• Converting XML views (tree->list, search groups)
• Updating SCSS variables for Odoo 18/19 themes
• Fixing portal view XPath inheritance errors
• Migrating JavaScript from OWL v1 to v2

Upgrade Workflow

1. Analyze - Read __manifest__.py, identify source version, scan all files
2. Backup - Create timestamped backup before changes
3. Pre-check - Run scripts/cli.py precheck <path> --target <version> to identify all issues
4. Transform - Apply transforms in order: manifest, XML, Python, JS, SCSS
5. Validate - Run scripts/cli.py validate <path> to check syntax
6. Test - Install module: python -m odoo -d DB -i MODULE --stop-after-init

XML/View Transformations

Tree to List (Odoo 19)

<!-- Tags -->        <tree> -> <list>,  </tree> -> </list>
<!-- view_mode -->   tree,form -> list,form
<!-- XPath -->       //tree -> //list
<!-- Remove -->      edit="1" attribute

Search Views (Odoo 19)

Remove <group> tags - place filters at root level. Add <separator/> before group_by filters.

Kanban Templates (Odoo 19)

t-name="kanban-box" -> t-name="card". Remove js_class="crm_kanban".

Cron Jobs (Odoo 19)

Remove <field name="numbercall"> - field no longer exists.

Form View Context (Odoo 19)

active_id -> id in context expressions.

Snippet Options (Odoo 19)

Remove templates inheriting website.snippet_options - system redesigned.

Attrs to Inline (Odoo 18/19)

attrs="{'invisible': [('state','=','draft')]}" -> invisible="state == 'draft'"

Python API Migrations

Slug/Unslug (Odoo 18+)

# Old: from odoo.addons.http_routing.models.ir_http import slug
# New: use request.env['ir.http']._slug(value)

URL For (Odoo 19)

# Old: from odoo.addons.http_routing.models.ir_http import url_for
# New: self.env['ir.http']._url_for('/path')

Controller Type (Odoo 19)

type='json' -> type='jsonrpc' in @http.route decorators.

View Mode (Odoo 19)

'view_mode': 'tree' -> 'view_mode': 'list' in Python dicts.

JavaScript/OWL Migrations

RPC Service (Odoo 19)

RPC service is NOT available in frontend/public components. Replace useService("rpc") with a _jsonRpc helper method using the fetch API with CSRF token handling.

OWL Lifecycle Hooks (Odoo 18+)

Theme SCSS Variables (Odoo 19)

Use $o-theme-* prefixed variables instead of bare Bootstrap names:

• $headings-font-weight -> $o-theme-headings-font-weight
• $font-size-base -> $o-theme-font-size-base

Color palettes must include 'menu', 'footer', 'copyright' assignments:

$o-color-palettes: map-merge($o-color-palettes, (
    'my_theme': (
        'o-color-1': #124F81,
        'menu': 1,
        'footer': 4,
        'copyright': 5,
    ),
));

Portal View XPath Migration (Odoo 19)

Sale portal templates restructured with named selectors:

Headers: th[@id='product_qty_header'], th[@id='product_unit_price_header'], th[@id='product_discount_header'], th[@id='taxes_header'], th[@id='subtotal_header']

Body: tr[@name='tr_product'], td[@name='td_product_name'], td[@name='td_product_quantity'], td[@name='td_product_priceunit'], td[@name='td_product_discount'], td[@name='td_product_taxes'], td[@name='td_product_subtotal']

Mail Template Migration (Odoo 19)

Remove env parameter from format helpers:

<!-- Old --> format_datetime(env, object.date_start)
<!-- New --> format_datetime(object.date_start)

XML entity encoding - use numeric references: © -> ©, ` -> , — -> —`

Bootstrap 4 to 5 Class Migration

Data Migration Scripts

Place migration scripts under module/migrations/VERSION/:

• pre-migrate.py - Before ORM update (use raw SQL only)
• post-migrate.py - After ORM update (can use env/ORM)
• end-migrate.py - After all modules updated (cleanup)

Each must define def migrate(cr, version): and guard with if not version: return.

Common patterns:

With openupgradelib: rename_fields(), rename_models(), rename_xmlids(), rename_columns(), logged_query().

Common Errors Quick Reference

Version-Specific Notes

Odoo 14 to 15

Bootstrap 4.x -> 5.x, t-use-call removed, payment provider API changes, left/right -> start/end

Odoo 15 to 16

Bootstrap 5.1.3 standardized, web framework reorg, OWL v1 adoption begins

Odoo 16 to 17

OWL v1 fully adopted, widget system changes, publicWidget API stabilization

Odoo 17 to 18

OWL v1 -> v2 starts, minor XML changes, snippet group system introduced

Odoo 18 to 19

Major frontend overhaul: RPC service removed, snippet system overhauled, kanban-box->card, search banned, tree->list, portal templates restructured, mail template helpers changed, cron numbercall removed

References

• Odoo 18 to 19 Patterns
• Error Catalog