112 lines
2.9 KiB
Plaintext
112 lines
2.9 KiB
Plaintext
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
|
|
|