Mixin

Mixin es un marco de rasgo/mixin para Java que utiliza ASM y se conecta al proceso de carga de clases en tiempo de ejecución a través de un conjunto de servicios conectables integrados o proporcionados por el usuario. Los servicios integrados actualmente admiten el sistema LegacyLauncher de Mojang, aunque cpw lo ha desaprobado en favor de ModLauncher, que tiene una mayor extensibilidad y es compatible con Java 8 y posteriores.

Documentación

La documentación principal de Mixin se puede encontrar en la Wiki.

Puede encontrar documentación adicional para funciones y anotaciones individuales en el extenso Javadoc. Para obtener ayuda adicional, utilice el canal #mixin en Sponge Discord Server.

binarios

Los binarios de Mixin están disponibles a través de Jenkins y se publican en los siguientes repositorios de Maven:

• https://repo.spongepowered.org/repository/maven-public/ - SNAPHOTs y compilaciones RELEASE
• https://files.minecraftforge.net/maven/ - Solo versiones de LIBERACIÓN

Estampación

Para manejar tareas de ofuscación, Mixin proporciona un procesador de anotaciones que funciona en tiempo de compilación para generar asignaciones de ofuscación para que las aplique su cadena de herramientas. Si usa Gradle 5 o posterior, los procesadores de anotaciones ya no se cargan automáticamente desde las configuraciones compile y deben especificarse explícitamente mediante las configuraciones annotationProcessor . Para este propósito, Mixin proporciona artefactos "fat jar" que contienen todas las dependencias requeridas a través del clasificador :processor . Por ejemplo, si su compilación usa la dependencia org.spongepowered:mixin:1.2.3 , entonces su configuración de annotationProcessor debe especificar la dependencia org.spongepowered:mixin:1.2.3:processor .

Si está utilizando Mixin en un proyecto de Minecraft Forge, puede utilizar el complemento MixinGradle para simplificar la configuración del procesador de anotaciones Mixin. Proporciona una sintaxis simple para configurar Mixin AP para su proyecto; consulte el archivo README de MixinGradle para saber cómo configurar MixinGradle.

Integración con Eclipse

Al desarrollar utilizando Mixin , puede utilizar el procesador de anotaciones Mixin dentro de Eclipse para proporcionar errores y advertencias sensibles al contexto que le ayudarán a solucionar problemas de sus mixins más fácilmente. Para hacerlo:

1. Ejecute el comando gradle build para generar el jar mixin
2. Abra las propiedades de su proyecto eclipse y navegue hasta Java Compiler -> Annotation Processing -> Factory Path
3. Marque la casilla de verificación Enable project specific settings
4. Haga clic en el botón Add External JARs y seleccione el archivo mixin generado con el sufijo -procesador (pista: debe estar en Mixin/build/libs )
5. Navegue hacia arriba un nivel hasta Java Compiler -> Annotation Processing
6. Marque la casilla de verificación Enable project specific settings
7. Marque la casilla de verificación Enable annotation processing
8. Haga clic en el botón New... junto al cuadro Processor options .

• Establecer Key para reobfSrgFile
• Establezca Value en la ruta completa al archivo mcp-srg.srg (la ubicación del archivo de mapeo varía según la plataforma; si no está seguro de dónde encontrarlo, siga el enlace de Discord a continuación).

9. Haga clic en OK para aplicar los cambios.

Integración con IntelliJ IDEA

La funcionalidad mejorada para trabajar con Mixin en IntelliJ IDEA está disponible a través del complemento Minecraft Development for IntelliJ IDEA desarrollado por DemonWav.

Historial de versiones

Especificar la propiedad minVersion en sus configuraciones es extremadamente importante. El siguiente historial de versiones se puede utilizar para determinar cuándo se introdujeron funciones (y, a veces, cuándo se solucionaron errores importantes) para ayudarle a determinar qué minVersion debe especificar.

