Mixin

Mixin adalah kerangka kerja sifat/mixin untuk Java menggunakan ASM dan terhubung ke proses pemuatan kelas runtime melalui serangkaian layanan bawaan atau yang disediakan pengguna. Layanan bawaan saat ini mendukung sistem LegacyLauncher Mojang, meskipun sistem ini tidak lagi digunakan dan digantikan oleh ModLauncher dari cpw, yang memiliki ekstensibilitas lebih besar dan mendukung Java 8 dan yang lebih baru.

Dokumentasi

Dokumentasi utama untuk Mixin dapat ditemukan di Wiki.

Dokumentasi tambahan untuk masing-masing fitur dan anotasi dapat ditemukan di Javadoc yang ekstensif. Untuk bantuan tambahan gunakan saluran #mixin di Server Sponge Discord.

Biner

Biner mixin tersedia melalui Jenkins dan dipublikasikan ke repositori pakar berikut:

• https://repo.spongepower.org/repository/maven-public/ - SNAPHOT dan RELEASE build
• https://files.minecraftforge.net/maven/ - RELEASE hanya untuk build

perkakas

Untuk menangani tugas kebingungan, Mixin menyediakan Prosesor Anotasi yang bekerja pada waktu kompilasi untuk menghasilkan pemetaan kebingungan untuk diterapkan pada rantai alat Anda. Jika menggunakan Gradle 5 atau lebih baru, pemroses anotasi tidak lagi dimuat secara otomatis dari konfigurasi compile dan harus ditentukan secara eksplisit melalui konfigurasi annotationProcessor . Untuk tujuan ini, Mixin menyediakan artefak "fat jar" yang berisi semua dependensi yang diperlukan melalui :processor classifier. Misalnya jika build Anda menggunakan dependensi org.spongepowered:mixin:1.2.3 maka konfigurasi annotationProcessor Anda harus menentukan dependensi org.spongepowered:mixin:1.2.3:processor .

Jika Anda menggunakan Mixin dalam proyek Minecraft Forge maka plugin MixinGradle dapat digunakan untuk menyederhanakan konfigurasi Prosesor Anotasi Mixin. Ini memberikan sintaks sederhana untuk mengonfigurasi Mixin AP untuk proyek Anda, lihat README MixinGradle untuk cara mengonfigurasi MixinGradle.

Integrasi dengan Eclipse

Saat mengembangkan menggunakan Mixin , Anda dapat menggunakan Prosesor Anotasi Mixin dalam Eclipse untuk memberikan kesalahan dan peringatan yang peka konteks guna membantu Anda memecahkan masalah mixin Anda dengan lebih mudah. Untuk melakukannya:

1. Jalankan perintah gradle build untuk menghasilkan toples mixin
2. Buka properti proyek Eclipse Anda dan navigasikan ke Java Compiler -> Annotation Processing -> Factory Path
3. Centang kotak Enable project specific settings
4. Klik tombol Add External JARs dan pilih mixin jar yang dihasilkan dengan akhiran -processor (petunjuk: harus dalam Mixin/build/libs )
5. Navigasikan naik satu tingkat ke Java Compiler -> Annotation Processing
6. Centang kotak Enable project specific settings
7. Centang kotak Enable annotation processing
8. Klik tombol New... di sebelah kotak Processor options

• Setel Key ke reobfSrgFile
• Tetapkan Value ke jalur yang sepenuhnya memenuhi syarat ke file mcp-srg.srg (lokasi file pemetaan bervariasi berdasarkan platform, jika Anda tidak yakin di mana menemukannya, silakan ikuti tautan perselisihan di bawah).

9. Klik OK untuk menerapkan perubahan

Integrasi dengan IntelliJ IDEA

Fungsionalitas yang ditingkatkan untuk bekerja dengan Mixin di IntelliJ IDEA tersedia melalui plugin Minecraft Development for IntelliJ IDEA yang dikembangkan oleh DemonWav.

Riwayat Versi

