快捷導(dǎo)航

Flutter手機權(quán)限檢查與申請實現(xiàn)方法詳解

更新時間：2022年11月15日 09:07:15 作者：后端碼匠

使用flutter進(jìn)行app開發(fā)，一定會用到手機的部分權(quán)限，包括通知推送、定位、相冊、存儲、相機、麥克風(fēng)等。而權(quán)限的檢查和獲取，最受歡迎的就是通過permission_handler這個插件來實現(xiàn)

手機權(quán)限檢查和申請

簡介

使用flutter進(jìn)行app開發(fā)，一定會用到手機的部分權(quán)限，包括通知推送、定位、相冊、存儲、相機、麥克風(fēng)等。

而權(quán)限的檢查和獲取，最受歡迎的就是通過permission_handler這個插件來實現(xiàn)。

插件安裝

flutter pub add permission_handler

關(guān)于插件的具體內(nèi)容，可以查看pub.dev https://pub.dev/packages/permission_handler

基本使用

獲取權(quán)限狀態(tài)

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

status有以下幾種值：

isDenied：

在 iOS 上代表還未申請權(quán)限；
在android上代表還未申請權(quán)限或之前拒絕了權(quán)限。

isGranted：擁有全部權(quán)限。

isLimited：擁有部分權(quán)限。

isRestricted：擁有部分權(quán)限（僅限iOS）。

isPermanentlyDenied：權(quán)限已被永久拒絕。

申請權(quán)限

通過調(diào)用 request() 來獲取權(quán)限。在iOS上，首次申請權(quán)限才會自動彈出權(quán)限申請的對話框

// 申請通知權(quán)限：
await Permission.notification.request();
// 同時申請多個權(quán)限：
await [
  Permission.notification,
  Permission.photos,
].request();

用戶拒絕權(quán)限請求后的處理

Android：申請權(quán)限時

如果用戶選擇"拒絕"，status將保持為isDenied，以后可以再次調(diào)用request()來取得權(quán)限；

如果用戶選擇"拒絕并不再詢問"，status將變?yōu)閕sPermanentlyDenied，即以后無法再調(diào)用request()來取得權(quán)限，必須去應(yīng)用設(shè)置界面手動開啟權(quán)限。

iOS：首次申請權(quán)限時，如果用戶選擇了"拒絕"，status將變?yōu)閕sPermanentlyDenied，即以后無法再調(diào)用request()來取得權(quán)限，必須去應(yīng)用設(shè)置界面手動開啟權(quán)限。

跳轉(zhuǎn)到應(yīng)用設(shè)置界面

openAppSettings();

封裝

為了方便權(quán)限的檢查和請求，可以有兩種方式進(jìn)行封裝：

封裝成方法

在該方法內(nèi)進(jìn)行權(quán)限判斷并彈窗來進(jìn)行權(quán)限說明和操作。這種方式比較簡單，但是有個弊端就是當(dāng)用戶去到應(yīng)用設(shè)置界面操作權(quán)限后，返回應(yīng)用時無法自動判斷用戶操作情況。所以推薦使用第二種方法。

封裝成一個頁面

這個頁面只有一個透明的Container，當(dāng)需要進(jìn)行權(quán)限判斷時，導(dǎo)航至該頁面，在這個頁面創(chuàng)建時進(jìn)行權(quán)限判斷和操作。當(dāng)用戶去到應(yīng)用設(shè)置界面操作權(quán)限后，返回應(yīng)用時使用 WidgetsBindingObserver 的 didChangeAppLifecycleState(AppLifecycleState state) 方法來再次進(jìn)行權(quán)限判斷。以下為封裝之后的文件 permission_request.dart ，可直接復(fù)制粘貼后使用。

