[feat]键盘教程引导页，增加悬浮窗权限、是否选择键盘的检查功能

assets/string/base/string.xml

@@ -220,6 +220,9 @@
     <string name="discount_dialog_character">百种人设</string>
     <string name="discount_dialog_social">扩大社交</string>
 
+    <string name="tutorial_enable_keyboard_step">1.启用键盘</string>
+    <string name="tutorial_enable_floating_ball_step">2.开启悬浮球</string>
+
     <string name="profile_save">完成</string>
     <string name="profile_edit_save">保存</string>
     <string name="profile_list">档案列表</string>

lib/di/get_it.config.dart

@@ -70,6 +70,7 @@ import '../module/intro/intro_controller.dart' as _i211;
 import '../module/keyboard/keyboard_controller.dart' as _i161;
 import '../module/keyboard_guide/keyboard_guide_controller.dart' as _i248;
 import '../module/keyboard_manage/keyboard_manage_controller.dart' as _i922;
+import '../module/keyboard_tutorial/keyboard_tutorial_controller.dart' as _i507;
 import '../module/login/login_controller.dart' as _i1008;
 import '../module/main/main_controller.dart' as _i731;
 import '../module/mine/mine_controller.dart' as _i732;
@@ -135,6 +136,9 @@ extension GetItInjectableX on _i174.GetIt {
       () => _i1060.ZodiacLoveIntimacyController(),
     );
     gh.factory<_i211.IntroController>(() => _i211.IntroController());
+    gh.factory<_i507.KeyboardTutorialController>(
+          () => _i507.KeyboardTutorialController(),
+    );
     gh.lazySingleton<_i495.WechatLoginService>(
       () => _i495.WechatLoginService(),
     );

lib/module/keyboard_guide/keyboard_guide_page.dart

