Programación
Migración de la API anterior
Sustituye de forma controlada los métodos de compatibilidad conservados y preserva los destinos serializados de UnityEvent durante una actualización.
Los métodos antiguos protegen escenas serializadas
V1 conserva algunas entradas antiguas en español y atributos de migración para mantener datos y UnityEvents existentes. Entre ellas están FinalizarObjetivo, ComprobarObjetivo, IniciarCapitulo, SeleccionarCapitulo, métodos de ramas y ReposicionarJugador.
Siguen funcionando, pero el compilador muestra la alternativa. El código nuevo y los nuevos listeners deben utilizar la API inglesa.
Equivalencias principales
| Anterior | Actual | Nota |
|---|---|---|
| Objective.FinalizarObjetivo | Objective.TryComplete | Devuelve aceptación |
| ButtonObjective.ComprobarObjetivo | ButtonObjective.Evaluate | Mantiene opciones incorrectas |
| Chapter.IniciarCapitulo | Chapter.StartChapter | Inicio limpio |
| Chapter.ComprobarObjetivo | Chapter.TryCompleteObjective | El parámetro antiguo de log no forma parte de V1 |
| ChapterManager.SeleccionarCapitulo | ChapterManager.SelectChapter | Para integraciones, mejor TrySelectChapter con ID |
| ActivarRama / DesactivarRama | ActivateBranch / DeactivateBranch | Conserva sobrecargas |
| ReposicionarJugador | RepositionPlayer | Misma búsqueda |
Migrar sin romper escenas
- 1Crea un commit o una copia de escenas y prefabs.
- 2Separa llamadas C# obsoletas de listeners serializados.
- 3Cambia el código y gestiona el resultado actual.
- 4Abre cada UnityEvent y elige el método inglés en el mismo receptor.
- 5Guarda, valida, prueba y revisa el diff serializado.
- 6No elimines localmente la compatibilidad del paquete.
Atributos e identidad estable
FormerlySerializedAs conserva valores de campos renombrados y MovedFrom ayuda a resolver tipos movidos. Quitarlos puede parecer inocuo en una escena nueva y perder datos en escenas de compradores. Forman parte de la seguridad de migración.
Los identificadores son otra superficie: cambiarlos afecta enlaces, transferencias, llamadas y claves aunque todos los campos se deserialicen. Prepara una migración antes de renombrar ID distribuidos.