Odoo Migration Helper

Visão Geral

Migrar módulos Odoo entre versões principais exige cuidado com mudanças de API, métodos depreciados, campos renomeados e nova sintaxe de visualização. Esta habilidade guia você pelo processo de migração de forma sistemática, cobrindo as mudanças mais comuns entre versões.

Quando Usar Esta Habilidade

• Atualizando um módulo customizado do Odoo 14/15/16 para uma versão mais nova.
• Obtendo uma lista de verificação de coisas para checar antes de rodar odoo-upgrade.
• Corrigindo avisos de depreciação após uma atualização de versão.
• Entendendo o que mudou entre duas versões específicas do Odoo.

Como Funciona

1. Ativar: Mencione @odoo-migration-helper, especifique suas versões de origem e destino, e cole o código do seu módulo.
2. Analisar: Receba uma lista de mudanças críticas com correções de código antes/depois.
3. Validar: Obtenha uma lista de verificação de migração específica para as funcionalidades do seu módulo.

Principais Mudanças de Migração por Versão

Odoo 16 → 17

Odoo 15 → 16

Exemplos

Exemplo 1: Migrar visibilidade attrs para Odoo 17

<!-- v16 — domain-based attrs -->
<field name="discount" attrs="{'invisible': [('product_type', '!=', 'service')]}"/>
<field name="discount" attrs="{'required': [('state', '=', 'sale')]}"/>

<!-- v17 — inline Python expressions -->
<field name="discount" invisible="product_type != 'service'"/>
<field name="discount" required="state == 'sale'"/>

Exemplo 2: Migrar bloco Chatter

<!-- v16 -->
<div class="oe_chatter">
    <field name="message_follower_ids"/>
    <field name="activity_ids"/>
    <field name="message_ids"/>
</div>

<!-- v17 -->
<chatter/>

Exemplo 3: Migrar flag website_published (v15 → v16)

# v15
record.website_published = True

# v16+
record.is_published = True

Melhores Práticas

• ✅ Fazer: Testar com --update=your_module em cada versão antes de enviar para produção.
• ✅ Fazer: Usar o Guia de Upgrade Oficial do Odoo para obter um relatório de análise pré-upgrade automatizado.
• ✅ Fazer: Verificar as notas de migração da OCA e o HISTORY.rst do módulo para módulos da comunidade.
• ✅ Fazer: Rodar npm run validate após a migração para identificar problemas de manifesto ou frontmatter precocemente.
• ❌ Não fazer: Pular versões intermediárias — ir v14→v15→v16→v17 sequencialmente; nunca pular.
• ❌ Não fazer: Esquecer de atualizar version em __manifest__.py (ex: 17.0.1.0.0).
• ❌ Não fazer: Assumir que módulos OCA estão prontos para migração; verificar o branch GitHub deles para a versão de destino.

Limitações

• Cobre apenas de v14 a v17 — não aborda v13 ou versões anteriores (a era pré-manifesto tem estrutura de módulo fundamentalmente diferente).
• O caminho de upgrade automatizado do Odoo.sh tem passos adicionais não cobertos aqui; consulte a documentação do Odoo.sh.
• Módulos específicos da Enterprise (ex: account_accountant, sign) podem ter mudanças críticas não documentadas; teste em um ambiente de staging com licença Enterprise.
• Migração de componentes JavaScript OWL (v15 Legado → v16 OWL) é um tópico complexo não totalmente coberto por esta habilidade.