Pasos de la migración
Los pasos se ejecutan en este orden. Blueprints se ejecuta el último, así que su resultado de compilación es el estado final del proyecto.
| # | Id del paso | Hecho automáticamente | Informado | Tabla de reglas |
|---|---|---|---|---|
| 1 | project | asociación de motor, plataformas de destino, plugins, reglas .ini | plugins desconocidos en 5.8, funciones de plugins eliminados | plugins.json, config.json |
| 2 | assets | carga y vuelve a guardar cada paquete de /Game más antiguo que el motor | paquetes con errores de carga, censo de versiones | ninguna |
| 3 | input (opcional) | Input Actions, mapping context, eventos de Enhanced Input | teclas combinadas, uso del pin Key, bindings en C++ | ninguna |
| 4 | cascade | sistemas de partículas convertidos, referencias redirigidas | módulos no admitidos, trails/beams, referencias que no puede sustituir | cascade.json |
| 5 | cpp | reglas regex, includes, ajustes de build, archivos de proyecto | coincidencias no automáticas con archivo:línea, comando de build | cpp.json |
| 6 | rendering | reglas .ini del renderizador (reglas móviles en proyectos móviles) | materiales que perdieron expresiones o funciones | config.json |
| 7 | physics | reglas .ini de física, vehículos PhysX re-emparentados a Chaos | ajustes sin mapeo, DestructibleMesh, TireConfig, vehículos simples | config.json, physics.json |
| 8 | blueprints | llamadas obsoletas sustituidas, todos los Blueprints compilados | errores de compilación con texto de corrección, llamadas no automáticas, clases padre eliminadas | bp_nodes.json |
Tablas de reglas
Las reglas están en la carpeta Resources/Rules del plugin, en JSON. Se cargan todas juntas (una tabla defectuosa
detiene la migración con un error en lugar de ejecutar la mitad de las reglas) y las validan las pruebas de
automatización del plugin. Cada regla registra el motivo y la evidencia en el motor que la respalda.
| Archivo | Contenido | Tamaño |
|---|---|---|
plugins.json | plugins de 4.27 eliminados o sustituidos en 5.8, renombrado de plataformas de destino, plugins requeridos por clases movidas | 69 plugins (59 eliminados, 10 sustituidos) |
config.json | reglas .ini: eliminar, renombrar, renombrar sección, establecer, establecer si falta, reemplazar valor | 67 reglas |
cpp.json | reglas por línea de código más reglas de include obligatorio | 122 reglas (93 automáticas, 29 solo informe) |
cascade.json | sufijo del asset convertido y sustituciones de llamadas de spawn | 2 sustituciones de llamada |
physics.json | mapas de clases, miembros, movimiento y ruedas del vehículo heredado a Chaos | 22 parámetros de movimiento + 11 de rueda mapeados |
bp_nodes.json | funciones de Blueprint obsoletas, clases de nodo eliminadas, clases padre eliminadas, pistas de compilación | 141 funciones, 4 clases de nodo |