Fernflower

Fernflower는 Java용으로, 아마도 일반적인 고급 프로그래밍 언어용으로는 최초로 실제로 작동하는 분석적 디컴파일러입니다.

릴리스는 Intellij Community 저장소에 게시됩니다.

버그 리포트와 기능 요청은 이슈 트래커 (하위 시스템 Java. Decompiler. Engine)로 보내주세요.

IntelliJ에서의 사용

Fernflower는 IntelliJ IDEA에 번들로 포함되어 있으며, 주로 디버깅 시 또는 클래스 파일 탐색 시 Java 코드를 표시하는 데 사용됩니다.

명령줄에서의 사용

Fernflower는 다음 명령을 사용하여 독립 실행형 모드로 명령줄에서 실행할 수 있습니다:

java -jar fernflower.jar [-<option>=<value>]* [<source>]+ <destination>

*는 0회 이상 반복을 의미합니다.

+는 1회 이상 반복을 의미합니다.

<source>: 디컴파일할 파일 또는 디렉터리입니다. 디렉터리는 재귀적으로 검색됩니다. 허용되는 파일 확장자는 class, zip 및 jar입니다. -e= 접두사가 붙은 소스는 "라이브러리" 파일을 의미하며, 디컴파일되지는 않지만 클래스나 메서드 간의 관계를 분석할 때 고려됩니다. 특히 식별자 이름 변경(ren 옵션 참조)은 외부 클래스에 대한 정보를 통해 이점을 얻을 수 있습니다.

<destination>: 결과 Java 소스를 배치할 대상 디렉터리입니다.

<option>=<value>: 해당 값이 있는 명령줄 옵션입니다(아래 "명령줄 옵션" 참조).

예제

java -jar fernflower.jar -hes=0 -hdc=0 c:\Temp\binary\ -e=c:\Java\rt.jar c:\Temp\source\

java -jar fernflower.jar -dgs=1 c:\Temp\binary\library.jar c:\Temp\binary\Boot.class c:\Temp\source\

명령줄 옵션

mpm 및 urc를 제외하고 값 1은 활성화, 0은 비활성화를 의미합니다. 기본값이 있는 경우 괄호 안에 표시됩니다.

일반적으로 사용자가 변경할 가능성이 있는 옵션(있는 경우)은 다음과 같습니다: hes, hdc, dgs, mpm, ren, urc 나머지 옵션은 그대로 둘 수 있으며, 전문 리버스 엔지니어를 대상으로 합니다.

• rbr (1): 브릿지 메서드 숨기기
• rsy (0): 합성 클래스 멤버 숨기기
• din (1): 내부 클래스 디컴파일
• dc4 (1): 1.4 클래스 참조 축소
• das (1): assertion 디컴파일
• hes (1): 빈 super 호출 숨기기
• hdc (1): 빈 기본 생성자 숨기기
• dgs (0): 제네릭 시그니처 디컴파일
• ner (1): 예외를 던지지 않는 반환 가정
• den (1): 열거형 디컴파일
• rgn (1): qualified new 문의 일부인 getClass() 호출 제거
• lit (0): 숫자 리터럴을 "있는 그대로" 출력
• asc (0): 문자열 및 문자 리터럴의 비ASCII 문자를 유니코드 이스케이프로 인코딩

식별자 이름 변경

일부 난독화 도구는 클래스와 그 멤버 요소에 짧고 의미 없으며 무엇보다 모호한 이름을 부여합니다. 이러한 코드를 다시 컴파일하면 많은 충돌이 발생합니다. 따라서 디컴파일러가 요소 이름을 변경하여 각 식별자의 고유성을 보장하는 것이 좋습니다.

ren 옵션(즉, -ren=1)은 이름 변경 기능을 활성화합니다. 기본 이름 변경 전략은 다음과 같습니다:

• 요소 이름이 예약어이거나 3자 미만인 경우 이름 변경
• 새 이름은 간단한 패턴에 따라 구성됩니다: (class|method|field)_<연속 고유 번호> 디컴파일러가 이름을 변경할 때 호출하는 4가지 핵심 메서드의 자체 구현을 제공하여 이러한 규칙을 재정의할 수 있습니다. 간단히 urc 옵션에 org.jetbrains.java.decompiler.main.extern.IMemberIdentifierRenamer를 구현하는 클래스를 전달하세요 (예: -urc=com.example.MyRenamer) Fernflower에 전달합니다. 클래스는 애플리케이션 클래스패스에서 사용 가능해야 합니다.

각 메서드의 의미는 이름에서 명확해야 합니다: toBeRenamed는 요소 이름을 변경할지 여부를 결정하고, 나머지 세 개는 각각 클래스, 메서드, 필드에 대한 새 이름을 제공합니다.

개발

실행 가능한 시작 스크립트 빌드:

./gradlew :installDist

시작 스크립트는 build/install/engine/bin에 생성됩니다.

기여

Fernflower는 IntelliJ Community 프로젝트의 일부이며, 기여를 환영합니다. 패치를 보내는 선호하는 방법은 IntelliJ Community 저장소에 풀 리퀘스트를 생성하는 것입니다. 패치를 제출할 때는 기여 지침을 따라주세요.

라이선스

Fernflower는 Apache License Version 2.0에 따라 라이선스가 부여됩니다.

크레딧

Fernflower는 원래 Stiver가 개발했지만 2014년부터 JetBrains에서 유지 관리하고 있습니다. 일부 패치는 ForgeFlower에서 이 저장소로 병합되었습니다. Fernflower의 미러는 Andrew McRae가 오랫동안 유지 관리했습니다.

명칭

올바른 이름은 Fernflower이며, FernFlower가 아닙니다.