Flutter Android权限问题

Posted 2022-12-01 Xiao冰同学

如何在Flutter管理好android的权限

前言

从Android 6.0开始，权限不再是只是写在AndroidManifest.xml中申请，部分权限需要通过运行时申请，这可能相对于前端开发者来说，比较陌生，所以要尤其注意这个问题。所幸Flutter有相关的插件供我们使用，本次笔者将通过公司的真实项目来实现Flutter在Android中的权限适配问题。

效果预览

AndroidManifest的权限申请

permission的安装时的动态权限申请

permission_handler的动态权限申请

环境

开发环境

Flutter	1.22.0.stable
Android SDK	minSdkVersion：21 compileSdkVersion：29
Gradle	6.5
测试机型	华为荣耀 Play4T 系统Android 10

插件

在pubspec.yaml文件中添加如下插件，作用分别为 运行时权限插件，安装时权限插件，加载进度条toast的UI插件

permission_handler: 5.1.0+2
permission: 0.1.7
oktoast: 2.3.2

代码实现

Android配置

在android文件夹的AndroidManifest.xml文件中加入相对应的配置，以下只是示例，具体情况具体分析

 <!--允许程序打开网络套接字-->
    <uses-permission android:name="android.permission.INTERNET" />
    <!--允许程序设置内置sd卡的读写权限-->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
      <!--允许程序获取网络状态-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!--允许程序打开相机-->
    <uses-permission android:name="android.permission.CAMERA" />

注意事项：最好要在main debug profile三个文件里面的AndroidManifest.xml都要加上

代码封装

在main函数入口，先申请一些权限。
注意一个问题，就是一定要在runApp()方法调用之前使用，因为这是在安装APP时，先申请一些运行时权限

void main() => startup();
Future<void> startup() async 
	List<PermissionName> permissionNames = [];
    permissionNames.add(PermissionName.Location);
    permissionNames.add(PermissionName.Camera);
    permissionNames.add(PermissionName.Storage);
    List<Permissions> permissions = await Permission.requestPermissions(permissionNames);
    runApp(MyApp());

至于OkToast的配置请参考 pub.dev
这里面使用到的是permission插件，这个插件最多只能同时申请到3个（一般要先把重要的权限在这里先申请到），而且有一个很致命的问题：那就是在PermissionName枚举中定义了很多关于权限的枚举变量。如果Android系统的版本比较低，有些权限并没有在这个版本的系统需要申请，会出现闪退抛异常的现象。笔者就接到用户投诉在Android 6.0的中兴手机上出现闪退的情况，但是笔者公司并没有Android 7.0以下的测试机型，所以这种问题非常难以在自测阶段捕捉原因，所以这点尤其注意。大体上来说，试过的地理位置、相机、还有存储权限这个是没什么问题，且在App中非常重要的，于是优先在安装阶段就要尽可能获取到授权。
首先封装一个消息提示组件 base_tip.dart，这个组件的效果类似Android 原生的Toast

import 'package:flutter/material.dart';
import 'package:oktoast/oktoast.dart';

ToastFuture showToastCommon(
    String msg, 
      ToastPosition position,
    ) 
  position ??= ToastPosition.center;
  return showToast(
    msg,
    position: position,
  );


// ignore: must_be_immutable
class CustomErrorWidget extends StatefulWidget 
  String msg;
  CustomErrorWidget(Key key, this.msg = "Error") : super(key: key);
  @override
  _CustomErrorState createState() => _CustomErrorState();


class _CustomErrorState extends State<CustomErrorWidget> 
  @override
  Widget build(BuildContext context) 
    return Container(
      child: Center(
        child: Text(widget.msg),
      ),
    );
  

封装权限工具类 permission_helper.dart 这个组件用来检查权限与申请权限、申请权限成功跟失败的接口回调，及结果返回等。

import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:water_app/widget/base/base_tip.dart';

