Troubleshooting Reference

Troubleshooting Reference

이 페이지는 문제가 생겼을 때만 참고하는 상세 문서입니다. 처음 사용자는 Environment Checklist만 먼저 확인하세요.

경로 고정

macOS Homebrew:

export VENOMHOOK_APKTOOL=/opt/homebrew/bin/apktool
export VENOMHOOK_JADX=/opt/homebrew/bin/jadx

Windows PowerShell:

$env:VENOMHOOK_APKTOOL = "C:\Tools\apktool\apktool.bat"
$env:VENOMHOOK_JADX = "C:\Tools\jadx\bin\jadx.bat"

실행 시 직접 지정:

venomhook android-audit `
  --apk .\sample\myapp.apk `
  --apktool-path C:\Tools\apktool\apktool.bat `
  --jadx-path C:\Tools\jadx\bin\jadx.bat

흔한 에러

증상	주된 원인	해결
venomhook: command not found	editable install 미실행 또는 venv 비활성화	venv 활성화 후 pip install -e .
ModuleNotFoundError: venomhook	패키지 미설치 상태에서 Python module 직접 실행	pip install -e . 후 venomhook --help 사용
apktool을 사용할 수 없습니다	apktool이 PATH/env에 없음	VENOMHOOK_APKTOOL 또는 --apktool-path 지정
manifest decode skipped — audit cannot run	apktool 누락 또는 decode 실패	apktool 설치/경로 확인, APK 유효성 확인
jadx를 사용할 수 없습니다	jadx CLI wrapper가 PATH/env에 없음	--no-jadx 사용 또는 VENOMHOOK_JADX 지정
Windows에서 jadx-gui.exe만 있음	VenomHook은 GUI 앱이 아니라 CLI wrapper 실행	jadx.bat/jadx-cli.bat 설치 또는 --no-jadx
frida 실행 실패	Frida 미설치, device 미연결, server mismatch	frida --version, frida-ps -U 확인
Ghidra 분석 실패	Ghidra path, Java, project dir 문제	setup/env.*로 경로 설정 후 analyzeHeadless 확인

PATH 확인

macOS/Linux:

echo $PATH
command -v apktool
command -v jadx

Windows:

$env:PATH
where apktool
where jadx

macOS에서 Homebrew 도구가 설치되어 있는데 command가 잡히지 않으면 shell profile에 Homebrew 경로를 추가합니다.

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zprofile
source ~/.zprofile