Mixin

Mixin は、ASM を使用し、プラグイン可能な組み込みサービスまたはユーザー提供のサービスのセットを介してランタイム クラスローディング プロセスにフックする Java 用のトレイト/ミックスイン フレームワークです。組み込みサービスは現在 Mojang の LegacyLauncher システムをサポートしていますが、これは非推奨となり、拡張性が高く Java 8 以降をサポートする cpw による ModLauncher が優先されます。

ドキュメント

Mixinの主なドキュメントは Wiki にあります。

個々の機能と注釈に関する追加のドキュメントは、広範な Javadoc にあります。さらにヘルプが必要な場合は、Sponge Discord サーバーのチャンネル#mixinを使用してください。

バイナリ

Mixin バイナリは Jenkins 経由で入手でき、次の Maven リポジトリに公開されます。

• https://repo.spongepowered.org/repository/maven-public/ - スナップショットとリリース ビルド
• https://files.minecraftforge.net/maven/ - RELEASE ビルドのみ

ツーリング

難読化タスクを処理するために、Mixin はコンパイル時に動作してツールチェーンに適用する難読化マッピングを生成するアノテーション プロセッサを提供します。 Gradle 5 以降を使用している場合、アノテーション プロセッサはcompile設定から自動的にロードされなくなり、 annotationProcessor設定を介して明示的に指定する必要があります。この目的のために、Mixin は、 :processor分類子を介して、必要な依存関係をすべて含む「fat jar」アーティファクトを提供します。たとえば、ビルドで依存関係org.spongepowered:mixin:1.2.3使用する場合、 annotationProcessor 設定で依存関係org.spongepowered:mixin:1.2.3:processorを指定する必要があります。

Minecraft Forge プロジェクトで Mixin を使用している場合は、MixinGradle プラグインを使用して Mixin Annotation Processor の構成を簡素化できます。これは、プロジェクトの Mixin AP を構成するための簡単な構文を提供します。MixinGradle の構成方法については、MixinGradle README を参照してください。

Eclipseとの統合

Mixin を使用して開発する場合、Eclipse 内でMixin Annotation Processor を使用してコンテキスト依存のエラーと警告を提供し、ミックスインのトラブルシューティングをより簡単に行うことができます。そのためには:

1. gradle buildコマンドを実行して mixin jar を生成します。
2. Eclipse プロジェクトのプロパティを開き、 Java Compiler -> Annotation Processing -> Factory Pathに移動します。
3. Enable project specific settingsチェックボックスをオンにします
4. 「 Add External JARsボタンをクリックし、サフィックス-processorが付いた生成された mixin jar を選択します (ヒント: Mixin/build/libsにあるはずです)。
5. 1 レベル上のJava Compiler -> Annotation Processingに移動します。
6. Enable project specific settingsチェックボックスをオンにします
7. Enable annotation processingチェックボックスをオンにします
8. Processor optionsボックスの横にあるNew...ボタンをクリックします。

• Key reobfSrgFileに設定します
• Value mcp-srg.srgファイルへの完全修飾パスに設定します (マッピング ファイルの場所はプラットフォームによって異なります。場所がわからない場合は、以下の Discord リンクに従ってください)。

9. OKをクリックして変更を適用します

IntelliJ IDEA との統合

IntelliJ IDEA でMixinを操作するための拡張機能は、DemonWav によって開発された Minecraft Development for IntelliJ IDEA プラグインを介して利用できます。

バージョン履歴

構成でminVersionプロパティを指定することは非常に重要です。次のバージョン履歴を使用すると、機能がいつ導入されたか (場合によっては重大なバグが修正されたか) を判断し、どのminVersion指定する必要があるかを判断することができます。

