Mixin

Mixin est un framework trait/mixin pour Java utilisant ASM et s'intégrant au processus de chargement de classes d'exécution via un ensemble de services intégrés ou fournis par l'utilisateur enfichables. Les services intégrés prennent actuellement en charge le système LegacyLauncher de Mojang, bien qu'il soit obsolète au profit de ModLauncher par cpw, qui a une plus grande extensibilité et prend en charge Java 8 et versions ultérieures.

Documentation

La documentation principale de Mixin se trouve dans le Wiki.

Une documentation supplémentaire sur les fonctionnalités et annotations individuelles peut être trouvée dans le Javadoc complet. Pour une aide supplémentaire, utilisez le canal #mixin sur le serveur Sponge Discord.

Binaires

Les binaires Mixin sont disponibles via Jenkins et sont publiés dans les référentiels Maven suivants :

• https://repo.spongepowered.org/repository/maven-public/ - Versions SNAPHOT et RELEASE
• https://files.minecraftforge.net/maven/ - Versions RELEASE uniquement

Outillage

Pour gérer les tâches d'obscurcissement, Mixin fournit un processeur d'annotation qui fonctionne au moment de la compilation pour générer des mappages d'obscurcissement que votre chaîne d'outils doit appliquer. Si vous utilisez Gradle 5 ou version ultérieure, les processeurs d'annotation ne sont plus automatiquement chargés à partir des configurations compile et doivent être spécifiés explicitement via les configurations annotationProcessor . A cet effet, Mixin fournit des artefacts "fat jar" contenant toutes les dépendances requises via le classificateur :processor . Par exemple, si votre build utilise la dépendance org.spongepowered:mixin:1.2.3 alors votre configuration annotationProcessor doit spécifier la dépendance org.spongepowered:mixin:1.2.3:processor .

Si vous utilisez Mixin dans un projet Minecraft Forge, le plugin MixinGradle peut être utilisé pour simplifier la configuration du processeur d'annotation Mixin. Il fournit une syntaxe simple pour configurer le Mixin AP pour votre projet, voir le README MixinGradle pour savoir comment configurer MixinGradle.

Intégration avec Eclipse

Lors du développement à l'aide de Mixin , vous pouvez utiliser le processeur d'annotation Mixin dans Eclipse pour fournir des erreurs et des avertissements contextuels afin de vous aider à dépanner plus facilement vos mixins. Pour ce faire :

1. Exécutez la commande gradle build pour générer le pot mixin
2. Ouvrez les propriétés de votre projet Eclipse et accédez à Java Compiler -> Annotation Processing -> Factory Path
3. Cochez la case Enable project specific settings
4. Cliquez sur le bouton Add External JARs et sélectionnez le pot de mixage généré avec le suffixe -processor (indice : il devrait être dans Mixin/build/libs )
5. Naviguez d'un niveau vers Java Compiler -> Annotation Processing
6. Cochez la case Enable project specific settings
7. Cochez la case Enable annotation processing
8. Cliquez sur le bouton New... à côté de la zone Processor options .

