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-id>    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