バージョン	日付	機能・変更点
0.8.3	2021年2月	動的ターゲット セレクターのサポートと@Descターゲット セレクターを追加しました パターンターゲットセレクターを追加しました 明示的なターゲット セレクターに、より表現力豊かな量指定子のサポートを追加しました。 javadoc のフェイスリフトと全体的な改善
0.8.1 (0.8.2)	2020年9月	ModLauncher 7.0をサポートするためのホットフィックス 継承されたインターフェイスの難読化されたメンバーの解決に関する重大な問題を修正 ASM 7.2に更新されました
0.8	2020年1月	ASM 6.2に更新されました ModLauncherのサポート Java 9 および 10 の認識を追加しました。 ForgeGradle 3+ tsrg 難読化テーブルのサポート 構成を他の構成から継承できるようになりました @Invoke を使用してコンストラクターを公開できるようになりました 予期しないアプリケーター例外とプリプロセッサ例外のコンテキスト レポートが大幅に改善され、エージェントが特定のオペコードで停止したときの診断が容易になりました。 のバグ修正 ミックスイン コード内からアクセサー ミックスインのメンバーを呼び出す 明示的なターゲット宣言でのスペースの不適切な処理 CTOR をリダイレクトしようとすると予期しない動作が発生する 互換性のないアクセサーの重複を適切に検出し、有効なアクセサーを無視します (警告しません)。 インターフェイスがターゲット クラスの前にクラスロードされている場合、インターフェイスの静的アクセサーがターゲットに正しく準拠するようになりました。 アクセサーの静的不一致がクラッシュを引き起こすのではなく、正しく検出および報告されました DUP2 を必要とするスタック上のダブルワード オペランドに関連するジェネレーターおよびインジェクターのエラーを修正しました。 FabricMC から組み込まれた LVT ジェネレーターの問題を修正しました 最終メソッドがミックスインによって誤って隠された場合のフェイルファスト ローカル キャプチャ インジェクター LVT での浮遊CallbackInfoインスタンスの外観を修正 Apache Commons-IO 依存関係が削除されました 名前変更されたシェーディング ASM が削除されました ローカル変数キャプチャインジェクションのローカル変数の解像度の向上 コールバック インジェクターとリダイレクトの@Coerce が、混合インターフェイスを含むスーパー インターフェイスを解決できるようになりました
0.7.11	2018年7月	3 つのマイナーなバグを修正しました。maxShiftBy の処理が修正され、BeforeInvoke の寛容検索が改善され、逆コンパイラがアクティブでない限り汎用シグネチャのマージが無効になりました。
0.7.10	2018年6月	ミックスイン クラスがクラスローダーの制限を受ける場合にエラーをログに記録する
0.7.9	2018年4月	特定のインジェクターがミックスイン メソッドをターゲットにできるようにします。
0.7.8	2018年4月	メンバー宣言の検証、非ワイルド ctor リダイレクト、 Argsサブクラス ジェネレーターの内部エラーのバグを修正しました。
0.7.7	2018年3月	予期しないロガー構成で実行する場合の INIT フェーズおよびエラーのログ メッセージ トリガーの処理を修正しました。 ModifyConstant ハンドラーに無効なスライス ポイントと縮小変換に関する警告を追加します。
0.7.6	2017年11月	文字列システムプロパティの継承を修正
0.7.5	2017年10月	リダイレクト インジェクターに@Coerceのサポートを追加します。
0.7.4	2017年9月	動的に挿入されたターゲットでミックスイン要素を装飾するための@Dynamicアノテーションを追加しました。
0.7.3	2017年8月	modlauncher と Java 9 のサポートを提供するための内部変更
0.7.2	2017年8月	ミックスインのパフォーマンスを検査するためのプロファイラーを追加します。
0.7.1	2017年8月	Mixin AP の修正と改善、多次元配列の処理の修正、および難読化されたクラスの派生型のスーパークラスでのメソッドの解決 実行時 refmap の再マッピングを追加して、異なるマッピング バージョンでの deobfCompile 依存関係の使用をサポートします。
0.7	2017年7月	すべての公式バイナリが署名されるようになりました ASM 5.2 へのアップグレード Mixin に内部クラスのサポートを追加 インジェクターは複数の明示的なターゲットを持つことができるようになりました @Atアノテーションが独自のID を持つことができるようになりました 上書きターゲットが存在することを確認する方法として、難読化されていないメソッドで@Overwrite を使用するためのサポートを追加します。 合成ブリッジのサポートを改善し、競合するブリッジ方法を検出します 過剰な At.Shift.BY 値を検出して警告する ModifyConstant が複数のスライスをサポートできるようになりました 過剰噴射を検出するためにインジェクターに許可を追加
0.6.15	2017年7月	ModifyConstantに複数の定数のサポートを追加 汎用注入ポイントとしてCONSTANTを追加 フィールドリダイレクタでの配列長アクセスのリダイレクトのサポートを追加
0.6.14	2017年7月	派生型をサポートするために、コールバック インジェクターの参照型で@Coerce を使用するためのサポートを追加します。
0.6.13	2017年7月	ターゲット クラスに一致する上書きメソッドの可視性の適合のサポートを追加します。ターゲット クラスのメソッドがAccess Transformerによって変更され、可視性が向上する問題を修正しました。
0.6.12	2017年6月	@ModifyConstantにスライス引数を追加 単一のハンドラーで複数のメソッド呼び出し引数を変更できる@ModifyArgsインジェクターを追加します。
0.6.11	2017年6月	同じクラスをターゲットとする複数のミックスインに同じ一意のメソッドが存在する場合の@Uniqueの処理を​​修正しました。 ラムダがターゲット クラスに既に存在する場合 (元のクラスと以前のミックスインによって適用された場合の両方) にミックスインからのラムダが正しく適用されるように、マージされたラムダの処理を修正しました。
0.6.10	2017年5月	(0.6.9) 非推奨のヘルパーへの依存を削除するためのマイナー修正 含まれる@Atの Mixin でのリマップを尊重する superctor を呼び出す前に発生するリダイレクターは静的である必要があります
0.6.8	2017年2月	@ModifyConstant が比較時に暗黙的なゼロをフックできるようにする
0.6.7	2017年1月	配列アクセスで @Redirect のサポートを追加
0.6.6	2017年1月	Java 8 以降のアクセサー ミックスインで静的メソッドを許可する
0.6.5	2017年1月	インジェクタースライスのサポートを追加
0.6.4	2017年1月	新しい注入ポイントで記述子を許可する
0.6.3	2016年12月	SourceDebugExtension のサポート
0.6.2	2016年12月	@Pseudo (仮想ターゲット) ミックスインのサポートを追加
0.6.1	2016 年 11 月	AP でのソフト実装アノテーションの処理
0.6	2016年10月	アクセサー Mixin のサポート
0.5.17	2016年10月	@Redirect インジェクターがコンストラクター リダイレクトの新しいオペコードをターゲットにできるようにする
0.5.16	2016年10月	注釈プロセッサの改善。マルチターゲット ミックスインでのシャドウとオーバーライドのサポート AP でのプラグ可能な難読化環境のサポート
0.5.14	2016 年 9 月	非同期逆コンパイルのサポートを追加
0.5.13	2016 年 9 月	フィールド初期化子を注入するための代替戦略を追加する
0.5.10	2016年6月	フィールドで @Unique をサポート
0.5.9	2016年6月	必要なミックスイン ターゲットがすでに変換されている場合はハード失敗します
0.5.8	2016年6月	インジェクターのサポート制約
0.5.7	2016年6月	@Unique アノテーションを追加する
0.5.6	2016年5月	環境の変化、エージェントによるサポート環境
0.5.5	2016 年 4 月	@ModifyConstant インジェクターを追加 @Debug アノテーションを追加する インスタンス メソッドで静的な @ModifyArg ハンドラーを許可する
0.5.4	2016 年 4 月	エラー ハンドラーはミックスイン準備エラーも受け取ります
0.5.3	2016 年 2 月	適合インジェクター エージェントがアクティブな場合、ホットスワッパーを自動的に有効にする 注釈プロセッサのジェネリックに関する複数の問題を修正
0.5.2	2016 年 2 月	インジェクターのサポートID インジェクターのサポート優先度
0.5.1	2016 年 2 月	インジェクターをオーバーホールし、すべてのミックスインのインジェクターが実際にインジェクターが処理される前にスキャンするようになりました。インジェクターをより決定的にします。
0.4.19	2016 年 2 月	メソッドだけでなくフィールドにも @Redirect のサポートを追加
0.4.18	2016 年 2 月	@ModifyLocal インジェクターを追加
0.4.17	2016年1月	注釈プロセッサでの ExtraSRG のサポート 参照マップにコンストラクターを含める @Final 警告を抑制するために @Mutable アノテーションを追加します
0.4.15	2016年1月	ソフトターゲットをrefmapに含める
0.4.14	2016年1月	インターフェースミックスインのサポートを追加
0.4.13	2016年1月	@Final アノテーションを追加する
0.4.11	2016年1月	インジェクターのグループ化と構成全体の必須値のサポートを追加
0.4.10	2015年12月	RemapperChain を使用したランタイム再マッピングのサポート @Resource で修飾されたクラス トランスフォーマーを無視する 上書き時の @reason および @author 検証をサポート
0.4.8	2015年12月	MixinGradle をサポートするようにアノテーション プロセッサが改良されました refmap で複数のターゲット難読化環境をサポートする
0.4.6	2015 年 9 月	初期の FML 起動を処理するための INIT フェーズを追加 ミックスインにラムダのサポートを追加 ミックスインでのホットコード置換のサポートを追加 Java 8 機能のサポートを改善する
0.4.4	2015 年 7 月	上書きの制約を追加する
0.4.3	2015年5月	INVOKE_ASSIGNインジェクションポイントを追加 引数なしのインジェクター コールバックをサポートする コールバックでの共変パラメータ型の強制のサポート ローカルキャプチャインジェクターハンドラーの切り捨てをサポート fernflower を使用したエクスポートされたクラスのランタイム逆コンパイル エクスポートフィルターを追加
0.4	2015年5月	再配置された ASM パッケージをシェーディングして全体で使用する
0.3.2	2015 年 4 月	エラーハンドラーのサポート
0.3.1	2015 年 4 月	注釈の結合 Overwrite メソッドのエイリアス化を許可する
0.3	2015 年 3 月	実装された環境 組み込みメソッドのサポート ローカル変数キャプチャを有効にしました エイリアスのサポート
0.2	2015 年 3 月	スーパーミックスインのサポートを追加しました (他のミックスインから継承するミックスイン)
0.1	2015年1月	基本的なミックスインのサポート 基本的なインジェクターのサポート 注釈プロセッサ