Anxcye/anx-reader

适配 Android 设备的手势线沉浸

Open

#413 opened on Jul 10, 2025

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Dart (8,171 stars) (552 forks)batch import
P3enhancementgood first issue

Description

如下图，在 ColorOS 15 系统下，无论在什么界面，手势线背景都显示为黑色；

Image

在 小米澎湃OS2 系统下的取色也有问题，手势线背景色无法和应用的背景保持一致。

Image

建议参考 Google (https://developer.android.google.cn/codelabs/gesture-navigation) 和小米澎湃OS (https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1629) 的相关文档，为 Android 机型适配手势线沉浸特性，辛苦作者大大了！

Contributor guide

Tech stack
android
Domain
mobile
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Flutter basicsAndroid UI insets
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
The issue concerns Android gesture navigation bar (手势线) not adapting to the app's background color on ColorOS and HyperOS. Research should focus on Flutter's SystemChrome API for system UI overlay, particularly `SystemChrome.setSystemUIOverlayStyle`, and Android's window insets for gesture navigation. Refer to Google's gesture navigation codelab and Xiaomi's HyperOS documentation provided in the issue. The fix likely involves detecting the system navigation bar color and setting it dynamically. Look into existing Flutter packages like 'system ui overlay' or 'edge to edge' for reference.