Etapas da migração
As etapas são executadas nesta ordem. Blueprints roda por último, então o resultado da compilação dela é o estado final do projeto.
| # | Id da etapa | Feito automaticamente | Relatado para você | Tabela de regras |
|---|---|---|---|---|
| 1 | project | associação de engine, plataformas-alvo, plugins, regras .ini | plugins desconhecidos no 5.8, recursos de plugins removidos | plugins.json, config.json |
| 2 | assets | carrega e grava de novo cada pacote de /Game mais antigo que a engine | pacotes com erro de carregamento, censo de versões | nenhuma |
| 3 | input (opcional) | Input Actions, mapping context, eventos Enhanced Input | teclas combinadas, uso do pino Key, bindings em C++ | nenhuma |
| 4 | cascade | sistemas de partículas convertidos, referências reapontadas | módulos não suportados, trails/beams, referências que não consegue substituir | cascade.json |
| 5 | cpp | regras regex, includes, configurações de build, arquivos de projeto | ocorrências não automáticas com arquivo:linha, comando de build | cpp.json |
| 6 | rendering | regras .ini do renderizador (regras mobile em projetos mobile) | materiais que perderam expressões ou funções | config.json |
| 7 | physics | regras .ini de física, veículos PhysX re-parentados para Chaos | ajustes sem mapeamento, DestructibleMesh, TireConfig, veículos simples | config.json, physics.json |
| 8 | blueprints | chamadas obsoletas substituídas, todos os Blueprints compilados | erros de compilação com texto de correção, chamadas não automáticas, classes pai removidas | bp_nodes.json |
Tabelas de regras
As regras ficam na pasta Resources/Rules do plugin, em JSON. Elas são carregadas todas juntas (uma tabela com
defeito interrompe a migração com um erro, em vez de executar metade das regras) e validadas pelos testes de
automação do plugin. Cada regra registra o motivo e a evidência na engine que a justifica.
| Arquivo | Conteúdo | Tamanho |
|---|---|---|
plugins.json | plugins do 4.27 removidos ou substituídos no 5.8, renomeação de plataformas-alvo, plugins exigidos por classes movidas | 69 plugins (59 removidos, 10 substituídos) |
config.json | regras .ini: remover, renomear, renomear seção, definir, definir se ausente, substituir valor | 67 regras |
cpp.json | regras por linha de código mais regras de include obrigatório | 122 regras (93 automáticas, 29 só de relatório) |
cascade.json | sufixo do asset convertido e substituições de chamadas de spawn | 2 substituições de chamada |
physics.json | mapas de classes, membros, movimento e rodas do veículo legado para o Chaos | 22 parâmetros de movimento + 11 de roda mapeados |
bp_nodes.json | funções de Blueprint obsoletas, classes de nó removidas, classes pai removidas, dicas de compilação | 141 funções, 4 classes de nó |