Menentukan properti minVersion dalam konfigurasi Anda sangatlah penting. Riwayat versi berikut dapat digunakan untuk menentukan kapan fitur diperkenalkan (dan terkadang kapan bug utama dihilangkan) untuk membantu Anda menentukan minVersion mana yang harus Anda tentukan.

Versi	Tanggal	Fitur / Perubahan
0.8.3	Februari 2021	Menambahkan dukungan pemilih target dinamis dan pemilih target @Desc Menambahkan pemilih target pola Menambahkan dukungan pengukur yang lebih ekspresif ke pemilih target eksplisit Facelift dan peningkatan keseluruhan pada javadoc
0.8.1 (0.8.2)	September 2020	Perbaikan terbaru untuk mendukung ModLauncher 7.0 Perbaiki masalah kritis dalam menyelesaikan anggota yang dikaburkan dalam antarmuka yang diwariskan Diperbarui ke ASM 7.2
0,8	Januari 2020	Diperbarui ke ASM 6.2 Dukungan untuk ModLauncher Menambahkan pengakuan untuk Java 9 dan 10 Dukungan untuk tabel kebingungan ForgeGradle 3+ tsrg Konfigurasi sekarang dapat mewarisi konfigurasi lain @Invoke sekarang dapat digunakan untuk mengekspos konstruktor Pelaporan konteks yang ditingkatkan secara dramatis dari pengecualian aplikator dan praprosesor yang tidak terduga, membuatnya lebih mudah untuk mendiagnosis ketika agen tersedak pada opcode tertentu Perbaikan bug untuk Memanggil anggota mixin pengakses dari dalam kode mixin Penanganan spasi yang salah dalam deklarasi target eksplisit Perilaku tak terduga saat mencoba mengalihkan aktor Deteksi dengan benar aksesor yang tidak kompatibel yang tumpang tindih dan abaikan yang valid (jangan peringatkan) Pengakses statis antarmuka sekarang menyesuaikan target dengan benar jika antarmuka dimuat dalam kelas sebelum kelas target Ketidakcocokan statis untuk pengakses terdeteksi dan dilaporkan dengan benar, bukannya menyebabkan kerusakan Memperbaiki kesalahan generator dan injektor yang berkaitan dengan operan dua kata pada tumpukan yang memerlukan DUP2 Memperbaiki masalah pada generator LVT yang dilipat dari FabricMC Gagal-cepat ketika metode terakhir secara tidak sengaja disembunyikan oleh mixin Memperbaiki tampilan instance CallbackInfo yang tersesat di LVT injektor tangkapan lokal Ketergantungan Apache Commons-IO dihapus ASM berbayang yang diganti namanya dihapus Peningkatan resolusi variabel lokal untuk injeksi penangkapan variabel lokal @Coerce pada injektor panggilan balik dan pengalihan sekarang dapat menyelesaikan antarmuka super termasuk antarmuka campuran
0.7.11	Juli 2018	Perbaikan untuk 3 bug kecil: penanganan maxShiftBy diperbaiki, peningkatan pencarian permisif BeforeInvoke, nonaktifkan penggabungan tanda tangan umum kecuali dekompiler aktif.
0.7.10	Juni 2018	Catat kesalahan ketika kelas mixin tunduk pada pembatasan pemuat kelas
0.7.9	April 2018	Izinkan injektor tertentu menargetkan metode mixin.
0.7.8	April 2018	Perbaikan bug untuk validasi deklarasi anggota, pengalihan ctor non-liar, dan kesalahan internal di generator subkelas Args
0.7.7	Maret 2018	Perbaikan untuk penanganan pemicu pesan log untuk fase INIT dan kesalahan saat dijalankan dengan konfigurasi logger yang tidak terduga Tambahkan peringatan untuk titik irisan yang tidak valid dan mempersempit konversi di penangan ModifyConstant
0.7.6	November 2017	Perbaiki warisan untuk properti sistem string
0.7.5	Oktober 2017	Tambahkan dukungan untuk @Coerce pada injektor pengalihan.
0.7.4	September 2017	Menambahkan anotasi @Dynamic untuk mendekorasi elemen mixin dengan target yang disuntikkan secara dinamis.
0.7.3	Agustus 2017	Perubahan internal memberikan dukungan modlauncher dan java 9
0.7.2	Agustus 2017	Tambahkan profiler untuk memeriksa kinerja mixin.
0.7.1	Agustus 2017	Perbaikan dan penyempurnaan pada Mixin AP, perbaikan penanganan array multidimensi dan metode penyelesaian pada superclass tipe turunan dari kelas yang dikaburkan Tambahkan pemetaan ulang refmap runtime untuk mendukung penggunaan dependensi deobfCompile dengan versi pemetaan yang berbeda.
0,7	Juli 2017	Semua biner resmi sekarang telah ditandatangani Tingkatkan ke ASM 5.2 Tambahkan dukungan untuk kelas dalam di Mixins Injektor sekarang dapat memiliki beberapa target eksplisit @Anotasi sekarang dapat memiliki id sendiri Tambahkan dukungan untuk menggunakan @Overwrite pada metode yang tidak dikaburkan sebagai cara memverifikasi bahwa ada target penimpaan Tingkatkan dukungan untuk jembatan sintetis, deteksi metode jembatan yang bertentangan Deteksi dan peringatkan nilai At.Shift.BY yang berlebihan ModifyConstant sekarang dapat mendukung banyak irisan Tambahkan izin ke injektor untuk mendeteksi injeksi berlebih
0.6.15	Juli 2017	Tambahkan dukungan untuk beberapa konstanta di ModifyConstant Tambahkan CONSTANT sebagai titik injeksi tujuan umum Tambahkan dukungan untuk mengalihkan akses panjang array di pengalihan bidang
0.6.14	Juli 2017	Tambahkan dukungan untuk menggunakan @Coerce pada tipe referensi di Callback Injectors untuk mendukung tipe turunan.
0.6.13	Juli 2017	Tambahkan dukungan untuk menyesuaikan visibilitas metode penimpaan agar sesuai dengan kelas target. Memperbaiki masalah ketika metode kelas target telah dimodifikasi oleh Access Transformer untuk memiliki visibilitas yang lebih tinggi
0.6.12	Juni 2017	Tambahkan argumen irisan ke @ModifyConstant Tambahkan injektor @ModifyArgs yang dapat mengubah beberapa argumen pemanggilan metode dengan satu penangan.
0.6.11	Juni 2017	Memperbaiki penanganan @Unique ketika metode unik yang sama ada di lebih dari satu mixin yang menargetkan kelas yang sama Memperbaiki penanganan lambda yang digabungkan sehingga lambda dari mixin diterapkan dengan benar ketika lambda sudah ada di kelas target (baik di kelas asli maupun ketika diterapkan oleh mixin sebelumnya)
0.6.10	Mei 2017	(0.6.9) Perbaikan kecil untuk menghilangkan ketergantungan pada helper yang tidak digunakan lagi Hormati remap di Mixin karena berisi @At Mengharuskan pengalihan yang terjadi sebelum panggilan ke superctor bersifat statis
0.6.8	Februari 2017	Izinkan @ModifyConstant mengaitkan nol implisit dalam perbandingan
0.6.7	Januari 2017	Tambahkan dukungan untuk @Redirect pada akses array
0.6.6	Januari 2017	Izinkan metode statis di mixin pengakses di Java 8 dan yang lebih baru
0.6.5	Januari 2017	Tambahkan dukungan untuk irisan injektor
0.6.4	Januari 2017	Izinkan deskriptor pada titik injeksi BARU
0.6.3	Desember 2016	Dukungan SourceDebugExtension
0.6.2	Desember 2016	Tambahkan dukungan untuk mixin @Pseudo (target virtual).
0.6.1	November 2016	Memproses anotasi penerapan lunak di AP
0,6	Oktober 2016	Dukungan Accessor Mixin
0.5.17	Oktober 2016	Izinkan injektor @Redirect menargetkan opcode BARU untuk pengalihan konstruktor
0.5.16	Oktober 2016	Peningkatan Prosesor Anotasi. Mendukung bayangan dan penggantian dalam mixin multi-target Mendukung lingkungan kebingungan yang dapat dicolokkan di AP
0.5.14	September 2016	Tambahkan dukungan dekompilasi asinkron
0.5.13	September 2016	Tambahkan strategi alternatif untuk memasukkan inisialisasi bidang
0.5.10	Juni 2016	Dukungan @Unik di bidang
0.5.9	Juni 2016	Gagal keras jika target mixin yang diperlukan telah diubah
0.5.8	Juni 2016	Dukungan kendala pada injektor
0.5.7	Juni 2016	Tambahkan anotasi @Unik
0.5.6	Mei 2016	Perubahan lingkungan, mendukung lingkungan melalui agen
0.5.5	April 2016	Tambahkan injektor @ModifyConstant Tambahkan anotasi @Debug Izinkan penangan @ModifyArg statis dalam metode instan
0.5.4	April 2016	Penangan kesalahan juga menerima kesalahan persiapan mixin
0.5.3	Februari 2016	Sesuaikan injektor Aktifkan hotswapper secara otomatis jika agen aktif Perbaiki beberapa masalah dengan obat generik di Pemroses Anotasi
0.5.2	Februari 2016	ID Dukungan pada injektor Prioritas dukungan untuk injektor
0.5.1	Februari 2016	Perombakan injektor, injektor dari semua mixin sekarang dipindai sebelum injektor apa pun benar-benar diproses. Membuat injektor lebih deterministik.
0.4.19	Februari 2016	Tambahkan dukungan untuk @Redirect pada bidang dan metode
0.4.18	Februari 2016	Tambahkan injektor @ModifyLocal
0.4.17	Januari 2016	Mendukung ExtraSRGs di Prosesor Anotasi Sertakan konstruktor dalam peta referensi Tambahkan anotasi @Mutable untuk menyembunyikan peringatan @Final
0.4.15	Januari 2016	Sertakan target lunak dalam refmap
0.4.14	Januari 2016	Tambahkan dukungan untuk mix antarmuka
0.4.13	Januari 2016	Tambahkan anotasi @Final
0.4.11	Januari 2016	Tambahkan dukungan untuk pengelompokan injektor dan nilai kebutuhan seluruh konfigurasi
0.4.10	Desember 2015	Dukungan pemetaan ulang runtime menggunakan RemapperChain Abaikan transformator kelas yang dihiasi dengan @Resource Mendukung validasi @reason dan @author pada penimpaan
0.4.8	Desember 2015	Prosesor Anotasi ditingkatkan untuk mendukung MixinGradle Mendukung beberapa lingkungan kebingungan target di refmaps
0.4.6	September 2015	Tambahkan fase INIT untuk menangani startup FML awal Tambahkan dukungan untuk lambda di mixin Tambahkan dukungan untuk penggantian kode panas di mixin Tingkatkan dukungan fitur Java 8
0.4.4	Juli 2015	Tambahkan batasan untuk penimpaan
0.4.3	Mei 2015	Tambahkan titik injeksi INVOKE_ASSIGN Mendukung panggilan balik injektor tanpa argumen Mendukung pemaksaan tipe parameter kovarian dalam callback Mendukung pemotongan penangan injektor penangkapan lokal Dekompilasi runtime dari kelas yang diekspor menggunakan fernflower Tambahkan filter ekspor
0,4	Mei 2015	Naungan memindahkan paket ASM dan menggunakannya secara menyeluruh
0.3.2	April 2015	Dukungan penanganan kesalahan
0.3.1	April 2015	Penggabungan Anotasi Izinkan metode Timpa menjadi alias
0,3	Maret 2015	Lingkungan yang Diimplementasikan Dukungan metode intrinsik Mengaktifkan pengambilan variabel lokal Dukungan alias
0,2	Maret 2015	Menambahkan dukungan supermixin (mixin yang diwarisi dari mixin lain)
0,1	Januari 2015	Dukungan Mixin Dasar Dukungan Injektor Dasar Pemroses Anotasi