@@ -19,10 +19,16 @@ import 'enums/keyboard_guide_msg_type.dart';
 class KeyboardGuidePage extends BasePage<KeyboardGuidePageController> {
   const KeyboardGuidePage({super.key});
 
+  /// 跳转到键盘引导页
   static void start() {
     Get.toNamed(RoutePath.keyboardGuide);
   }
 
+  /// 跳转并关闭当前页
+  static void startAndOffMe() {
+    Get.offNamed(RoutePath.keyboardGuide);
+  }
+
   @override
   immersive() {
     return false;

lib/module/keyboard_tutorial/keyboard_tutorial_controller.dart

@@ -0,0 +1,77 @@
+import 'package:get/get.dart';
+import 'package:injectable/injectable.dart';
+import 'package:keyboard/base/base_controller.dart';
+import 'package:keyboard/module/keyboard_guide/keyboard_guide_page.dart';
+
+import '../../plugins/keyboard_android_platform.dart';
+
+/// 键盘使用教程-引导页Controller
+@injectable
+class KeyboardTutorialController extends BaseController {
+  /// 键盘是否启用
+  Rx<bool> isKeyboardEnable = false.obs;
+
+  /// 悬浮球是否启用
+  Rx<bool> isFloatingWindowEnable = false.obs;
+
+  /// 是否步骤都允许了
+  bool get isStepComplete =>
+      isKeyboardEnable.value && isFloatingWindowEnable.value;
+
+  @override
+  void onInit() {
+    super.onInit();
+    checkSetting();
+  }
+
+  /// 检查设置
+  void checkSetting() {
+    // 检查键盘是否启用
+    KeyboardAndroidPlatform.isTargetKeyboardEnabled().then((enable) {
+      isKeyboardEnable.value = enable;
+    });
+    // 检查是否有悬浮窗权限
+    KeyboardAndroidPlatform.hasFloatingWindowPermission().then((hasPermission) {
+      isFloatingWindowEnable.value = hasPermission;
+      // 有权限，则启动悬浮窗
+      if (hasPermission) {
+        KeyboardAndroidPlatform.enableFloatingWindow(true);
+      }
+    });
+  }
+
+  /// 点击返回
+  void clickBack() {
+    Get.back();
+  }
+
+  /// 点击跳过
+  void clickSkip() {
+    Get.back();
+  }
+
+  /// 去启用键盘
+  void goEnableKeyboard() {
+    KeyboardAndroidPlatform.openInputMethodSettings();
+  }
+
+  /// 去启用悬浮窗
+  void jumpFloatingWindowSetting() {
+    KeyboardAndroidPlatform.jumpFloatingWindowSetting();
+  }
+
+  /// 跳转到键盘引导页
+  void jump2KeyboardGuide() {
+    KeyboardGuidePage.startAndOffMe();
+  }
+
+  /// 检查，是否步骤都完成了
+  bool checkHasComplete() {
+    // 都完成了，则跳转到键盘引导页
+    if (isStepComplete) {
+      jump2KeyboardGuide();
+      return true;
+    }
+    return false;
+  }
+}

lib/module/keyboard_tutorial/keyboard_tutorial_page.dart

@@ -0,0 +1,250 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:get/get.dart';
+import 'package:keyboard/base/base_page.dart';
+import 'package:keyboard/resource/colors.gen.dart';
+import 'package:keyboard/resource/string.gen.dart';
+import 'package:keyboard/router/app_pages.dart';
+import 'package:lottie/lottie.dart';
+
+import '../../resource/assets.gen.dart';
+import '../../utils/status_bar_util.dart';
+import '../../widget/app_lifecycle_widget.dart';
+import '../../widget/gradient_btn.dart';
+import 'keyboard_tutorial_controller.dart';
+
+/// 键盘使用教程-引导页
+class KeyboardTutorialPage extends BasePage<KeyboardTutorialController> {
+  const KeyboardTutorialPage({super.key});
+
+  static start() {
+    Get.toNamed(RoutePath.keyboardTutorial);
+  }
+
+  @override
+  bool immersive() {
+    // 开启沉浸式
+    return true;
+  }
+
+  @override
+  backgroundColor() {
+    return Color(0xFFF6F5FA);
+  }
+
+  @override
+  Widget buildBody(BuildContext context) {
+    return Scaffold(
+      backgroundColor: backgroundColor(),
+      body: AppLifecycleWidget(
+        onAppLifecycleCallback: (isForeground) {
+          // 步骤都做完了，则跳转去键盘引导页
+          if (controller.checkHasComplete()) {
+            return;
+          }
+          // 未完成，则每次切换到前台时，重新检查设置，更新按钮状态
+          if (isForeground) {
+            controller.checkSetting();
+          }
+        },
+        child: Stack(
+          children: [
+            // 头部
+            Positioned(left: 0, top: 0, right: 0, child: _buildHeader()),
+            // 状态栏和标题栏
+            Positioned(
+              left: 0,
+              top: 0,
+              right: 0,
+              child: Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [_buildStatusBar(), _buildTopBar()],
+              ),
+            ),
+            // 内容，填充剩余部分
+            Positioned.fill(
+              top: 235.h + StatusBarUtil.getStatusBarHeight(Get.context!),
+              left: 0,
+              right: 0,
+              child: Column(children: [_buildContent()]),
+            ),
+            // 底部按钮
+            Positioned(
+              left: 0,
+              right: 0,
+              bottom: 0,
+              child: _buildBottomActionBtn(),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  /// 导航栏占位
+  Widget _buildStatusBar() {
+    // 导航栏高度
+    double statusBarHeight = StatusBarUtil.getStatusBarHeight(Get.context!);
+    return Container(height: statusBarHeight);
+  }
+
+  /// 顶部栏
+  Widget _buildTopBar() {
+    return Container(
+      // 宽度撑满父组件
+      width: double.infinity,
+      height: kToolbarHeight,
+      // 背景颜色
+      color: Colors.transparent,
+      // padding: EdgeInsets.symmetric(horizontal: 16.0),
+      child: ConstrainedBox(
+        // 设置宽度为无限大，撑满父组件，否则Stack获取不到高度，会报错
+        constraints: BoxConstraints(minWidth: double.infinity),
+        child: Stack(
+          alignment: Alignment.center,
+          children: [
+            // 返回按钮
+            Positioned(
+              left: 16.w,
+              child: GestureDetector(
+                onTap: controller.clickBack,
+                child: Assets.images.iconBlackBackArrow.image(
+                  width: 24.w,
+                  height: 24.h,
+                ),
+              ),
+            ),
+            // 跳过按钮
+            Positioned(
+              right: 16.w,
+              child: GestureDetector(
+                onTap: () {
+                  controller.clickSkip();
+                },
+                child: Text(
+                  StringName.skip,
+                  style: TextStyle(
+                    color: ColorName.black85,
+                    fontSize: 14.sp,
+                    fontWeight: FontWeight.w500,
+                  ),
+                ),
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  /// 头部布局
+  Widget _buildHeader() {
+    return SizedBox(
+      width: double.infinity,
+      height: 298.h,
+      child: Stack(
+        alignment: Alignment.center,
+        children: [
+          // 头像
+          Positioned(
+            top: 37.5.h,
+            bottom: 86.5.h,
+            child: Assets.images.iconKeyboardTutorialHeader.image(
+              height: 174.h,
+              fit: BoxFit.cover,
+            ),
+          ),
+          // 蒙版
+          Assets.images.bgKeyboardTutorialHeaderMask.image(
+            width: double.infinity,
+            height: double.infinity,
+          ),
+          // 提示语
+          Positioned(
+            bottom: 60.h,
+            child: Assets.images.iconKeyboardTutorialHeaderSlogan.image(
+              width: 200.w,
+              height: 73.h,
+            ),
+          ),
+        ],
+      ),
+    );
+  }
+
+  /// 内容
+  Widget _buildContent() {
+    return Expanded(child: Column(children: [_buildTutorialAnimation()]));
+  }
+
+  /// 键盘设置引导动画
+  Widget _buildTutorialAnimation() {
+    return Lottie.asset(
+      Assets.anim.animKeyboardTutorialSetting,
+      repeat: true,
+      width: 340.w,
+    );
+  }
+
+  /// 启用键盘按钮
+  Widget _buildEnableKeyboard() {
+    return Obx(() {
+      return Container(
+        margin: EdgeInsets.symmetric(horizontal: 50.w),
+        child: GradientTextBtn(
+          // 是否启用，这里UI设计上，未启用时要高亮按钮，所以要取反
+          enable: !controller.isKeyboardEnable.value,
+          StringName.tutorialEnableKeyboardStep,
+          onPressed: () {
+            // 已启用，不响应点击
+            if (controller.isKeyboardEnable.value) {
+              return;
+            }
+            // 去启用键盘
+            controller.goEnableKeyboard();
+          },
+        ),
+      );
+    });
+  }
+
+  /// 悬浮球设置按钮
+  Widget _buildFloatingBallActionBtn() {
+    return Obx(() {
+      bool isKeyboardEnable = controller.isKeyboardEnable.value;
+      bool isFloatingWindowEnable = controller.isFloatingWindowEnable.value;
+      // 启用了键盘，但悬浮窗权限未获取到，则高亮按钮
+      bool isHighlightBtn = isKeyboardEnable && !isFloatingWindowEnable;
+      return Container(
+        margin: EdgeInsets.symmetric(horizontal: 50.w),
+        child: GradientTextBtn(
+          enable: isHighlightBtn,
+          StringName.tutorialEnableFloatingBallStep,
+          onPressed: () {
+            // 已获取，不响应点击
+            if (controller.isFloatingWindowEnable.value) {
+              return;
+            }
+            // 去启用悬浮球
+            controller.jumpFloatingWindowSetting();
+          },
+        ),
+      );
+    });
+  }
+
+  /// 底部操作按钮
+  Widget _buildBottomActionBtn() {
+    return Column(
+      children: [
+        // 启用键盘
+        _buildEnableKeyboard(),
+        SizedBox(height: 20.h),
+        // 启用悬浮球
+        _buildFloatingBallActionBtn(),
+        // 距离底部一定距离
+        SizedBox(height: 25.h),
+      ],
+    );
+  }
+}

lib/module/mine/mine_controller.dart

@@ -26,8 +26,10 @@ import '../../plugins/keyboard_method_handler.dart';
 import '../../resource/colors.gen.dart';
 import '../../utils/app_info_util.dart';
 import '../browser/browser_page.dart';
+import '../../utils/keyboard_tutorial_util.dart';
 import '../intimacy_analyse/intimacy_analyse_page.dart';
 import '../keyboard_guide/keyboard_guide_page.dart';
+import '../keyboard_tutorial/keyboard_tutorial_page.dart';
 import '../new_user/result/new_user_result_page.dart';
 import '../profile/profile_page.dart';
 import '../store/discount/discount_controller.dart';
@@ -112,9 +114,12 @@ class MineController extends BaseController {
 
   clickTutorials() {
     debugPrint('clickTutorials');
-    NewUserPage.start();
+    KeyboardTutorialUtil.start();
   }
 
+  longClickTutorials() {
+    // NewUserPage.start();
+  }
 
 
   clickPersonalProfile() {

lib/plugins/keyboard_android_platform.dart

@@ -34,19 +34,31 @@ class KeyboardAndroidPlatform {
     }
   }
 
-  // 打开/关闭悬浮窗
+  /// 打开/关闭悬浮窗
   static void enableFloatingWindow(bool enable) {
     debugPrint('enableFloatingWindow $enable');
     _keyboardAndroidService.enableFloatingWindow(enable);
   }
 
-  // 打开输入法设置
+  /// 跳转到系统的悬浮窗设置页
+  static void jumpFloatingWindowSetting() {
+    debugPrint('jumpFloatingWindowSetting');
+    _keyboardAndroidService.jumpFloatingWindowSetting();
+  }
+
+  /// 是否有悬浮窗权限
+  static Future<bool> hasFloatingWindowPermission() {
+    debugPrint('hasFloatingWindowPermission');
+    return _keyboardAndroidService.hasFloatingWindowPermission();
+  }
+
+  /// 打开输入法设置
   static void openInputMethodSettings() {
     debugPrint('openInputMethodSettings');
     _keyboardAndroidService.openInputMethodSettings();
   }
 
-  //是否启用目标输入法
+  /// 是否启用目标输入法
   static Future<bool> isTargetKeyboardEnabled() async {
     final result = await _keyboardAndroidService.isTargetKeyboardEnabled();
     debugPrint('isTargetKeyboardEnabled value: $result');

lib/plugins/keyboard_android_service.dart

@@ -7,6 +7,14 @@ class KeyboardAndroidService {
     _plugin.enableFloatingWindow(enable);
   }
 
+  void jumpFloatingWindowSetting() {
+    _plugin.jumpFloatingWindowSetting();
+  }
+
+  Future<bool> hasFloatingWindowPermission() {
+    return _plugin.hasFloatingWindowPermission();
+  }
+
   void openInputMethodSettings() {
     _plugin.openInputMethodSettings();
   }

lib/resource/assets.gen.dart

@@ -30,6 +30,14 @@ class $AssetsAnimGen {
   String get animKeyboardGeneratingData =>
       'assets/anim/anim_keyboard_generating_data.json';
 
+  /// File path: assets/anim/anim_keyboard_floating_window_choose_keyboard.json
+  String get animKeyboardFloatingWindowChooseKeyboard =>
+      'assets/anim/anim_keyboard_floating_window_choose_keyboard.json';
+
+  /// File path: assets/anim/anim_keyboard_tutorial_setting.json
+  String get animKeyboardTutorialSetting =>
+      'assets/anim/anim_keyboard_tutorial_setting.json';
+
   /// File path: assets/anim/anim_new_user_data.json
   String get animNewUserData => 'assets/anim/anim_new_user_data.json';
 
@@ -59,6 +67,8 @@ class $AssetsAnimGen {
     animIntroFirstData,
     animIntroSecondData,
     animKeyboardGeneratingData,
+    animKeyboardFloatingWindowChooseKeyboard,
+    animKeyboardTutorialSetting,
     animNewUserData,
     animSurpriseDialogData,
     animTabCharacterSelectedData,
@@ -202,6 +212,11 @@ class $AssetsImagesGen {
   AssetGenImage get bgKeyboardScreenshotReply =>
       const AssetGenImage('assets/images/bg_keyboard_screenshot_reply.webp');
 
+  /// File path: assets/images/bg_keyboard_tutorial_header_mask.webp
+  AssetGenImage get bgKeyboardTutorialHeaderMask => const AssetGenImage(
+    'assets/images/bg_keyboard_tutorial_header_mask.webp',
+  );
+
   /// File path: assets/images/bg_login.webp
   AssetGenImage get bgLogin =>
       const AssetGenImage('assets/images/bg_login.webp');
@@ -329,6 +344,10 @@ class $AssetsImagesGen {
   AssetGenImage get iconBlackBack =>
       const AssetGenImage('assets/images/icon_black_back.webp');
 
+  /// File path: assets/images/icon_black_back_arrow.webp
+  AssetGenImage get iconBlackBackArrow =>
+      const AssetGenImage('assets/images/icon_black_back_arrow.webp');
+
   /// File path: assets/images/icon_cancer.webp
   AssetGenImage get iconCancer =>
       const AssetGenImage('assets/images/icon_cancer.webp');
@@ -770,6 +789,15 @@ class $AssetsImagesGen {
   AssetGenImage get iconKeyboardTriangle =>
       const AssetGenImage('assets/images/icon_keyboard_triangle.webp');
 
+  /// File path: assets/images/icon_keyboard_tutorial_header.webp
+  AssetGenImage get iconKeyboardTutorialHeader =>
+      const AssetGenImage('assets/images/icon_keyboard_tutorial_header.webp');
+
+  /// File path: assets/images/icon_keyboard_tutorial_header_slogan.webp
+  AssetGenImage get iconKeyboardTutorialHeaderSlogan => const AssetGenImage(
+    'assets/images/icon_keyboard_tutorial_header_slogan.webp',
+  );
+
   /// File path: assets/images/icon_keyboard_vip_logo.webp
   AssetGenImage get iconKeyboardVipLogo =>
       const AssetGenImage('assets/images/icon_keyboard_vip_logo.webp');
@@ -1206,6 +1234,7 @@ class $AssetsImagesGen {
     bgKeyboardManage,
     bgKeyboardManageIntimacy,
     bgKeyboardScreenshotReply,
+    bgKeyboardTutorialHeaderMask,
     bgLogin,
     bgLoginDialog,
     bgMine,
@@ -1238,6 +1267,7 @@ class $AssetsImagesGen {
     iconAries,
     iconArrowRight,
     iconBlackBack,
+    iconBlackBackArrow,
     iconCancer,
     iconCapricorn,
     iconChangeCharacterEmpty,
@@ -1340,6 +1370,8 @@ class $AssetsImagesGen {
     iconKeyboardScreenshotTitle,
     iconKeyboardTitle,
     iconKeyboardTriangle,
+    iconKeyboardTutorialHeader,
+    iconKeyboardTutorialHeaderSlogan,
     iconKeyboardVipLogo,
     iconLeo,
     iconLibra,

lib/resource/string.gen.dart

@@ -162,6 +162,8 @@ class StringName {
   static final String discountDialogTutorial = 'discount_dialog_tutorial'.tr; // 恋爱教程
   static final String discountDialogCharacter = 'discount_dialog_character'.tr; // 百种人设
   static final String discountDialogSocial = 'discount_dialog_social'.tr; // 扩大社交
+  static final String tutorialEnableKeyboardStep = 'tutorial_enable_keyboard_step'.tr; // 1.启用键盘
+  static final String tutorialEnableFloatingBallStep = 'tutorial_enable_floating_ball_step'.tr; // 2.开启悬浮球
   static final String profileSave = 'profile_save'.tr; // 完成
   static final String profileEditSave = 'profile_edit_save'.tr; // 保存
   static final String profileList = 'profile_list'.tr; // 档案列表
@@ -482,6 +484,8 @@ class StringMultiSource {
       'discount_dialog_tutorial': '恋爱教程',
       'discount_dialog_character': '百种人设',
       'discount_dialog_social': '扩大社交',
+      'tutorial_enable_keyboard_step': '1.启用键盘',
+      'tutorial_enable_floating_ball_step': '2.开启悬浮球',
       'profile_save': '完成',
       'profile_edit_save': '保存',
       'profile_list': '档案列表',

lib/router/app_pages.dart

@@ -61,6 +61,8 @@ import '../module/intro/intro_page.dart';
 import '../module/keyboard_guide/keyboard_guide_controller.dart';
 import '../module/keyboard_guide/keyboard_guide_page.dart';
 import '../module/keyboard_manage/keyboard_manage_page.dart';
+import '../module/keyboard_tutorial/keyboard_tutorial_controller.dart';
+import '../module/keyboard_tutorial/keyboard_tutorial_page.dart';
 import '../module/login/login_page.dart';
 import '../module/main/main_controller.dart';
 import '../module/main/main_page.dart';
@@ -127,6 +129,9 @@ abstract class RoutePath {
 
 //   亲密度刻度调节
   static const intimacyScale = '/intimacyScale';
+
+  // 键盘使用教程引导页
+  static const keyboardTutorial = '/keyboardTutorial';
 }
 
 class AppBinding extends Bindings {
@@ -176,6 +181,7 @@ class AppBinding extends Bindings {
     lazyPut(() => getIt.get<IntimacyGenerateCharacterEditController>());
     lazyPut(() => getIt.get<ZodiacLoveIntimacyController>());
     lazyPut(() => getIt.get<IntimacyScaleController>());
+    lazyPut(() => getIt.get<KeyboardTutorialController>());
   }
 
   void lazyPut<S>(InstanceBuilderCallback<S> builder) {
@@ -233,4 +239,8 @@ final generalPages = [
   ),
   GetPage(name: RoutePath.intro, page: () => IntroPage()),
   GetPage(name: RoutePath.intimacyScale, page: () => IntimacyScalePage()),
+  GetPage(
+    name: RoutePath.keyboardTutorial,
+    page: () => KeyboardTutorialPage(),
+  ),
 ];

lib/utils/keyboard_tutorial_util.dart

@@ -0,0 +1,29 @@
+import '../module/keyboard_guide/keyboard_guide_page.dart';
+import '../module/keyboard_tutorial/keyboard_tutorial_page.dart';
+import '../plugins/keyboard_android_platform.dart';
+
+/// 键盘教程工具类
+class KeyboardTutorialUtil {
+  /// 跳转方法
+  static void start() async {
+    bool isComplete = await _isTutorialComplete();
+    if (isComplete) {
+      // 如果完成了教程，则跳转到键盘引导页
+      KeyboardGuidePage.start();
+    } else {
+      // 如果没有完成教程，则跳转到键盘教程页
+      KeyboardTutorialPage.start();
+    }
+  }
+
+  /// 是否完成了教程
+  static Future<bool> _isTutorialComplete() async {
+    // 是否有悬浮窗权限
+    bool hasFloatingWindowPermission =
+        await KeyboardAndroidPlatform.hasFloatingWindowPermission();
+    // 是否启用了键盘
+    bool hasIsUseKeyboard =
+        await KeyboardAndroidPlatform.isTargetKeyboardEnabled();
+    return hasFloatingWindowPermission && hasIsUseKeyboard;
+  }
+}

lib/utils/status_bar_util.dart

@@ -0,0 +1,9 @@
+import 'package:flutter/cupertino.dart';
+
+/// 状态栏工具类
+class StatusBarUtil {
+  /// 获取状态栏高度
+  static double getStatusBarHeight(BuildContext context) {
+    return MediaQuery.of(context).padding.top;
+  }
+}

lib/widget/app_lifecycle_widget.dart

@@ -0,0 +1,62 @@
+import 'package:flutter/cupertino.dart';
+
+/// App前台、后台切换时回调
+/// [isForeground] 是否前台
+typedef OnAppLifecycleChangeCallback = void Function(bool isForeground);
+
+/// 监听App前后台的组件
+class AppLifecycleWidget extends StatefulWidget {
+  /// 子组件
+  final Widget child;
+
+  final OnAppLifecycleChangeCallback? onAppLifecycleCallback;
+
+  const AppLifecycleWidget({
+    super.key,
+    required this.child,
+    this.onAppLifecycleCallback,
+  });
+
+  @override
+  State<StatefulWidget> createState() {
+    return _AppLifecycleWidgetState();
+  }
+}
+
+class _AppLifecycleWidgetState extends State<AppLifecycleWidget>
+    with WidgetsBindingObserver {
+  @override
+  void initState() {
+    super.initState();
+    // 添加App生命周期监听
+    WidgetsBinding.instance.addObserver(this);
+  }
+
+  @override
+  void dispose() {
+    // 移除App生命周期监听
+    WidgetsBinding.instance.removeObserver(this);
+    super.dispose();
+  }
+
+  @override
+  void didChangeAppLifecycleState(AppLifecycleState state) {
+    super.didChangeAppLifecycleState(state);
+    // 切换到前台
+    if (state == AppLifecycleState.resumed) {
+      if (widget.onAppLifecycleCallback != null) {
+        widget.onAppLifecycleCallback!(true);
+      }
+    } else if (state == AppLifecycleState.paused) {
+      // 切换到后台
+      if (widget.onAppLifecycleCallback != null) {
+        widget.onAppLifecycleCallback!(false);
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return widget.child;
+  }
+}

lib/widget/gradient_btn.dart

@@ -11,6 +11,9 @@ class GradientBtn extends StatelessWidget {
   /// 纯色颜色
   final Color? color;
 
+  /// 是否启用
+  final bool enable;
+
   /// 渐变颜色参数
   final List<Color> colors;
 
@@ -34,6 +37,7 @@ class GradientBtn extends StatelessWidget {
     super.key,
     required this.colors,
     this.color,
+    this.enable = true,
     this.begin = Alignment.centerLeft,
     this.end = Alignment.centerRight,
     this.radius = 50,
@@ -60,16 +64,43 @@ class GradientBtn extends StatelessWidget {
         ),
       );
     }
-    return GestureDetector(
-      onTap: () {
-        onPressed();
-      },
-      child: Container(
-        padding: padding,
-        width: double.maxFinite,
-        // 渐变背景
-        decoration: decoration,
-        child: Center(child: child),
+    return Center(
+      child: GestureDetector(
+        onTap: () {
+          onPressed();
+        },
+        child: Stack(
+          children: [
+            Container(
+              padding: padding,
+              width: double.maxFinite,
+              // 渐变背景
+              decoration: decoration,
+              child: child,
+            ),
+            // 禁用状态的蒙层
+            Positioned(
+              left: 0,
+              top: 0,
+              right: 0,
+              bottom: 0,
+              child: !enable ? _buildDisableMask() : SizedBox.shrink(),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  /// 禁用状态的蒙层
+  Widget _buildDisableMask() {
+    return Container(
+      // 宽和高，都匹配父组件
+      width: double.infinity,
+      height: double.infinity,
+      decoration: BoxDecoration(
+        color: ColorName.white.withOpacity(0.8),
+        borderRadius: BorderRadius.all(Radius.circular(radius)),
       ),
     );
   }
@@ -83,6 +114,9 @@ class GradientTextBtn extends StatelessWidget {
   /// 按钮文字
   final String text;
 
+  /// 是否启用
+  final bool enable;
+
   /// 描述文字
   final String? desc;
 
@@ -145,6 +179,7 @@ class GradientTextBtn extends StatelessWidget {
     this.leftIcon,
     this.desc,
     this.color,
+    this.enable = true,
     this.colors = const [ColorName.purpleGradient3, ColorName.purpleGradient4],
     this.begin = Alignment.centerLeft,
     this.end = Alignment.centerRight,
@@ -162,6 +197,7 @@ class GradientTextBtn extends StatelessWidget {
       radius: radius,
       onPressed: onPressed,
       padding: padding,
+      enable: enable,
       child: Column(
         children: [
           Row(

plugins/keyboard_android/lib/keyboard_android.dart

@@ -11,6 +11,16 @@ class KeyboardAndroid {
     return KeyboardAndroidPlatform.instance.enableFloatingWindow(enable);
   }
 
+  /// 跳转到系统的悬浮窗设置页
+  Future<void> jumpFloatingWindowSetting() async {
+    return KeyboardAndroidPlatform.instance.jumpFloatingWindowSetting();
+  }
+
+  /// 是否有悬浮窗权限
+  Future<bool> hasFloatingWindowPermission() async {
+    return KeyboardAndroidPlatform.instance.hasFloatingWindowPermission();
+  }
+
   /// 打开输入法设置
   Future<void> openInputMethodSettings() async {
     return KeyboardAndroidPlatform.instance.openInputMethodSettings();

plugins/keyboard_android/lib/keyboard_android_method_channel.dart

@@ -25,6 +25,17 @@ class MethodChannelKeyboardAndroid extends KeyboardAndroidPlatform {
   }
 
   @override
+  Future<void> jumpFloatingWindowSetting() async {
+    await methodChannel.invokeMethod('jumpFloatingWindowSetting');
+  }
+
+  @override
+  Future<bool> hasFloatingWindowPermission() async {
+    return await methodChannel.invokeMethod('hasFloatingWindowPermission') ??
+        false;
+  }
+
+  @override
   Future<void> openInputMethodSettings() async {
     await methodChannel.invokeMethod('openInputMethodSettings');
   }
@@ -35,7 +46,6 @@ class MethodChannelKeyboardAndroid extends KeyboardAndroidPlatform {
         false;
   }
 
-
   // /// 获取键映射
   // @override
   // Future<List<Map<String, String>>> getKeyMappings() async {

plugins/keyboard_android/lib/keyboard_android_platform_interface.dart

@@ -29,7 +29,19 @@ abstract class KeyboardAndroidPlatform extends PlatformInterface {
 
   Future<void> enableFloatingWindow(bool enable) {
     throw UnimplementedError(
-      ' enableFloatingWindow(bool enable) has not been implemented.',
+      'enableFloatingWindow(bool enable) has not been implemented.',
+    );
+  }
+
+  void jumpFloatingWindowSetting() {
+    throw UnimplementedError(
+      'jumpFloatingWindowSetting() has not been implemented.',
+    );
+  }
+
+  Future<bool> hasFloatingWindowPermission() {
+    throw UnimplementedError(
+      'hasFloatingWindowPermission() has not been implemented.',
     );
   }
 
@@ -45,9 +57,6 @@ abstract class KeyboardAndroidPlatform extends PlatformInterface {
     );
   }
 
-
-
-
   // /// 获取键映射（需要在 `MethodChannelKeyboardAndroid` 实现）
   // Future<List<Map<String, String>>> getKeyMappings() {
   //   throw UnimplementedError('getKeyMappings() has not been implemented.');

plugins/keyboard_android/test/keyboard_android_test.dart

@@ -24,6 +24,16 @@ class MockKeyboardAndroidPlatform
   Future<void> openInputMethodSettings() {
     throw UnimplementedError();
   }
+
+  @override
+  Future<bool> hasFloatingWindowPermission() {
+    throw UnimplementedError();
+  }
+
+  @override
+  void jumpFloatingWindowSetting() {
+    throw UnimplementedError();
+  }
 }
 
 void main() {