Skip to content

Environment Checklist

Jump to bottom
luckyboxx edited this page May 9, 2026 · 1 revision

Environment Checklist

처음 사용할 때는 아래 항목만 확인하면 됩니다. 세부 오류 대응은 Troubleshooting Reference에 분리해 두었습니다.

1. VenomHook CLI

pip install -e . 이후에는 PYTHONPATH=src 없이 실행되어야 합니다.

venomhook --help
venomhook offset-e2e \
  --static-json ./sample/examples/static_meta.sample.json \
  --target sample.exe \
  --out-dir ./out

Windows PowerShell:

venomhook --help
venomhook offset-e2e `
  --static-json .\sample\examples\static_meta.sample.json `
  --target sample.exe `
  --out-dir .\out

이 단계는 Ghidra, apktool, jadx, Frida 없이도 통과해야 합니다.

2. Java 기반 도구

Ghidra, apktool, jadx를 사용할 예정이면 Java가 필요합니다.

java -version

macOS Homebrew 예시:

command -v apktool
command -v jadx

Windows PowerShell 예시:

where apktool
where jadx

VenomHook은 jadx-gui.exe가 아니라 jadx/jadx-cli command를 실행합니다. Windows에서 jadx GUI만 사용 중이면 --no-jadx로 Java/JNI 분석을 건너뛰거나, jadx.bat/jadx-cli.bat 경로를 지정하세요.

3. Android audit

Manifest 감사 중심으로 빠르게 확인:

venomhook android-audit \
  --apk ./sample/myapp.apk \
  --no-jadx \
  --out-dir ./out_audit \
  --audit-json ./out_audit/audit.json

외부 도구 누락을 즉시 실패로 확인:

venomhook android-audit \
  --apk ./sample/myapp.apk \
  --out-dir ./out_audit \
  --strict-tools \
  --quiet

핵심만 기억하면 됩니다.

  • apktool 없음: manifest audit 불가
  • jadx 없음: Java native/JNI bridge 분석만 생략 가능
  • jadx-gui.exe만 있음: VenomHook 자동 연동 대상 아님

4. Frida

동적 실행까지 할 때만 확인합니다.

frida --version

Android device 대상이면:

frida-ps -U

Clone this wiki locally