R8 매핑 파일

R8은 Android build에서 Java·Kotlin 코드를 줄이고 최적화하며 이름을 바꿀 수 있는 도구다. R8 매핑 파일은 최적화 전 원래 클래스·함수·줄과 build 뒤 바뀐 이름·줄의 대응을 기록한다. Android Gradle build에서는 보통 debug·release 같은 build 설정 구분인 variant별 build/outputs/mapping/.../mapping.txt로 생성된다. Retrace는 난독화된 stack과 이 파일을 함께 읽어 원래 정의를 복원한다.

이 파일은 모든 앱 버전에 공통인 사전이 아니다. 새 build를 만들 때 덮어쓸 수 있으므로 공개한 build마다 별도 보관하고, stack의 build 식별자와 같은 산출물인지 확인해야 한다. mapping 파일이 없거나 다른 build의 파일만 있으면 그럴듯한 이름이 나와도 정확한 복원 증거가 아니다.