• Définir Key sur reobfSrgFile
• Définissez Value sur le chemin complet du fichier mcp-srg.srg (l'emplacement du fichier de mappage varie selon la plate-forme, si vous ne savez pas où le trouver, veuillez suivre le lien Discord ci-dessous).

9. Cliquez sur OK pour appliquer les modifications

Intégration avec IntelliJ IDEA

Une fonctionnalité améliorée pour travailler avec Mixin dans IntelliJ IDEA est disponible via le plugin Minecraft Development for IntelliJ IDEA développé par DemonWav.

Historique des versions

Spécifier la propriété minVersion dans vos configurations est extrêmement important. L'historique des versions suivant peut être utilisé pour déterminer quand les fonctionnalités ont été introduites (et parfois quand des bogues majeurs sont corrigés) afin de vous aider à déterminer quelle minVersion vous devez spécifier.

Version	Date	Fonctionnalités / Modifications
0.8.3	Février 2021	Ajout de la prise en charge du sélecteur de cible dynamique et du sélecteur de cible @Desc Sélecteur de cible de modèle ajouté Ajout d'un support de quantificateur plus expressif aux sélecteurs de cibles explicites Lifting et améliorations globales de javadoc
0.8.1 (0.8.2)	septembre 2020	Correctif pour la prise en charge de ModLauncher 7.0 Correction d'un problème critique lié à la résolution des membres obscurcis dans les interfaces héritées Mis à jour vers ASM 7.2
0,8	janvier 2020	Mis à jour vers ASM 6.2 Prise en charge de ModLauncher Ajout de la reconnaissance pour Java 9 et 10 Prise en charge des tables d'obscurcissement tsrg de ForgeGradle 3+ Les configurations peuvent désormais hériter d'autres configurations @Invoke peut désormais être utilisé pour exposer les constructeurs Rapport contextuel considérablement amélioré sur les exceptions inattendues de l'applicateur et du préprocesseur, ce qui facilite le diagnostic lorsqu'un agent s'étouffe avec un opcode spécifique. Corrections de bugs pour Appel des membres des mixins accesseurs depuis le code du mixin Gestion incorrecte des espaces dans les déclarations de cible explicites Comportement inattendu lors de la tentative de redirection d'un cteur Détecter correctement le chevauchement d'accesseurs incompatibles et ignorer ceux valides (ne pas avertir) Les accesseurs statiques d'interface se conforment désormais correctement à la cible si l'interface est chargée en classe avant la classe cible Incompatibilité statique pour l'accesseur correctement détectée et signalée au lieu de provoquer un crash Correction des erreurs du générateur et de l'injecteur liées aux opérandes de mots doubles sur la pile nécessitant DUP2 Correction d'un problème dans le générateur LVT intégré à partir de FabricMC Échec rapide lorsqu'une méthode finale est accidentellement masquée par un mixin Correction de l'apparence des instances CallbackInfo parasites dans les LVT des injecteurs de capture locaux Dépendance Apache Commons-IO supprimée ASM ombré renommé supprimé Résolution améliorée des variables locales pour les injections de capture de variables locales @Coerce sur les injecteurs de rappel et les redirections peut désormais résoudre les super interfaces, y compris les interfaces mixtes
0.7.11	juillet 2018	Corrections de 3 bugs mineurs : gestion de maxShiftBy corrigée, recherche permissive BeforeInvoke améliorée, désactivation de la fusion de signatures génériques sauf si le décompilateur est actif.
0.7.10	juin 2018	Consigner une erreur lorsqu'une classe mixin est soumise aux restrictions du chargeur de classe
0.7.9	avril 2018	Autoriser certains injecteurs à cibler les méthodes de mixage.
0.7.8	avril 2018	Corrections de bugs pour la validation des déclarations de membres, les redirections non sauvages et les erreurs internes dans le générateur de sous-classe Args
0.7.7	Mars 2018	Correctifs pour la gestion des déclencheurs de messages de journal pour la phase INIT et les erreurs lors de l'exécution avec des configurations d'enregistreur inattendues Ajouter des avertissements pour les points de tranche non valides et restreindre la conversion dans les gestionnaires ModifyConstant
0.7.6	novembre 2017	Correction de l'héritage pour les propriétés du système de chaînes
0.7.5	Octobre 2017	Ajoutez la prise en charge de @Coerce sur les injecteurs de redirection.
0.7.4	septembre 2017	Ajout de l'annotation @Dynamic pour décorer les éléments mixin avec des cibles injectées dynamiquement.
0.7.3	Août 2017	Modifications internes pour assurer la prise en charge de ModLauncher et Java 9
0.7.2	Août 2017	Ajoutez un profileur pour inspecter les performances du mixin.
0.7.1	Août 2017	Corrections et améliorations du Mixin AP, correction de la gestion des tableaux multidimensionnels et résolution des méthodes dans les superclasses de types dérivés de classes obscurcies Ajoutez le remappage du refmap d'exécution pour prendre en charge l'utilisation des dépendances deobfCompile avec différentes versions de mappage.
0,7	juillet 2017	Tous les binaires officiels sont maintenant signés Mise à niveau vers ASM 5.2 Ajouter la prise en charge des classes internes dans Mixins Les injecteurs peuvent désormais avoir plusieurs cibles explicites Les annotations @At peuvent désormais avoir leur propre identifiant Ajout de la prise en charge de l'utilisation de @Overwrite sur des méthodes non obscurcies afin de vérifier qu'une cible d'écrasement existe Améliorer la prise en charge des ponts synthétiques, détecter les méthodes de pont conflictuelles Détecter et avertir des valeurs At.Shift.BY excessives ModifyConstant peut désormais prendre en charge plusieurs tranches Ajouter une autorisation aux injecteurs pour détecter la surinjection
0.6.15	juillet 2017	Ajouter la prise en charge de plusieurs constantes dans ModifyConstant Ajouter CONSTANT comme point d'injection à usage général Ajout de la prise en charge de la redirection de l'accès à la longueur du tableau dans les redirecteurs de champs
0.6.14	juillet 2017	Ajoutez la prise en charge de l'utilisation de @Coerce sur les types de référence dans les injecteurs de rappel pour prendre en charge les types dérivés.
0.6.13	juillet 2017	Ajoutez la prise en charge d'une visibilité conforme des méthodes d'écrasement pour correspondre à la classe cible. Résout les problèmes où une méthode de classe cible a été modifiée par un Access Transformer pour avoir une meilleure visibilité
0.6.12	juin 2017	Ajouter un argument de tranche à @ModifyConstant Ajoutez l'injecteur @ModifyArgs qui peut modifier plusieurs arguments d'appel de méthode avec un seul gestionnaire.
0.6.11	juin 2017	Correction de la gestion de @Unique lorsque la même méthode unique existe dans plusieurs mixins ciblant la même classe Correction de la gestion des lambdas fusionnés afin que les lambdas des mixins soient appliqués correctement lorsque les lambdas existent déjà dans la classe cible (à la fois dans la classe d'origine et lorsqu'ils sont appliqués par des mixins antérieurs)
0.6.10	mai 2017	(0.6.9) Correctif mineur pour supprimer la dépendance à l'égard d'un assistant obsolète Respecter le remappage sur Mixin pour @At contenu Exiger que les redirecteurs qui se produisent avant l'appel au superctor soient statiques
0.6.8	Février 2017	Autoriser @ModifyConstant à accrocher un zéro implicite dans les comparaisons
0.6.7	janvier 2017	Ajouter la prise en charge de @Redirect lors de l'accès au tableau
0.6.6	janvier 2017	Autoriser les méthodes statiques dans les mixins d'accesseurs dans Java 8 et supérieur
0.6.5	janvier 2017	Ajouter la prise en charge des tranches d'injecteur
0.6.4	janvier 2017	Autoriser les descripteurs sur les NOUVEAUX points d'injection
0.6.3	décembre 2016	Prise en charge de SourceDebugExtension
0.6.2	décembre 2016	Ajouter la prise en charge des mixins @Pseudo (cible virtuelle)
0.6.1	novembre 2016	Traiter les annotations des outils logiciels dans l'AP
0,6	Octobre 2016	Prise en charge des accesseurs Mixin
0.5.17	Octobre 2016	Autoriser les injecteurs @Redirect à cibler de NOUVEAUX opcodes pour la redirection du constructeur
0.5.16	Octobre 2016	Améliorations du processeur d'annotation. Prise en charge des ombres et des remplacements dans les mixins multi-cibles Prise en charge des environnements d'obscurcissement enfichables dans AP
0.5.14	septembre 2016	Ajouter la prise en charge de la décompilation asynchrone
0.5.13	septembre 2016	Ajouter une stratégie alternative pour injecter des initialiseurs de champ
0.5.10	juin 2016	Support @Unique sur les champs
0.5.9	juin 2016	Échec difficile si une cible de mixage requise a déjà été transformée
0.5.8	juin 2016	Contraintes de support sur les injecteurs
0.5.7	juin 2016	Ajouter une annotation @Unique
0.5.6	mai 2016	Changements d'environnement, environnement de support via des agents
0.5.5	avril 2016	Ajouter l'injecteur @ModifyConstant Ajouter une annotation @Debug Autoriser les gestionnaires @ModifyArg statiques dans les méthodes d'instance
0.5.4	avril 2016	Les gestionnaires d'erreurs reçoivent également des erreurs de préparation de mixin
0.5.3	Février 2016	Injecteurs conformes Activer le hotswapper automatiquement si l'agent est actif Résoudre plusieurs problèmes avec les génériques dans les processeurs d'annotation
0.5.2	Février 2016	ID de support sur les injecteurs Priorité de support pour les injecteurs
0.5.1	Février 2016	Révision des injecteurs, les injecteurs de tous les mixins analysent désormais avant que les injecteurs ne soient réellement traités. Rend les injecteurs plus déterministes.
0.4.19	Février 2016	Ajouter la prise en charge de @Redirect sur les champs ainsi que sur les méthodes
0.4.18	Février 2016	Ajouter l'injecteur @ModifyLocal
0.4.17	janvier 2016	Prise en charge des ExtraSRG dans le processeur d'annotation Inclure les constructeurs dans la carte de référence Ajoutez l'annotation @Mutable pour supprimer les avertissements @Final
0.4.15	janvier 2016	Inclure les cibles souples dans refmap
0.4.14	janvier 2016	Ajouter la prise en charge des mixins d'interface
0.4.13	janvier 2016	Ajouter une annotation @Final
0.4.11	janvier 2016	Ajouter la prise en charge du regroupement d'injecteurs et de la valeur requise à l'échelle de la configuration
0.4.10	décembre 2015	Prise en charge du remappage d'exécution à l'aide de RemapperChain Ignorer les transformateurs de classe décorés avec @Resource Prise en charge de la validation @reason et @author lors des écrasements
0.4.8	décembre 2015	Processeur d'annotation amélioré pour prendre en charge MixinGradle Prise en charge de plusieurs environnements d'obscurcissement de cibles dans les refmaps
0.4.6	septembre 2015	Ajouter une phase INIT pour gérer le démarrage précoce de FML Ajouter la prise en charge des lambdas dans les mixins Ajouter la prise en charge du remplacement de code à chaud dans les mixins Améliorer la prise en charge des fonctionnalités Java 8
0.4.4	juillet 2015	Ajouter des contraintes pour les écrasements
0.4.3	mai 2015	Ajouter un point d'injection INVOKE_ASSIGN Prise en charge des rappels d'injecteur sans arguments Prise en charge de la coercition des types de paramètres covariants dans les rappels Prise en charge de la troncature des gestionnaires d'injecteurs de capture locale Décompilation à l'exécution des classes exportées à l'aide de Fernflower Ajouter un filtre d'exportation
0,4	mai 2015	Ombrer le package ASM déplacé et l'utiliser partout
0.3.2	avril 2015	Prise en charge du gestionnaire d'erreurs
0.3.1	avril 2015	Fusion d'annotations Autoriser l'alias des méthodes d'écrasement
0,3	Mars 2015	Environnements implémentés Prise en charge intrinsèque des méthodes Activation de la capture de variables locales Prise en charge des alias
0,2	Mars 2015	Ajout du support des supermixins (mixins héritant d'autres mixins)
0,1	janvier 2015	Prise en charge de base du mixage Prise en charge de base des injecteurs Processeur d'annotations