【Flutter】手机权限检查和申请

╰+攻爆jí腚メ 2024-04-01 16:57 100阅读 0赞

## 0x1 【Flutter】手机权限检查和申请 ##

### 0x11 简介 ###

使用flutter进行app开发，一定会用到手机的部分权限，包括通知推送、定位、相册、存储、相机、麦克风等。

而权限的检查和获取，最受欢迎的就是通过permission\_handler这个插件来实现。

### 0x12 插件安装 ###

flutter pub add permission_handler

关于插件的具体内容，可以查看pub.dev [https://pub.dev/packages/permission\_handler][https_pub.dev_packages_permission_handler]

### 0x13 基本使用 ###

#### 0x131 获取权限状态 ####

var status = await Permission.notification.status;
    print(status);

status有以下几种值：

*  isDenied：
    
     *  在 iOS 上代表还未申请权限；
     *  在android上代表还未申请权限或之前拒绝了权限。
 *  isGranted：拥有全部权限。
 *  isLimited：拥有部分权限。
 *  isRestricted：拥有部分权限（仅限iOS）。
 *  isPermanentlyDenied：权限已被永久拒绝。

#### 0x132 申请权限 ####

通过调用 request() 来获取权限。在iOS上，首次申请权限才会自动弹出权限申请的对话框

// 申请通知权限：
    await Permission.notification.request();
    
    // 同时申请多个权限：
    await [
      Permission.notification,
      Permission.photos,
    ].request();

#### 0x133 用户拒绝权限请求后的处理 ####

**Android**：申请权限时，  
如果用户选择"拒绝"，status将保持为isDenied，以后可以再次调用request()来取得权限；

如果用户选择"拒绝并不再询问"，status将变为isPermanentlyDenied，即以后无法再调用request()来取得权限，必须去应用设置界面手动开启权限。

**iOS**：首次申请权限时，如果用户选择了"拒绝"，status将变为isPermanentlyDenied，即以后无法再调用request()来取得权限，必须去应用设置界面手动开启权限。

跳转到应用设置界面

openAppSettings();

### 0x14 封装 ###

为了方便权限的检查和请求，可以有两种方式进行封装：  
**封装成方法**  
在该方法内进行权限判断并弹窗来进行权限说明和操作。这种方式比较简单，但是有个弊端就是当用户去到应用设置界面操作权限后，返回应用时无法自动判断用户操作情况。所以推荐使用第二种方法。

**封装成一个页面**  
这个页面只有一个透明的Container，当需要进行权限判断时，导航至该页面，在这个页面创建时进行权限判断和操作。当用户去到应用设置界面操作权限后，返回应用时使用 WidgetsBindingObserver 的 didChangeAppLifecycleState(AppLifecycleState state) 方法来再次进行权限判断。以下为封装之后的文件 permission\_request.dart ，可直接复制粘贴后使用。

import 'dart:io';
    import 'package:flutter/cupertino.dart';
    import 'package:flutter/services.dart';
    import 'package:permission_handler/permission_handler.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;
    
      @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);
        // 监听 app 从后台切回前台
        if (state == AppLifecycleState.resumed && _isGoSetting) {
        
          checkPermission(widget.permission);
        }
      }
    
      /// 校验权限
      void checkPermission(Permission permission) async {
        
        final status = await permission.status;
        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)
        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) {
        
        showCupertinoDialog(
            context: context,
            builder: (context) {
        
              return CupertinoAlertDialog(
                title: const Text("温馨提示"),
                content: Text(message),
                actions: [
                  CupertinoDialogAction(
                      child: Text(cancelMsg),
                      onPressed: () {
        
                        widget.isRequiredPermission
                            ? _quitApp()
                            : _popDialogAndPage(context);
                      }),
                  CupertinoDialogAction(
                      child: Text(confirmMsg),
                      onPressed: () {
        
                        if (_isGoSetting) {
        
                          openAppSettings();
                          _isGoSetting = true;
                        } else {
        
                          requestPermisson(permission);
                        }
                        _popDialog(context);
                      })
                ],
              );
            });
      }
    
      /// 申请权限
      void requestPermisson(Permission permission) async {
        
        // 申请权限
        await permission.request();
        // 再次校验
        checkPermission(permission);
      }
    
      @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();
      }
    }

AndroidManifest.xml

`mediaflutter/example/android/app/src/main/AndroidManifest.xml`

<uses-permission android:name="android.permission.CAMERA" />

在外部想要检查及获取权限的地方，调用permissionCheckAndRequest方法即可：

// 导入封装好的文件
    import 'package:xxxx/permission_request.dart';
    
    // ...其它代码
    
    ElevatedButton(
      onPressed: () async {
        
        // 调用封装好的权限检查和请求方法
        bool result = await permissionCheckAndRequest(
                              context, 
                              Permission.camera，
                               "相机"
                            );
        if (result) print("已拥有该权限");
      },
      child: const Text("权限检查")
    )

![在这里插入图片描述][a551cf984319476ca0ba7df98e3729d5.png]

[https_pub.dev_packages_permission_handler]: https://pub.dev/packages/permission_handler
[a551cf984319476ca0ba7df98e3729d5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/6d8f79c878cd48c195d74f7a894b0a43.png