Versión	Fecha	Características / Cambios
0.8.3	febrero 2021	Se agregó compatibilidad con el selector de objetivos dinámico y el selector de objetivos @Desc . Selector de destino de patrón agregado Se agregó compatibilidad con cuantificadores más expresivos a los selectores de objetivos explícitos. Renovación y mejoras generales en javadoc
0.8.1 (0.8.2)	septiembre 2020	Revisión para admitir ModLauncher 7.0 Solucionar un problema crítico al resolver miembros ofuscados en interfaces heredadas Actualizado a ASM 7.2
0,8	enero 2020	Actualizado a ASM 6.2 Soporte para ModLauncher Reconocimiento añadido para Java 9 y 10. Soporte para tablas de ofuscación tsrg de ForgeGradle 3+ Las configuraciones ahora pueden heredar de otras configuraciones @Invoke ahora se puede utilizar para exponer constructores Informes de contexto dramáticamente mejorados de excepciones inesperadas del aplicador y del preprocesador, lo que facilita el diagnóstico cuando un agente se ahoga con un código de operación específico. Corrección de errores para Llamar a miembros de mixins de acceso desde dentro del código mixin Manejo incorrecto de espacios en declaraciones de destino explícitas Comportamiento inesperado al intentar redirigir a un ctor Detectar correctamente la superposición de accesores incompatibles e ignorar los válidos (no advertir) Los descriptores de acceso estáticos de la interfaz ahora se ajustan correctamente al destino si la interfaz se carga con clase antes que la clase de destino. La falta de coincidencia de estática para el descriptor de acceso se detectó e informó correctamente en lugar de causar un bloqueo Se corrigieron errores del generador y del inyector relacionados con operandos de doble palabra en la pila que necesitaban DUP2. Se solucionó el problema en el generador LVT plegado desde FabricMC Falla rápidamente cuando un mixin oculta accidentalmente un método final Se corrigió la apariencia de instancias de CallbackInfo perdidas en los LVT del inyector de captura local. Se eliminó la dependencia de Apache Commons-IO Se eliminó el ASM sombreado renombrado Resolución mejorada de variables locales para inyecciones de captura de variables locales @Coerce en inyectores de devolución de llamadas y redireccionamientos ahora puede resolver superinterfaces, incluidas interfaces mixtas
0.7.11	julio 2018	Correcciones para 3 errores menores: manejo de maxShiftBy arreglado, búsqueda permisiva BeforeInvoke mejorada, deshabilita la combinación de firmas genéricas a menos que el descompilador esté activo.
0.7.10	junio 2018	Registrar un error cuando una clase mixin está sujeta a restricciones del cargador de clases
0.7.9	abril 2018	Permita que ciertos inyectores se dirijan a métodos de mezcla.
0.7.8	abril 2018	Corrección de errores para la validación de declaraciones de miembros, redireccionamientos de ctor no salvajes y errores internos en el generador de subclases Args
0.7.7	marzo 2018	Correcciones para el manejo de activadores de mensajes de registro para la fase INIT y errores cuando se ejecuta con configuraciones de registrador inesperadas Agregue advertencias para puntos de corte no válidos y reducción de la conversión en los controladores ModifyConstant
0.7.6	noviembre 2017	Arreglar la herencia para las propiedades del sistema de cadenas.
0.7.5	octubre 2017	Agregue soporte para @Coerce en inyectores de redireccionamiento.
0.7.4	septiembre 2017	Se agregó la anotación @Dynamic para decorar elementos mixin con objetivos inyectados dinámicamente.
0.7.3	agosto 2017	Cambios internos para brindar soporte a modlauncher y java 9
0.7.2	agosto 2017	Agregue un generador de perfiles para inspeccionar el rendimiento de la mezcla.
0.7.1	agosto 2017	Correcciones y mejoras al Mixin AP, arreglando el manejo de matrices multidimensionales y resolviendo métodos en superclases de tipos derivados de clases ofuscadas. Agregue reasignación de refmap en tiempo de ejecución para admitir el uso de dependencias de deobfCompile con diferentes versiones de mapeo.
0,7	julio 2017	Todos los binarios oficiales ahora están firmados. Actualice a ASM 5.2 Agregar soporte para clases internas en Mixins Los inyectores ahora pueden tener múltiples objetivos explícitos Las anotaciones @At ahora pueden tener su propia identificación. Agregue soporte para usar @Overwrite en métodos no ofuscados como una forma de verificar que existe un objetivo de sobrescritura. Mejorar el soporte para puentes sintéticos, detectar métodos de puentes conflictivos Detectar y advertir de valores excesivos de At.Shift.BY ModifyConstant ahora puede admitir múltiples sectores Agregue permiso a los inyectores para detectar sobreinyección
0.6.15	julio 2017	Agregue soporte para múltiples constantes en ModifyConstant Agregue CONSTANTE como punto de inyección de uso general Agregue soporte para redirigir el acceso a la longitud de la matriz en redirectores de campo
0.6.14	julio 2017	Agregue soporte para usar @Coerce en tipos de referencia en Callback Injectors para admitir tipos derivados.
0.6.13	julio 2017	Agregue soporte para ajustar la visibilidad de los métodos de sobrescritura para que coincidan con la clase de destino. Soluciona problemas en los que un Access Transformer ha modificado un método de clase de destino para tener una mayor visibilidad.
0.6.12	junio 2017	Agregar argumento de segmento a @ModifyConstant Agregue el inyector @ModifyArgs que puede cambiar múltiples argumentos de llamada a métodos con un solo controlador.
0.6.11	junio 2017	Se corrigió el manejo de @Unique cuando existe el mismo método único en más de un mixin dirigido a la misma clase. Se corrige el manejo de lambdas fusionadas para que las lambdas de mixins se apliquen correctamente cuando ya existen lambdas en la clase de destino (tanto en la clase original como cuando se aplican en mixins anteriores).
0.6.10	mayo 2017	(0.6.9) Solución menor para eliminar la dependencia del asistente obsoleto Respetar la reasignación en Mixin para @At contenido Requerir que los redirectores que ocurren antes de la llamada al superctor sean estáticos
0.6.8	febrero 2017	Permitir que @ModifyConstant enlace el cero implícito en las comparaciones
0.6.7	enero 2017	Agregue soporte para @Redirect en el acceso a la matriz
0.6.6	enero 2017	Permitir métodos estáticos en mixins de acceso en Java 8 y superiores
0.6.5	enero 2017	Agregar soporte para cortes de inyector
0.6.4	enero 2017	Permitir descriptores en NUEVOS puntos de inyección
0.6.3	diciembre 2016	Soporte de SourceDebugExtension
0.6.2	diciembre 2016	Agregue soporte para mixins @Pseudo (objetivo virtual)
0.6.1	noviembre 2016	Procesar anotaciones de implementos suaves en el AP
0,6	octubre 2016	Soporte de accesorios Mixin
0.5.17	octubre 2016	Permitir que los inyectores @Redirect apunten a NUEVOS códigos de operación para la redirección del constructor
0.5.16	octubre 2016	Mejoras en el procesador de anotaciones. Admite sombras y anulaciones en mixins de múltiples objetivos Admite entornos de ofuscación conectables en AP
0.5.14	septiembre 2016	Agregar soporte de descompilación asíncrona
0.5.13	septiembre 2016	Agregar estrategia alternativa para inyectar inicializadores de campo
0.5.10	junio 2016	Soporte @Unique en campos
0.5.9	junio 2016	Fallo difícil si un objetivo de mixin requerido ya estaba transformado
0.5.8	junio 2016	Restricciones de soporte en inyectores.
0.5.7	junio 2016	Agregar anotación @Unique
0.5.6	mayo de 2016	Cambios de entorno, entorno de soporte a través de agentes.
0.5.5	abril 2016	Agregue el inyector @ModifyConstant Agregar anotación @Debug Permitir controladores @ModifyArg estáticos en métodos de instancia
0.5.4	abril 2016	Los manejadores de errores también reciben errores de preparación de mixin
0.5.3	febrero 2016	Conformar inyectores Habilite hotswapper automáticamente si el agente está activo Solucionar múltiples problemas con genéricos en procesadores de anotaciones
0.5.2	febrero 2016	ID de soporte en inyectores Prioridad de soporte para inyectores.
0.5.1	febrero 2016	Revise los inyectores, los inyectores de todos los mixins ahora escanean antes de que se procese cualquier inyector. Hace que los inyectores sean más deterministas.
0.4.19	febrero 2016	Agregue soporte para @Redirect en campos y métodos
0.4.18	febrero 2016	Agregar el inyector @ModifyLocal
0.4.17	enero 2016	Admite ExtraSRG en el procesador de anotaciones Incluir constructores en el mapa de referencia. Agregue la anotación @Mutable para suprimir las advertencias @Final
0.4.15	enero 2016	Incluir objetivos suaves en refmap
0.4.14	enero 2016	Agregar soporte para mixins de interfaz
0.4.13	enero 2016	Agregar anotación @Final
0.4.11	enero 2016	Agregue soporte para agrupación de inyectores y valor requerido en toda la configuración
0.4.10	diciembre 2015	Soporte de reasignación en tiempo de ejecución usando RemapperChain Ignorar transformadores de clase decorados con @Resource Admite la validación de @reason y @author en sobrescrituras
0.4.8	diciembre 2015	Procesador de anotaciones mejorado para soportar MixinGradle Admite múltiples entornos de ofuscación de objetivos en refmaps
0.4.6	septiembre 2015	Agregue la fase INIT para manejar el inicio temprano de FML Agregar soporte para lambdas en mixins Agregue soporte para el reemplazo de código activo en mixins Mejorar el soporte de funciones de Java 8
0.4.4	julio 2015	Agregar restricciones para sobrescrituras
0.4.3	mayo 2015	Agregar punto de inyección INVOKE_ASSIGN Admite devoluciones de llamadas de inyectores sin argumentos Admite la coerción de tipos de parámetros covariantes en devoluciones de llamada Soporte para truncar controladores de inyectores de captura local Descompilación en tiempo de ejecución de clases exportadas usando fernflower Agregar filtro de exportación
0,4	mayo 2015	Sombree el paquete de ASM reubicado y utilícelo en todas partes
0.3.2	abril 2015	Soporte de manejador de errores
0.3.1	abril 2015	Fusión de anotaciones Permitir que los métodos de sobrescritura tengan alias
0.3	marzo 2015	Entornos implementados Soporte de método intrínseco Captura de variables locales habilitada Soporte de alias
0,2	marzo 2015	Se agregó soporte para supermixin (mixins que heredan de otros mixins)
0.1	enero 2015	Soporte básico de mezcla Soporte básico para inyectores Procesador de anotaciones