最简单的Flutter权限管理插件

逃离我推掉我的手 2023-01-18 09:18 12阅读 0赞

### 文章目录 ###

*   *  用法
     *   *  配置权限
         *   *  Android
             *  iOS
         *  检查权限
         *  请求权限
         *  处理回调
     *  例子
     *  插件开发
     *  欢迎关注公众号：编程之路从0到1

这是Flutter上的一个动态权限处理的插件库，可以让Flutter应用层的开发者以非常简单的API统一处理原生的动态权限。它封装了关于权限的检查、请求，以及权限被永久拒绝时，适当的拉起系统设置页面，提示用户手动打开权限。几乎想不到拒绝使用它的理由。

仓库地址： [**flutter\_easy\_permission**][flutter_easy_permission]

*  Android
 *  iOS

## 用法 ##

1.  配置权限
2.  检查权限。当调用一些需要权限的API时，应先检查是否具有相关权限
3.  请求权限。如果未获得授权，则向用户请求这些权限
4.  处理回调

### 配置权限 ###

#### Android ####

在项目根目录中打开`android/app/src/main/AndroidManifest.xml`文件，然后配置所需的权限：

有关这些常量的详细说明，请转到[这里][Link 1]。

要了解Android上的权限是如何处理的，[这里][Link 2]有一份完整文档。

#### iOS ####

打开项目根目录下的`ios/Runner/Info.plist`文件，配置你需要的权限：

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
        
        <key>NSCameraUsageDescription</key>
    	<string>在此向用户解释你为什么需要这个权限</string>
    
        
    </dict>
    </plist>

注意，替换`<string></string>`标签中的内容，给用户一个需要权限的理由。

关于iOS权限的详细解释，你可以查看[这里][Link 3]。

这个插件包装了一个用于iOS的[LBXPermission][]库。集成iOS中未使用的权限库，可能无法通过应用商店审核，所以不要集成那些不用的权限库，因此你还需要做一些配置。

打开`ios/Podfile`文件，添加以下代码。

target 'Runner' do
      flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
      # Add the library of permissions you need here
      pod 'LBXPermission/Camera'
    end

你可以集成的库：

pod 'LBXPermission/Camera'
    pod 'LBXPermission/Photo'
    pod 'LBXPermission/Contact'
    pod 'LBXPermission/Location'
    pod 'LBXPermission/Reminder'
    pod 'LBXPermission/Calendar'
    pod 'LBXPermission/Microphone'
    pod 'LBXPermission/Health'
    pod 'LBXPermission/Net'
    pod 'LBXPermission/Tracking'
    pod 'LBXPermission/Notification'
    pod 'LBXPermission/Bluetooth'

配置好后，你需要在项目的ios目录下运行安装命令：

pod install

### 检查权限 ###

const permissions = [Permissions.CAMERA];
    const permissionGroup = [PermissionGroup.Camera];
    
    bool ret = await FlutterEasyPermission.has(perms: permissions,permsGroup: permissionGroup);

由于Android和iOS的权限有很大不同，很难统一处理，所以你必须分别处理。参数`perms`对应的是Android权限，参数`permsGroup`对应的是iOS权限。app同一时间只能在一个平台上运行，所以你不需要担心会出现混乱。

注意API和库之间的关系，要检查和请求相关的权限，你必须集成相应的库，见下表：

