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/ - SNAPHOT 및 RELEASE 빌드
• 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를 참조하세요.

이클립스와 통합

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. 한 수준 위로 이동하여 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에서 개발한 IntelliJ IDEA용 Minecraft 개발 플러그인을 통해 사용할 수 있습니다.

버전 기록

구성에서 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를 사용하여 생성자를 노출할 수 있습니다. 예상치 못한 어플리케이터 및 전처리기 예외에 대한 컨텍스트 보고가 대폭 개선되어 에이전트가 특정 opcode에서 질식하는 경우를 더 쉽게 진단할 수 있습니다. 다음에 대한 버그 수정 믹스인 코드 내부에서 접근자 믹스인 멤버 호출 명시적 대상 선언에서 공백을 잘못 처리함 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월	Args 하위 클래스 생성기의 멤버 선언 유효성 검사, 비와일드 ctor 리디렉션 및 내부 오류에 대한 버그 수정
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 수정 및 개선, 다차원 배열 처리 수정, 난독화된 클래스 파생 유형의 슈퍼클래스에서 메서드 확인 다양한 매핑 버전과 함께 deobfCompile 종속성 사용을 지원하도록 런타임 참조 맵 재매핑을 추가합니다.
0.7	2017년 7월	이제 모든 공식 바이너리가 서명되었습니다. ASM 5.2로 업그레이드 Mixins에 내부 클래스에 대한 지원 추가 인젝터는 이제 여러 개의 명시적 타겟을 가질 수 있습니다. @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월	대상 클래스와 일치하도록 덮어쓰기 메서드의 가시성을 준수하는 지원을 추가합니다. 더 높은 가시성을 갖도록 액세스 변환기 에 의해 대상 클래스 메소드가 수정된 문제를 수정합니다.
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을 연결하도록 허용
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월	접근자 믹스인 지원
0.5.17	2016년 10월	@Redirect 인젝터가 생성자 리디렉션을 위해 새로운 opcode를 타겟팅하도록 허용
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월	인젝터 준수 에이전트가 활성화된 경우 자동으로 hotswapper를 활성화합니다. 주석 프로세서의 제네릭 관련 여러 문제 해결
0.5.2	2016년 2월	인젝터의 지원 ID 인젝터 지원 우선순위
0.5.1	2016년 2월	인젝터를 점검하고, 모든 믹스인의 인젝터는 이제 인젝터가 실제로 처리되기 전에 스캔합니다. 인젝터를 더욱 결정적으로 만듭니다.
19년 4월 4일	2016년 2월	필드 및 메소드에 @Redirect 지원 추가
18.04.04	2016년 2월	@ModifyLocal 인젝터 추가
0.4.17	2016년 1월	주석 프로세서에서 ExtraSRG 지원 참조 맵에 생성자를 포함합니다. @Final 경고를 억제하려면 @Mutable 주석을 추가하세요.
0.4.15	2016년 1월	참조 맵에 소프트 타겟 포함
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월	주석 병합 덮어쓰기 메서드의 별칭 지정 허용
0.3	2015년 3월	구현된 환경 내장 메소드 지원 지역 변수 캡처 활성화 별칭 지원
0.2	2015년 3월	슈퍼믹스인 지원 추가(다른 믹스인에서 상속되는 믹스인)
0.1	2015년 1월	기본 믹스인 지원 기본 인젝터 지원 주석 프로세서