import 'dart:io';
import 'package:flutter/cupertino.dart';
import 'package:flutter/services.dart';
import 'package:permission_handler/permission_handler.dart';
/// 權(quán)限檢查及請求
/// 
/// 外部可通過此方法來進(jìn)行權(quán)限的檢查和請求，將自動跳轉(zhuǎn)到`PermissionRequestPage`頁面。
/// 
/// 傳入 `Permission` 以及對應(yīng)的權(quán)限名稱 `permissionTypeStr`，如果有權(quán)限則返回 `Future true`
/// 
/// `isRequiredPermission` 如果為 `true`,則 "取消" 按鈕將執(zhí)行 "退出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}功能需要獲取您設(shè)備的${widget.permissionTypeStr}權(quán)限，否則可能無法正常工作。\n是否申請${widget.permissionTypeStr}權(quán)限？",
      "${widget.permissionTypeStr}權(quán)限不全，是否重新申請權(quán)限？",
      "沒有${widget.permissionTypeStr}權(quán)限，您可以手動開啟權(quán)限",
      widget.isRequiredPermission ? "退出應(yīng)用" : "取消"
    ];
    checkPermission(widget.permission);
  }
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    // 監(jiān)聽 app 從后臺切回前臺
    if (state == AppLifecycleState.resumed && _isGoSetting) {
      checkPermission(widget.permission);
    }
  }
  /// 校驗權(quán)限
  void checkPermission(Permission permission) async {
    final status = await permission.status;
    if (status.isGranted) {
      _popPage();
      return;
    }
    // 還未申請權(quán)限或之前拒絕了權(quán)限(在 iOS 上為首次申請權(quán)限，拒絕后將變?yōu)?`永久拒絕權(quán)限`)
    if (status.isDenied) {
      showAlert(permission, msgList[0], msgList[3], _isGoSetting ? "前往應(yīng)用中心" : "確定");
    }
    // 權(quán)限已被永久拒絕
    if (status.isPermanentlyDenied) {
      _isGoSetting = true;
      showAlert(permission, msgList[2], msgList[3], _isGoSetting ? "前往應(yīng)用中心" : "確定");
    }
    // 擁有部分權(quán)限
    if (status.isLimited) {
      if (Platform.isIOS || Platform.isMacOS) _isGoSetting = true;
      showAlert(permission, msgList[1], msgList[3], _isGoSetting ? "前往應(yīng)用中心" : "確定");
    }
    // 擁有部分權(quán)限(僅限 iOS)
    if (status.isRestricted) {
      if (Platform.isIOS || Platform.isMacOS) _isGoSetting = true;
      showAlert(permission, msgList[1], msgList[3], _isGoSetting ? "前往應(yīng)用中心" : "確定");
    }
  }
  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);
              })
          ],
        );
      }
    );
  }
  /// 申請權(quán)限
  void requestPermisson(Permission permission) async {
    // 申請權(quán)限
    await permission.request();
    // 再次校驗
    checkPermission(permission);
  }
  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }
  @override
  Widget build(BuildContext context) {
    return Container();
  }
  /// 退出應(yīng)用程序
  void _quitApp() {
    SystemChannels.platform.invokeMethod("SystemNavigator.pop");
  }
  /// 關(guān)閉整個權(quán)限申請頁面
  void _popDialogAndPage(BuildContext dialogContext) {
    _popDialog(dialogContext);
    _popPage();
  }
  /// 關(guān)閉彈窗
  void _popDialog(BuildContext dialogContext) {
    Navigator.of(dialogContext).pop();
  }
  /// 關(guān)閉透明頁面
  void _popPage() {
    Navigator.of(context).pop();
  }
}

AndroidManifest.xml

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

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

在外部想要檢查及獲取權(quán)限的地方，調(diào)用permissionCheckAndRequest方法即可：

// 導(dǎo)入封裝好的文件
import 'package:xxxx/permission_request.dart';
// ...其它代碼
ElevatedButton(
  onPressed: () async {
    // 調(diào)用封裝好的權(quán)限檢查和請求方法
    bool result = await permissionCheckAndRequest(
                          context, 
                          Permission.notification，
                           "通知"
                        );
    if (result) print("已擁有該權(quán)限");
  },
  child: const Text("權(quán)限檢查")
)