Unity MethodReload: iteraciones más rápidas al evitar la recarga de dominio

  • PublicPublic
  • 22 Oct, 2026
Unity MethodReload: iteraciones más rápidas al evitar la recarga de dominio

Unity ha lanzado MethodReload, un paquete experimental diseñado para eliminar los tiempos de espera asociados a la recarga de dominio durante el desarrollo. Tradicionalmente, modificar el código de juego en el editor provoca un desmontaje completo y una reinicialización del Mono AppDomain, un proceso que puede cortar el impulso creativo. En los dispositivos la situación es aún peor, ya que IL2CPP no admite en absoluto la recarga de dominios, por lo que cada cambio exige recompilar por completo el reproductor. MethodReload resuelve este problema al permitir que los desarrolladores actualicen al instante el cuerpo de métodos concretos, de modo que las largas esperas de compilación se reducen a cuestión de segundos. Esta capacidad ya está disponible para su uso inmediato y busca agilizar el ciclo de iteración, tanto en las pruebas dentro del editor como en dispositivos.

El paquete, que se encuentra en la versión 0.7.0-exp.1, se distribuye en el espacio de nombres com.unity.pipeline y requiere Unity 6.0 o posterior. Para usar esta función, los desarrolladores deben marcar determinados métodos con el atributo [MethodReload] antes de entrar en el modo Play o de compilar un reproductor. Este atributo debe estar presente en tiempo de compilación, porque la lógica de despacho se integra directamente en el bytecode del método. Solo son aptos para este tratamiento los métodos públicos de instancia o estáticos que devuelvan void o IEnumerator; cualquier otra firma se omite durante la compilación y se muestra una advertencia. Este requisito de precompilación garantiza que el entorno de ejecución pueda identificar correctamente qué métodos son candidatos a la actualización en vivo, sin interferir con el flujo de compilación estándar.

Una vez colocados los atributos, el flujo de trabajo consiste en iniciar el MethodReload Watcher, que se encuentra en Project Settings, en los apartados Pipeline y Editor. En el Editor, al entrar en el modo Play se activa el sistema, lo que permite compilar e inyectar en tiempo real cualquier cambio en el código etiquetado. Para las pruebas en dispositivos, los desarrolladores deben compilar un player de desarrollo con el controlador Pipeline de tiempo de ejecución habilitado y conectarse mediante el Profiler o la ventana Console. Cuando se guarda un archivo que contiene un método etiquetado, el Editor lo compila usando las definiciones de preprocesador del player y envía la actualización a todos los dispositivos conectados. Este proceso no requiere reiniciar la aplicación y permite un ciclo de retroalimentación fluido. Además, hay comandos de Unity CLI disponibles para los flujos de trabajo en terminal, que permiten activar recargas de archivos o carpetas concretos directamente desde la línea de comandos.

A pesar de su ventaja en velocidad, MethodReload funciona con limitaciones estrictas. Solo modifica los cuerpos de los métodos etiquetados y deja intactos los puntos de llamada, los campos y la estructura de los tipos. Por lo tanto, los desarrolladores no pueden añadir campos ni clases nuevos mediante una recarga. El intérprete ejecuta un subconjunto de C#, que excluye ciertas funciones complejas, aunque admite primitivos, bucles, delegados y corrutinas. Un analizador de Roslyn incluido en el paquete señala en el IDE la sintaxis no admitida. En los dispositivos con IL2CPP, el intérprete solo puede llamar a las API que ya estén referenciadas en la compilación; si faltan miembros, se producirán excepciones. Además, el código interpretado se ejecuta más despacio que el compilado, una contrapartida que solo afecta a las compilaciones de desarrollo. Las compilaciones de lanzamiento no incluyen el intérprete, de modo que no hay ningún impacto en el rendimiento en producción.

Por dentro, MethodReload combina la interpretación de IL con el tejido de código en tiempo de compilación. Cada método etiquetado contiene un prólogo que consulta un registro para comprobar si hay una sustitución disponible. Si existe, el intérprete ejecuta el nuevo bytecode de IL; si no, se ejecuta el código compilado original. Esta arquitectura permite que IL2CPP compile el intérprete junto con el resto del juego, de modo que pueda ejecutarse en dispositivos sin servidores externos ni puertos abiertos. Aunque las herramientas existentes de la Asset Store ofrecen compatibilidad total con C# en el Editor, fallan en las compilaciones con IL2CPP. MethodReload cubre ese vacío y ofrece una solución viable para iterar en dispositivos. Para los desarrolladores cuyos problemas se concentran sobre todo en el Editor, las herramientas existentes pueden seguir siendo preferibles, pero para quienes apuntan a dispositivos con IL2CPP, MethodReload ofrece un camino único y potente hacia ciclos de desarrollo más rápidos.