Solución de problemas y referencia
Versionado y migración
Planifica actualizaciones seguras teniendo en cuenta los ID estables, los UnityEvents serializados, los métodos de compatibilidad, las copias y las notas de versión.
ID y UnityEvents son contratos de datos
Los identificadores intervienen en enlaces, API, transferencias y persistencia. Los receptores y métodos de UnityEvent se guardan en escenas y prefabs. Los atributos de migración conservan tipos y campos. Un cambio de código compatible puede romper contenido si modifica estas superficies.
Proceso de actualización segura
- 1Lee notas y requisitos antes de cambiar Unity.
- 2Guarda Assets, Packages y ProjectSettings y anota la versión.
- 3Importa en una copia o rama y espera una compilación limpia.
- 4Abre escenas representativas, Validation, enlaces y UnityEvents.
- 5Prueba persistencia, fallo, transferencia, Reset e integraciones.
- 6Revisa los diffs serializados.
Migrar los métodos antiguos
Los métodos obsoletos protegen código y listeners durante 1.x. Cambia primero las llamadas C# y gestiona los nuevos resultados. Después vuelve a elegir el método inglés en cada UnityEvent y guarda su propietario. No elimines atributos o wrappers del paquete.
Consulta Migración de la API anterior.
Planificar cambios de contenido
| Cambio | Riesgo | Plan |
|---|---|---|
| Title | Bajo | Revisar texto |
| ID de Chapter/Objective | Enlaces, llamadas y progreso rotos | Migración explícita |
| Eliminar contenido | Claves huérfanas | Migración del proyecto |
| Cambiar ámbito/perfil | El progreso parece ausente | Nuevo espacio o migrar |
| Cambiar método de UnityEvent | Listener perdido | Reenlazar antes de retirar compatibilidad |