permissionRequestPage.dart 6.1 KB
import 'dart:io';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:permission_handler/permission_handler.dart';

import '../../utils/log_util.dart';

/// 权限检查及请求
/// 外部可通过此方法来进行权限的检查和请求,将自动跳转到`PermissionRequestPage`页面。
/// 传入 `Permission` 以及对应的权限名称 `permissionTypeStr`,如果有权限则返回 `Future true`
/// `isRequiredPermission` 如果为 `true`,则 "取消" 按钮将执行 "退出app" 的操作
Future<bool> permissionCheckAndRequest(
    BuildContext context,
    Permission permission,
    String permissionTypeStr,
    {bool isRequiredPermission = false}) async {
  if (!await permission.status.isGranted) {
    await Navigator.of(context).push(PageRouteBuilder(
        opaque: false,
        pageBuilder: ((context, animation, secondaryAnimation) {
          return PermissionRequestPage(permission, permissionTypeStr,
              isRequiredPermission: isRequiredPermission);
        })));
  } else {
    return true;
  }
  return false;
}

class PermissionRequestPage extends StatefulWidget {
  const PermissionRequestPage(this.permission, this.permissionTypeStr,
      {super.key, this.isRequiredPermission = false});

  final Permission permission;
  final String permissionTypeStr;
  final bool isRequiredPermission;

  @override
  State<PermissionRequestPage> createState() => _PermissionRequestPageState();
}

class _PermissionRequestPageState extends State<PermissionRequestPage>
    with WidgetsBindingObserver {
  bool _isGoSetting = false;
  late final List<String> msgList;
  bool _isDialogShowing = false;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    msgList = [
      "${widget.permissionTypeStr}功能需要获取您设备的${widget.permissionTypeStr}权限,否则可能无法正常工作。\n是否申请${widget.permissionTypeStr}权限?",
      "${widget.permissionTypeStr}权限不全,是否重新申请权限?",
      "没有${widget.permissionTypeStr}权限,您可以手动开启权限",
      widget.isRequiredPermission ? "退出应用" : "取消"
    ];
    _checkPermission(widget.permission);
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    Log.d("didChangeAppLifecycleState state=$state _isGoSetting=$_isGoSetting");
    // 监听 app 从后台切回前台
    if (state == AppLifecycleState.resumed && _isGoSetting) {
      _checkPermission(widget.permission);
    }
  }

  /// 校验权限
  void _checkPermission(Permission permission) async {
    final PermissionStatus status = await permission.status;
    _handlePermissionStatus(permission, status);
  }

  void _handlePermissionStatus(Permission permission, PermissionStatus status) {
    Log.d('_handlePermissionStatus=$status permission=$permission');
    if (status.isGranted) {
      _popPage();
      return;
    }

    // 还未申请权限或之前拒绝了权限(在 iOS 上为首次申请权限,拒绝后将变为 `永久拒绝权限`)
    if (status.isDenied) {
      showAlert(
          permission, msgList[0], msgList[3], _isGoSetting ? "前往系统设置" : "确定");
    }
    // 权限已被永久拒绝
    if (status.isPermanentlyDenied) {
      _isGoSetting = true;
      showAlert(
          permission, msgList[2], msgList[3], _isGoSetting ? "前往系统设置" : "确定");
    }
    // 拥有部分权限
    if (status.isLimited) {
      if (Platform.isIOS || Platform.isMacOS) _isGoSetting = true;
      showAlert(
          permission, msgList[1], msgList[3], _isGoSetting ? "前往系统设置" : "确定");
    }
    // 拥有部分权限,活动限制(例如,设置了家长///控件,仅在iOS以上受支持。(仅限 iOS)
    if (status.isRestricted) {
      if (Platform.isIOS || Platform.isMacOS) _isGoSetting = true;
      showAlert(
          permission, msgList[1], msgList[3], _isGoSetting ? "前往系统设置" : "确定");
    }
  }

  void showAlert(Permission permission, String message, String cancelMsg,
      String confirmMsg) {
    if (_isDialogShowing) {
      // 对话框已经在显示中,不重复弹出
      Log.d("对话框已经在显示中,不重复弹出");
      return;
    }
    _isDialogShowing = true;
    showDialog(
        context: context,
        builder: (context) {
          return AlertDialog(
            title: const Text("温馨提示"),
            content: Text(message),
            actions: [
              TextButton(
                  child: Text(cancelMsg),
                  onPressed: () {
                    widget.isRequiredPermission
                        ? _quitApp()
                        : _popDialogAndPage(context);
                  }),
              TextButton(
                  child: Text(confirmMsg),
                  onPressed: () {
                    if (_isGoSetting) {
                      openAppSettings();
                    } else {
                      _requestPermisson(permission);
                    }
                    _popDialog(context);
                  })
            ],
          );
        }).then((value) => {
          _isDialogShowing = false,
    });
  }

  /// 申请权限
  void _requestPermisson(Permission permission) async {
    // 申请权限
    PermissionStatus status = await permission.request();
    Log.d('requestPermisson权限检测=$status _isGoSetting=$_isGoSetting');
    // 再次校验
    _handlePermissionStatus(permission, status);
  }

  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Container();
  }

  /// 退出应用程序
  void _quitApp() {
    SystemChannels.platform.invokeMethod("SystemNavigator.pop");
  }

  /// 关闭整个权限申请页面
  void _popDialogAndPage(BuildContext dialogContext) {
    _popDialog(dialogContext);
    _popPage();
  }

  /// 关闭弹窗
  void _popDialog(BuildContext dialogContext) {
    Navigator.of(dialogContext).pop();
  }

  /// 关闭透明页面
  void _popPage() {
    Navigator.of(context).pop();
  }
}