Files
douyi_guaji_main/docs/deployment_quickstart.txt

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