Flutter平台特定权限管理：处理iOS与Android的权限差异
2022-07-234.5k 阅读
Flutter平台特定权限管理基础
在Flutter应用开发中，处理不同平台（如iOS和Android）的权限差异是一项关键任务。不同操作系统对于权限的管理方式、权限的种类以及请求权限的流程都有所不同。
在Android系统中，权限分为普通权限和危险权限。普通权限在安装时授予，而危险权限则需要在运行时动态请求。例如，读取联系人权限就属于危险权限。在AndroidManifest.xml文件中，我们需要声明应用所需的权限。如下是声明读取联系人权限的示例：
<uses-permission android:name="android.permission.READ_CONTACTS" />
而在iOS系统中，权限管理相对简洁一些，但也有其独特之处。iOS的权限通过Info.plist文件配置，并且用户在设置中集中管理应用权限。以访问相机权限为例，在Info.plist中添加如下配置：
<key>NSCameraUsageDescription</key>
<string>Your access to the camera is required for this app feature to work.</string>
使用Flutter插件处理权限
为了在Flutter中方便地处理平台特定权限，常用的方式是使用插件。比如permission_handler插件，它为Flutter开发者提供了统一的接口来处理不同平台的权限请求。
首先，在pubspec.yaml文件中添加依赖：
dependencies:
permission_handler: ^10.2.0
然后在代码中导入该插件：
import 'package:permission_handler/permission_handler.dart';
请求单个权限
假设我们要请求存储权限，代码如下：
Future<void> requestStoragePermission() async {
final status = await Permission.storage.request();
if (status.isGranted) {
// 权限已授予，执行相关操作
print('Storage permission granted');
} else if (status.isDenied) {
// 权限被拒绝
print('Storage permission denied');
} else if (status.isPermanentlyDenied) {
// 权限被永久拒绝，引导用户至设置页面
openAppSettings();
}
}
请求多个权限
如果我们的应用需要多个权限，比如相机和麦克风权限，可以这样处理：
Future<void> requestMultiplePermissions() async {
Map<Permission, PermissionStatus> statuses = await [
Permission.camera,
Permission.microphone,
].request();
statuses.forEach((permission, status) {
if (status.isGranted) {
print('$permission granted');
} else if (status.isDenied) {
print('$permission denied');
} else if (status.isPermanentlyDenied) {
print('$permission permanently denied');
openAppSettings();
}
});
}
iOS特定权限处理细节
隐私权限说明
iOS对于隐私相关的权限要求应用在请求权限时提供清晰的用途说明。比如，当请求相册权限时，在Info.plist文件中需要添加相应的说明：
<key>NSPhotoLibraryUsageDescription</key>
<string>App needs access to your photo library.</string>
在Flutter代码中，使用permission_handler插件请求相册权限：
Future<void> requestPhotoLibraryPermission() async {
final status = await Permission.photos.request();
if (status.isGranted) {
print('Photo library permission granted');
} else if (status.isDenied) {
print('Photo library permission denied');
} else if (status.isPermanentlyDenied) {
print('Photo library permission permanently denied');
openAppSettings();
}
}
位置权限的特殊处理
iOS的位置权限有多种类型，包括“始终允许”、“使用应用期间允许”等。在Info.plist中配置位置权限说明：
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>Your location data is used to provide location-based services.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Your location data is used to provide location-based services.</string>
在Flutter中请求位置权限，根据不同的需求请求不同类型的位置权限：
Future<void> requestLocationPermission() async {
final status = await Permission.locationWhenInUse.request();
if (status.isGranted) {
print('Location permission (when in use) granted');
} else if (status.isDenied) {
print('Location permission (when in use) denied');
} else if (status.isPermanentlyDenied) {
print('Location permission (when in use) permanently denied');
openAppSettings();
}
}
如果需要“始终允许”的位置权限，则请求Permission.locationAlways：
Future<void> requestLocationAlwaysPermission() async {
final status = await Permission.locationAlways.request();
if (status.isGranted) {
print('Location permission (always) granted');
} else if (status.isDenied) {
print('Location permission (always) denied');
} else if (status.isPermanentlyDenied) {
print('Location permission (always) permanently denied');
openAppSettings();
}
}
Android特定权限处理细节
运行时权限请求流程
Android的危险权限需要在运行时动态请求。以请求电话权限为例，首先在AndroidManifest.xml中声明权限：
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
然后在Flutter代码中使用permission_handler插件请求权限：
Future<void> requestPhoneStatePermission() async {
final status = await Permission.phone.request();
if (status.isGranted) {
print('Phone state permission granted');
} else if (status.isDenied) {
print('Phone state permission denied');
} else if (status.isPermanentlyDenied) {
print('Phone state permission permanently denied');
openAppSettings();
}
}
权限组的概念
在Android中，有些权限属于同一个权限组，比如相机权限和闪光灯权限都属于相机权限组。当用户授予了权限组中的一个权限，同一组的其他权限也会被授予。以请求相机和闪光灯权限为例，首先在AndroidManifest.xml中声明权限：
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
在Flutter代码中请求权限：
Future<void> requestCameraAndFlashlightPermissions() async {
Map<Permission, PermissionStatus> statuses = await [
Permission.camera,
Permission.flashlight,
].request();
statuses.forEach((permission, status) {
if (status.isGranted) {
print('$permission granted');
} else if (status.isDenied) {
print('$permission denied');
} else if (status.isPermanentlyDenied) {
print('$permission permanently denied');
openAppSettings();
}
});
}
处理低版本Android系统的权限问题
在低版本的Android系统（如Android 6.0以下），权限管理方式有所不同。这些版本在安装应用时就会授予所有声明的权限，不存在运行时动态请求权限的机制。在开发中，我们需要考虑这种兼容性。可以通过检查系统版本来决定是否需要进行运行时权限请求。如下是一个简单的示例：
import 'package:device_info_plus/device_info_plus.dart';
Future<bool> isAndroid6OrHigher() async {
final deviceInfo = DeviceInfoPlugin();
final androidInfo = await deviceInfo.androidInfo;
return androidInfo.version.sdkInt >= 23;
}
Future<void> requestPermissionBasedOnVersion() async {
if (await isAndroid6OrHigher()) {
final status = await Permission.storage.request();
if (status.isGranted) {
print('Storage permission granted');
} else if (status.isDenied) {
print('Storage permission denied');
} else if (status.isPermanentlyDenied) {
print('Storage permission permanently denied');
openAppSettings();
}
} else {
// 对于低版本系统，假设权限已在安装时授予
print('Assuming storage permission granted on pre-Android 6.0 device');
}
}
权限管理中的用户体验优化
权限请求时机
选择合适的权限请求时机对于提升用户体验至关重要。不应该在应用启动时就一股脑地请求所有权限，这样会给用户带来困扰。比如，一个图片编辑应用，在用户首次使用图片导入功能时请求相册权限就比在应用启动时请求更合适。可以在页面的initState方法中判断是否需要请求权限：
class ImageImportPage extends StatefulWidget {
@override
_ImageImportPageState createState() => _ImageImportPageState();
}
class _ImageImportPageState extends State<ImageImportPage> {
@override
void initState() {
super.initState();
_requestPhotoLibraryPermissionIfNeeded();
}
Future<void> _requestPhotoLibraryPermissionIfNeeded() async {
final status = await Permission.photos.status;
if (!status.isGranted) {
final newStatus = await Permission.photos.request();
if (newStatus.isGranted) {
print('Photo library permission granted');
} else if (newStatus.isDenied) {
print('Photo library permission denied');
} else if (newStatus.isPermanentlyDenied) {
print('Photo library permission permanently denied');
openAppSettings();
}
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Image Import')),
body: Center(
child: Text('Import images from library'),
),
);
}
}
权限被拒绝后的引导
当权限被拒绝时，向用户提供清晰的引导是必要的。如果权限是被永久拒绝，应该引导用户到应用的设置页面去手动授予权限。permission_handler插件提供的openAppSettings方法可以方便地实现这一点。在权限被永久拒绝的处理逻辑中，可以弹出一个对话框提示用户：
showDialog(
context: context,
builder: (BuildContext context) {
return AlertDialog(
title: Text('Permission Denied'),
content: Text('The permission you requested has been permanently denied. Please go to app settings to grant the permission.'),
actions: <Widget>[
TextButton(
child: Text('Open Settings'),
onPressed: () {
openAppSettings();
Navigator.of(context).pop();
},
),
],
);
},
);
向用户解释权限用途
在请求权限时，给用户解释清楚为什么应用需要该权限可以增加用户对应用的信任。可以在请求权限前弹出一个对话框，说明权限的用途。例如，在请求位置权限前：
Future<void> requestLocationPermissionWithExplanation() async {
await showDialog(
context: context,
builder: (BuildContext context) {
return AlertDialog(
title: Text('Location Permission'),
content: Text('This app needs your location to provide you with location-based services such as nearby stores and directions.'),
actions: <Widget>[
TextButton(
child: Text('Cancel'),
onPressed: () {
Navigator.of(context).pop();
},
),
TextButton(
child: Text('Request Permission'),
onPressed: () async {
final status = await Permission.locationWhenInUse.request();
if (status.isGranted) {
print('Location permission (when in use) granted');
} else if (status.isDenied) {
print('Location permission (when in use) denied');
} else if (status.isPermanentlyDenied) {
print('Location permission (when in use) permanently denied');
openAppSettings();
}
Navigator.of(context).pop();
},
),
],
);
},
);
}
权限管理与应用架构的结合
分层架构中的权限管理
在一个分层架构的Flutter应用中，权限管理可以放在基础设施层。例如，将权限请求的逻辑封装成一个服务，业务层可以通过调用这个服务来获取所需的权限。假设我们有一个PermissionService类：
class PermissionService {
Future<bool> requestStoragePermission() async {
final status = await Permission.storage.request();
return status.isGranted;
}
}
在业务层的某个页面中使用这个服务：
class FileUploadPage extends StatefulWidget {
@override
_FileUploadPageState createState() => _FileUploadPageState();
}
class _FileUploadPageState extends State<FileUploadPage> {
final PermissionService _permissionService = PermissionService();
@override
void initState() {
super.initState();
_checkAndRequestPermission();
}
Future<void> _checkAndRequestPermission() async {
final isGranted = await _permissionService.requestStoragePermission();
if (!isGranted) {
// 权限未授予，处理相应逻辑
print('Storage permission not granted, cannot upload files');
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('File Upload')),
body: Center(
child: Text('Upload files'),
),
);
}
}
响应式编程与权限管理
在使用响应式编程范式（如使用Stream和StreamBuilder）的Flutter应用中，权限管理也可以与之结合。例如，我们可以创建一个Stream来监听权限状态的变化。假设我们有一个PermissionStreamManager类：
import 'dart:async';
import 'package:permission_handler/permission_handler.dart';
class PermissionStreamManager {
final StreamController<PermissionStatus> _permissionStatusController = StreamController<PermissionStatus>();
Stream<PermissionStatus> get permissionStatusStream => _permissionStatusController.stream;
PermissionStreamManager() {
_init();
}
Future<void> _init() async {
final status = await Permission.camera.status;
_permissionStatusController.add(status);
Permission.camera.request().then((newStatus) {
_permissionStatusController.add(newStatus);
});
Permission.camera.status.listen((status) {
_permissionStatusController.add(status);
});
}
void dispose() {
_permissionStatusController.close();
}
}
在页面中使用这个Stream来根据权限状态显示不同的UI：
class CameraPage extends StatefulWidget {
@override
_CameraPageState createState() => _CameraPageState();
}
class _CameraPageState extends State<CameraPage> {
late PermissionStreamManager _permissionStreamManager;
@override
void initState() {
super.initState();
_permissionStreamManager = PermissionStreamManager();
}
@override
void dispose() {
_permissionStreamManager.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Camera')),
body: StreamBuilder<PermissionStatus>(
stream: _permissionStreamManager.permissionStatusStream,
builder: (BuildContext context, AsyncSnapshot<PermissionStatus> snapshot) {
if (snapshot.hasData) {
final status = snapshot.data!;
if (status.isGranted) {
return Center(child: Text('Camera can be used'));
} else if (status.isDenied) {
return Center(child: Text('Camera permission denied'));
} else if (status.isPermanentlyDenied) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
Text('Camera permission permanently denied'),
TextButton(
child: Text('Open Settings'),
onPressed: () {
openAppSettings();
},
),
],
),
);
}
}
return Center(child: CircularProgressIndicator());
},
),
);
}
}
跨平台权限管理的测试策略
单元测试权限相关逻辑
对于权限请求的逻辑，可以编写单元测试来验证其正确性。使用flutter_test库，假设我们有一个PermissionHelper类来处理权限请求：
import 'package:permission_handler/permission_handler.dart';
import 'package:flutter_test/flutter_test.dart';
class PermissionHelper {
Future<bool> requestCameraPermission() async {
final status = await Permission.camera.request();
return status.isGranted;
}
}
编写单元测试：
void main() {
group('PermissionHelper tests', () {
test('Request camera permission', () async {
final helper = PermissionHelper();
final result = await helper.requestCameraPermission();
expect(result, isA<bool>());
});
});
}
集成测试跨平台权限
为了测试不同平台的权限管理是否正常工作，可以使用Flutter的集成测试功能。在test_driver目录下创建测试文件，例如permission_integration_test.dart。假设我们有一个页面，在页面初始化时请求存储权限：
import 'package:flutter_driver/flutter_driver.dart';
import 'package:test/test.dart';
void main() {
group('Permission integration test', () {
late FlutterDriver driver;
setUpAll(() async {
driver = await FlutterDriver.connect();
});
tearDownAll(() async {
await driver.close();
});
test('Storage permission request on app startup', () async {
// 这里假设页面有一个文本，根据权限状态显示不同内容
final permissionTextFinder = find.text('Storage permission status');
final text = await driver.getText(permissionTextFinder);
expect(text, isNotEmpty);
});
});
}
在运行集成测试时，可以分别在iOS和Android模拟器或真机上运行，以确保跨平台的权限管理都能正常工作。
通过以上对Flutter平台特定权限管理的深入探讨，开发者能够更好地处理iOS与Android的权限差异，提升应用的稳定性和用户体验。在实际开发中，还需要不断根据具体的应用需求和平台特性进行优化和调整。