<table> 
 <thead> 
  <tr> 
   <th>PermissionGroup</th> 
   <th>Info.plist</th> 
   <th>Integrated lib</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Calendar</td> 
   <td><code>NSCalendarsUsageDescription</code></td> 
   <td>LBXPermission/Calendar</td> 
  </tr> 
  <tr> 
   <td>Reminders</td> 
   <td><code>NSRemindersUsageDescription</code></td> 
   <td>LBXPermission/Reminder</td> 
  </tr> 
  <tr> 
   <td>Contacts</td> 
   <td><code>NSContactsUsageDescription</code></td> 
   <td>LBXPermission/Contact</td> 
  </tr> 
  <tr> 
   <td>Camera</td> 
   <td><code>NSCameraUsageDescription</code></td> 
   <td>LBXPermission/Camera</td> 
  </tr> 
  <tr> 
   <td>Microphone</td> 
   <td><code>NSMicrophoneUsageDescription</code></td> 
   <td>LBXPermission/Microphone</td> 
  </tr> 
  <tr> 
   <td>Photos</td> 
   <td><code>NSPhotoLibraryUsageDescription</code></td> 
   <td>LBXPermission/Photo</td> 
  </tr> 
  <tr> 
   <td>Location</td> 
   <td><code>NSLocationUsageDescription</code><br> <code>NSLocationAlwaysAndWhenInUseUsageDescription</code><br> <code>NSLocationWhenInUseUsageDescription</code></td> 
   <td>LBXPermission/Location</td> 
  </tr> 
  <tr> 
   <td>Notification</td> 
   <td><code>PermissionGroupNotification</code></td> 
   <td>LBXPermission/Notification</td> 
  </tr> 
  <tr> 
   <td>Bluetooth</td> 
   <td><code>NSBluetoothAlwaysUsageDescription</code><br> <code>NSBluetoothPeripheralUsageDescription</code></td> 
   <td>LBXPermission/Bluetooth</td> 
  </tr> 
 </tbody> 
</table>

### 请求权限 ###

FlutterEasyPermission.request(
                        perms: permissions,permsGroup: permissionGroup,rationale:"Test permission requests here");

### 处理回调 ###

void initState() {
        super.initState();
        _easyPermission = FlutterEasyPermission()
          ..addPermissionCallback(
            onGranted: (requestCode,perms,perm){
              debugPrint("Android Authorized:$perms");
              debugPrint("iOS Authorized:$perm");
            },
            onDenied: (requestCode,perms,perm,isPermanent){
              if(isPermanent){
                FlutterEasyPermission.showAppSettingsDialog(title: "Camera");
              }else{
                debugPrint("Android Deny authorization:$perms");
                debugPrint("iOS Deny authorization:$perm");
              }
            },);
      }
    
    void dispose() {
        _easyPermission.dispose();
        super.dispose();
    }

当`isPermanent`返回true时，表明系统在请求权限时不会弹出授权对话框，所以你可能需要自己弹出一个对话框，内容主要是提示用户，如果你必须使用这个功能，你可以到系统设置页面重新打开权限。

在Android上，你可能还需要实现`onSettingsReturned`回调函数，以更好地处理权限交互。它是`showAppSettingsDialog`被调用后的回调。

## 例子 ##

**一个完整的例子, 查看 [这里][Link 4]。**

您还可以查看它在[flutter-scankit][]中的使用示例

## 插件开发 ##

如果您对Flutter插件开发内容感兴趣，可以去我的网校中查看[《Flutter全栈式开发-高级篇》][Flutter_-]的课程，全网独家深入解析关于Flutter插件开发的方方面面，实战讲解多个案例（包含本插件开发过程）

![qr\_adv][qr_adv]

## 欢迎关注公众号：编程之路从0到1 ##

![编程之路从0到1][0_1]

[flutter_easy_permission]: https://pub.dev/packages/flutter_easy_permission
[Link 1]: https://developer.android.google.cn/reference/android/Manifest.permission#summary
[Link 2]: https://developer.android.google.cn/guide/topics/permissions/overview
[Link 3]: https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW17
[LBXPermission]: https://github.com/MxABC/LBXPermission
[Link 4]: https://github.com/arcticfox1919/flutter_easy_permission/blob/main/example/lib/main.dart
[flutter-scankit]: https://github.com/arcticfox1919/flutter-scankit/blob/main/example/lib/main.dart
[Flutter_-]: http://m.study.163.com/provider/480000001855430/index.htm?share=2&shareId=480000001855430
[qr_adv]: /images/20221021/05817f9b8c904fb89f91a7f7d45b5617.png
[0_1]: /images/20221021/cf9c1058d8dd4dffbe455788894eda9c.png