Flutter iOS系统权限管理插件ios_system_permission的使用

ios_system_permission

ios_system_permission 是一个用于在 Flutter 中管理 iOS 系统权限的插件。它可以帮助开发者轻松地请求和检查 iOS 设备上的各种权限。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 ios_system_permission 插件：

dependencies:
  ios_system_permission: ^1.0.0

然后运行以下命令以更新依赖：

flutter pub get

2. 初始化插件

在应用的入口文件中初始化插件，并请求所需的权限。

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:ios_system_permission/ios_system_permission.dart'; // 导入插件

void main() {
  runApp(const MyApp()); // 启动应用
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState(); // 创建状态类
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown'; // 存储平台版本信息
  final _iosSystemPermissionPlugin = IosSystemPermission(); // 创建插件实例

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState(); // 初始化平台状态
  }

  // 平台消息异步处理
  Future<void> initPlatformState() async {
    dynamic contactPermission;

    try {
      // 获取联系人权限状态
      contactPermission = await _iosSystemPermissionPlugin.getContactPermission();
    } on PlatformException {
      // 捕获异常
      contactPermission = 'Failed to get platform contactPermission.';
    }

    // 打印调试信息
    print("contactPermission====$contactPermission");

    // 如果组件已被移除，则返回
    if (!mounted) return;

    // 更新 UI
    setState(() {
      _platformVersion = contactPermission.toString();
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('iOS 权限管理示例'), // 设置标题
        ),
        body: Center(
          child: Text('Running on: $_platformVersion\n'), // 显示权限状态
        ),
      ),
    );
  }
}

功能说明

1. 请求权限

通过调用插件的 getContactPermission() 方法，可以获取当前应用对联系人的权限状态。类似的方法还有：

• getCameraPermission()：获取相机权限。
• getLocationPermission()：获取位置权限。
• getMicrophonePermission()：获取麦克风权限。

2. 示例效果

运行上述代码后，应用会显示当前应用的联系人权限状态。例如：

Running on: authorized

如果权限未授予，则可能显示：

Running on: denied

注意事项

1. 权限申请
   在实际开发中，如果权限被拒绝或未授予，需要引导用户手动开启权限设置页面。可以通过 openSettings() 方法打开设备的设置页面。

   _iosSystemPermissionPlugin.openSettings();
   

2. 动态权限请求
   iOS 对权限的请求必须在用户交互的上下文中进行（例如点击按钮时），否则可能会导致请求失败。

完整示例代码

以下是完整的示例代码，包含权限请求和动态权限引导：

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:ios_system_permission/ios_system_permission.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  final _iosSystemPermissionPlugin = IosSystemPermission();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    dynamic contactPermission;

    try {
      contactPermission = await _iosSystemPermissionPlugin.getContactPermission();
    } on PlatformException {
      contactPermission = 'Failed to get platform contactPermission.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = contactPermission.toString();
    });
  }

  void requestPermission() async {
    try {
      bool granted = await _iosSystemPermissionPlugin.requestContactPermission();
      if (granted) {
        setState(() {
          _platformVersion = 'Contact permission granted';
        });
      } else {
        setState(() {
          _platformVersion = 'Contact permission denied';
        });
      }
    } on PlatformException {
      setState(() {
        _platformVersion = 'Failed to request contact permission.';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('iOS 权限管理示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
            Text('当前权限状态: $_platformVersion\n'),
            ElevatedButton(
              onPressed: requestPermission, // 请求权限
              child: const Text('请求联系人权限'),
            ),
            ElevatedButton(
              onPressed: () async {
                await _iosSystemPermissionPlugin.openSettings(); // 打开设置页面
              },
              child: const Text('打开设置页面'),
            ),
          ],
        ),
      ),
    );
  }
}