mirror of
https://github.com/QM4RS/FridaBox.git
synced 2026-09-24 01:52:11 +02:00
Mahdi Karzari
5140bfc6a7
Integrate Frida Gadget into BlackBox guest startup, add the host workflow and controller tooling, and validate the complete sample hook flow on ARM64 Android 16.
1.3 KiB
1.3 KiB
Usage
- Install and open the FridaBox host on an ARM64 Android 12–16 research device.
- Tap Import APK and select one base
.apkthrough the system document picker..apks,.xapk,.apkm, split-only packages, and 32-bit-only native APKs are rejected. - Review package, version, SHA-256, private source path, and ABI status.
- Tap Launch instrumented. Startup intentionally pauses before the guest
Applicationis created. - Run the attach command shown on Runtime status. Attach and load hooks.
- Use Launch without instrumentation for a clean virtual process where the Gadget is not loaded. FridaBox stops the package before switching modes.
Debug builds expose Install demo guest. The action installs the generated
com.qm4rs.fridabox.sample APK only into BlackBox. Then run:
npm ci
python tools/build_frida_agents.py
python tools/attach_guest.py --package com.qm4rs.fridabox.sample --script scripts/sample-hook.js --keep-alive
After startup resumes, press the sample button. The visible result should be
1337, demonstrating that the guest ClassLoader was selected.
Clear virtual app data and Remove from virtual space affect only the BlackBox virtual environment. They do not invoke Android's real package manager.