· Flutter 개발 · 4 min read
permission_handler로 권한 요청 UX 개선하기
IoT 앱에 필요한 권한들
스마트홈 앱이 필요한 권한을 정리하면:
- 블루투스: 기기 등록 시 BLE 스캔/연결
- 카메라: QR 코드 스캔
- 위치: Android 11 이하에서 BLE 스캔에 필요, Android 12+는 BLUETOOTH_SCAN으로 대체
- 알림: 푸시 알림 수신 (Android 13+)
- 정확한 알람: 예약 알림 (Android 12+)
각 권한을 언제 요청하는지도 중요하다. 앱 실행과 동시에 모든 권한을 요청하면 사용자가 거부하는 경우가 많다. 권한이 실제로 필요한 순간에 요청하는 게 좋다.
permission_handler 기본 사용법
import 'package:permission_handler/permission_handler.dart';
// 현재 상태 확인
final status = await Permission.bluetooth.status;
// 권한 요청
final result = await Permission.bluetooth.request();
switch (result) {
case PermissionStatus.granted:
// 허용됨
break;
case PermissionStatus.denied:
// 거부됨 (다시 요청 가능)
break;
case PermissionStatus.permanentlyDenied:
// 영구 거부 (설정에서만 허용 가능)
openAppSettings();
break;
default:
break;
}
권한 요청 전 이유 설명
권한을 바로 요청하기 전에 왜 필요한지 설명하는 다이얼로그를 보여주면 허용률이 올라간다:
Future<bool> requestBluetoothPermission() async {
// 이미 허용된 경우
final status = await Permission.bluetoothScan.status;
if (status.isGranted) return true;
// 영구 거부된 경우
if (status.isPermanentlyDenied) {
await _showPermanentlyDeniedDialog('블루투스');
return false;
}
// 요청 전 이유 설명
final shouldRequest = await Get.dialog<bool>(
AlertDialog(
title: const Text('블루투스 권한 필요'),
content: const Text(
'IoT 기기 기기를 등록하려면 블루투스 연결이 필요합니다.\n'
'다음 화면에서 블루투스 사용을 허용해주세요.',
),
actions: [
TextButton(onPressed: () => Get.back(result: false), child: const Text('취소')),
ElevatedButton(onPressed: () => Get.back(result: true), child: const Text('계속')),
],
),
);
if (shouldRequest != true) return false;
// 실제 권한 요청
final result = await _requestBlePermissions();
return result;
}
Android 버전별 BLE 권한 처리
Android 12부터 BLE 권한이 바뀌었다. 버전에 따라 다르게 요청해야 한다:
Future<bool> _requestBlePermissions() async {
if (Platform.isIOS) {
final result = await Permission.bluetooth.request();
return result.isGranted;
}
// Android
if (await _isAndroid12OrAbove()) {
// Android 12+: 위치 권한 불필요
final results = await [
Permission.bluetoothScan,
Permission.bluetoothConnect,
].request();
return results.values.every((s) => s.isGranted);
} else {
// Android 11 이하: 위치 권한 필요
final results = await [
Permission.bluetooth,
Permission.location,
].request();
return results.values.every((s) => s.isGranted);
}
}
Future<bool> _isAndroid12OrAbove() async {
if (!Platform.isAndroid) return false;
final androidInfo = await DeviceInfoPlugin().androidInfo;
return androidInfo.version.sdkInt >= 31;
}
영구 거부 시 설정 화면으로 안내
Future<void> _showPermanentlyDeniedDialog(String permissionName) async {
await Get.dialog(
AlertDialog(
title: Text('$permissionName 권한 필요'),
content: Text(
'$permissionName 권한이 거부되어 있습니다.\n'
'설정 > 앱 > 스마트홈 > 권한에서\n'
'$permissionName을 허용해주세요.',
),
actions: [
TextButton(onPressed: Get.back, child: const Text('닫기')),
ElevatedButton(
onPressed: () {
Get.back();
openAppSettings(); // 설정 앱으로 이동
},
child: const Text('설정 열기'),
),
],
),
);
}
iOS Info.plist 권한 설명 문구
iOS는 권한 설명 문구를 Info.plist에 미리 작성해야 한다. 앱 심사에서 이 문구가 적절한지 검토한다:
<key>NSBluetoothAlwaysUsageDescription</key>
<string>IoT 기기 기기 등록 및 WiFi 설정을 위해 블루투스 접근이 필요합니다</string>
<key>NSCameraUsageDescription</key>
<string>QR 코드로 기기를 등록하기 위해 카메라 접근이 필요합니다</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>주변 기기 검색을 위해 위치 접근이 필요합니다</string>
다음 편은 flutter_secure_storage로 민감 정보를 안전하게 저장하는 방법이다.