Quick Testing Guide (Cheatsheet)

Practical workflow guide for device profile simulation and application state management in Recovery mode (OrangeFox / TWRP).

📥 1. Deploy Recovery Package (One-Time Setup)

Package deployment is performed only once per testing device:

1. Boot into OrangeFox or TWRP Recovery. (If your device uses a lockscreen PIN / Pattern, enter it to decrypt the data partition).
2. Navigate to Install / Files.
3. Select the KuyFox-v1.0.zip package.
4. Swipe the confirmation slider (Swipe to Flash).
5. Done! The KuyFox testing framework is immediately operational without requiring a device reboot.

⚡ 2. Launch the Testing Terminal

There are 2 practical ways to launch the KuyFox terminal interface in recovery:

🔹 Method 1: Direct Execution (Fastest — No Manual Partition Mount)

1. Open the Terminal in recovery:
   • OrangeFox: Menu (three lines) -> Terminal
   • TWRP: Advanced -> Terminal
2. Type the following command and press Enter:
   Terminal

   sh /sdcard/KuyFox/kuyfox.sh
   

   (This method executes immediately without needing to mount any partition manually. When spoofing operations run, the KuyFox engine automatically mounts /system and /vendor in RW mode in the background).

🔹 Method 2: Use Short kuyfox Command (Via System Mount)

1. In the main recovery menu, open the Mount menu and check System.
2. Open the Terminal, then simply type:
   Terminal

   kuyfox
   

   (The persistent binary wrapper is stored in /system/bin/kuyfox. Checking the System partition instantly activates the kuyfox shortcut in $PATH).

🎯 3. Testing Workflow Cheatsheet

Select the menu corresponding to your test scenario:

A. Simulate a New Device Profile (Profile Simulation)

Select Menu: [2] Random Test Profile

• Applies a fresh build.prop profile, Android ID, SSAID, and randomized serial to test application behavior against diverse device configurations in a single step.

B. Archive Application Testing State (Backup State)

Select Menu: [1] Backup & Restore -> Select [1] Backup App Data

1. Select the target application under test.
2. Enter an optional session note (e.g., Scenario_A).
3. The application state is archived into sequential slots (001, 002, etc.).

C. Restore Application Testing State (Restore State)

Select Menu: [1] Backup & Restore -> Select [2] Restore App Data

1. Select the target application to restore.
2. Choose the slot number corresponding to the desired test state.
3. Confirm restore. Upon booting into Android, the application resumes exactly from the saved state.

D. Revert Device to Factory Baseline (Reset Baseline)

Select Menu: [5] Backup & Restore Original build.prop -> Select [2] Restore Original

• Restores all device partitions to their stock factory baseline before testing commenced.

E. Boot into Android System

Select Menu: [8] Reboot System

• Restarts the device directly into the standard Android operating system.