class PermissionHelper 

  static VoidCallback defErr = () 

  ;

  static VoidCallback defSuc = () 

  ;

  static Future<bool> check(PermissionType type, VoidCallback onSuc, VoidCallback onErr, String errMsg) async 
    bool flag = false;
    Permission permission = convertType(type);
    PermissionStatus status = await permission.status;
    if (status.isGranted) 
      onSuc != null ? onSuc() : defSuc();
      flag = true;
    
    else if (status.isUndetermined) 
      PermissionStatus p = await permission.request();
      if (p.isGranted) 
        onSuc != null ? onSuc() : defSuc();
        flag = true;
      
      else 
        showErr(onErr: onErr, errMsg: errMsg);
      
    
    else if (status.isDenied || status.isPermanentlyDenied) 
      PermissionStatus p = await permission.request();
      if (p.isGranted) 
        onSuc != null ? onSuc() : defSuc();
        flag = true;
      
      else 
        showErr(onErr: onErr, errMsg: errMsg);
      
    
    else 
      showErr(onErr: onErr, errMsg: errMsg);
    
    return flag;
  

  static void showErr(VoidCallback onErr, String errMsg) 
    showToastCommon(errMsg ?? '请授予该权限，否则将影响一些功能的使用');
    onErr ?? defErr();
  

  static Permission convertType(PermissionType type) 
    Permission p;
    switch (type) 
      case PermissionType.calendar:
        p = Permission.calendar;
        break;
      case PermissionType.camera:
        p = Permission.camera;
        break;
      case PermissionType.contacts:
        p = Permission.contacts;
        break;
      case PermissionType.location:
        p = Permission.location;
        break;
      case PermissionType.locationAlways:
        p = Permission.locationAlways;
        break;
      case PermissionType.locationWhenInUse:
        p = Permission.locationWhenInUse;
        break;
      case PermissionType.mediaLibrary:
        p = Permission.mediaLibrary;
        break;
      case PermissionType.microphone:
        p = Permission.microphone;
        break;
      case PermissionType.phone:
        p = Permission.phone;
        break;
      case PermissionType.photos:
        p = Permission.photos;
        break;
      case PermissionType.photosAddOnly:
        p = Permission.photosAddOnly;
        break;
      case PermissionType.reminders:
        p = Permission.reminders;
        break;
      case PermissionType.sensors:
        p = Permission.sensors;
        break;
      case PermissionType.sms:
        p = Permission.sms;
        break;
      case PermissionType.speech:
        p = Permission.speech;
        break;
      case PermissionType.storage:
        p = Permission.storage;
        break;
      case PermissionType.ignoreBatteryOptimizations:
        p = Permission.ignoreBatteryOptimizations;
        break;
      case PermissionType.notification:
        p = Permission.notification;
        break;
      case PermissionType.accessMediaLocation:
        p = Permission.accessMediaLocation;
        break;
      case PermissionType.activityRecognition:
        p = Permission.activityRecognition;
        break;
      default:
        p = Permission.unknown;
    
    return p;
  


enum PermissionType 
  calendar,
  camera,
  contacts,
  location,
  locationAlways,
  locationWhenInUse,
  mediaLibrary,
  microphone,
  phone,
  photos,
  photosAddOnly,
  reminders,
  sensors,
  sms,
  speech,
  storage,
  ignoreBatteryOptimizations,
  notification,
  accessMediaLocation,
  activityRecognition,
  unknown

工具类使用

申请运行时相册权限

 bool allow = await PermissionHelper.check(
 	PermissionType.storage,
 	 errMsg: '请授予相册权限',
	  onErr: () 
	    debugPrint('错误回调');
	  ,
	  onSuc: () 
	    debugPrint('成功回调');
	  
);

申请相机的权限

 bool allow = await PermissionHelper.check(
      PermissionType.camera,
      errMsg: '请授予相机权限',
      onErr: () 
        debugPrint('错误回调');
      ,
      onSuc: () 
        debugPrint('成功回调');
      
    );

总结

日常的程序设计要尽可能考虑到各种情况，用户是（不讲武德 ）最好的测试，经常不按常理出牌，应该要预判到用户的各种操作（骚操作 ），从而让应用变得更加健壮
最近笔者在公司使用Flutter技术独自开发一款企业级的物联网应用，如果对笔者感兴趣，欢迎关注笔者。读者有好的建议，也欢迎在下面留言。码字不易，请给👍