Douyin Guaji - Quick Deployment (TXT) ===================================== Purpose ------- This is the simplified migration guide. Computer-side setup is kept minimal because one-click deploy scripts are already provided. 1) Computer (minimal) --------------------- Prerequisites: - Windows 10/11 - Python 3.10+ - ADB (platform-tools) available in PATH In project root, run: bootstrap_deps.bat Optional: bootstrap_deps.bat --minimal 2) Phone required setup ----------------------- 2.1 Enable Developer options - Open: Settings -> About phone - Tap "Build number" 7 times - Enter lock screen password if asked 2.2 Enable USB debugging - Open: Settings -> Developer options - Turn on: - USB debugging - (if available) USB debugging (Security settings) / USB installation 2.3 First USB authorization - Connect phone to PC with USB cable - Set USB mode to File Transfer (MTP) - On phone popup "Allow USB debugging", tap Allow - Verify on PC: adb devices Expected: device If status is "unauthorized", replug cable and approve popup again. 3) How to show the bottom navigation bar on phone (detailed) ------------------------------------------------------------- This section is for the Android system navigation bar (Back / Home / Recents). Method A (standard Android path) -------------------------------- 1. Open Settings 2. Search "Navigation mode" (or "System navigation") 3. Open the result and switch to: - 3-button navigation (shows bottom buttons), or - Gesture navigation (shows gesture bar/hint on some devices) Common path examples: - Pixel / near-stock Android: Settings -> System -> Navigation mode - Some other ROMs: Settings -> System -> Gestures -> Navigation mode Method B (common brand paths) ----------------------------- - Samsung: Settings -> Display -> Navigation bar -> Buttons - Xiaomi / Redmi / POCO (MIUI / HyperOS): Settings -> Home screen -> System navigation -> Buttons - OPPO / OnePlus (ColorOS / OxygenOS): Settings -> System settings -> System navigation -> Virtual buttons - vivo / iQOO: Settings -> System navigation -> Navigation keys - Huawei / Honor: Settings -> System & updates -> System navigation -> Three-key navigation If the bar still does not appear: --------------------------------- 1. Disable any "Full screen gestures" option 2. Disable app-level full screen mode for the current app 3. Reboot phone once after switching navigation mode 4. Use Settings search with keywords: - navigation - system navigation - gesture Temporary reveal tip: --------------------- If an app is full-screen and hides controls, swipe up from the very bottom edge once. On many devices this temporarily shows system navigation controls. 4) Quick run check ------------------ After dependencies are ready and ADB is authorized: python bin/gui_app.py Check: - Device is visible in device selector - Screenshot action works - Start button can launch run loop