Flutter权限管理插件permission_handler_ohos的使用

permission_handler_ohos 插件用于在 OpenHarmony 上请求和检查权限。

注意

由于 OpenHarmony 和 HarmonyOS 的权限差异以及鸿蒙版本的快速迭代，检查请求权限的 API 是传递的权限的字符串全称。如果你发现 PermissionOhos 枚举中没有某个权限，你可以直接传递权限的字符串全称。等鸿蒙版本稳定下来了，会再同步权限列表到枚举中。

使用

首先，在 pubspec.yaml 文件中添加依赖：

dependencies:
  permission_handler_ohos: any

请认真阅读官方关于权限的文档： https://gitee.com/openharmony/docs/blob/OpenHarmony-4.1-Beta1/zh-cn/application-dev/security/AccessToken/app-permission-mgmt-overview.md#应用权限管理概述

在你的项目的 module.json5 文件中增加对应需要权限设置：

requestPermissions: [
  { name: "ohos.permission.READ_CALENDAR" },
  { name: "ohos.permission.WRITE_CALENDAR" },
]

例子

检查权限状态

import 'package:permission_handler_ohos/permission_handler_ohos.dart';

final PermissionStatusOhos status = 
  await PermissionHandlerOhos.checkPermissionStatus(
    PermissionOhos.read_calendar.name
);

请求单个权限

final PermissionStatusOhos status = 
  await PermissionHandlerOhos.requestPermission(
    PermissionOhos.read_calendar.name,
);

请求多个权限

final Map<String, PermissionStatusOhos> statusMap = 
  await PermissionHandlerOhos.requestPermissions([
    PermissionOhos.read_calendar.name,
    PermissionOhos.write_calendar.name,
]);

打开设置页面

PermissionHandlerOhos.openAppSettings();

完整示例

以下是完整的示例代码：

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:permission_handler_ohos/permission_handler_ohos.dart';
import 'package:grouped_list/grouped_list.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'permission_handler_ohos',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'permission_handler_ohos'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final List<PermissionOhos> _elements = PermissionOhos.values.where((element) =>
      element.permissionLevel.contains('normal')).toList();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
        actions: <Widget>[
          IconButton(
            onPressed: () {
              PermissionHandlerOhos.openAppSettings();
            },
            icon: const Icon(Icons.settings),
          )
        ],
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: GroupedListView<PermissionOhos, String>(
          elements: _elements,
          groupBy: (element) => element.grantType,
          itemComparator: (element1, element2) => element1.name.compareTo(element2.name),
          itemBuilder: (context, element) => PermissionWidget(element),
          useStickyGroupSeparators: true,
          groupSeparatorBuilder: (String value) => Padding(
            padding: const EdgeInsets.all(8.0),
            child: Text(
              '授权方式(grantType): $value',
              textAlign: TextAlign.center,
              style: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
            ),
          ),
          order: GroupedListOrder.DESC,
        ),
      ),
    );
  }
}

class PermissionWidget extends StatefulWidget {
  const PermissionWidget(this.permission, {super.key});

  final PermissionOhos permission;

  @override
  State<StatefulWidget> createState() => _PermissionState();
}

class _PermissionState extends State<PermissionWidget> {
  PermissionOhos get _permission => widget.permission;
  PermissionStatusOhos _permissionStatus = PermissionStatusOhos.invalid;

  @override
  void initState() {
    super.initState();

    _listenForPermissionStatus();
  }

  void _listenForPermissionStatus() async {
    final status = await PermissionHandlerOhos.checkPermissionStatus(_permission.name);
    setState(() => _permissionStatus = status);
  }

  Color getPermissionColor() {
    switch (_permissionStatus) {
      case PermissionStatusOhos.denied:
        return Colors.red;
      case PermissionStatusOhos.granted:
        return Colors.green;
      case PermissionStatusOhos.invalid:
        return Colors.orange;
      default:
        return Colors.grey;
    }
  }

  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: () {
        if (_permission.grantType.contains('user_grant')) {
          requestPermission(_permission);
        }
      },
      child: Card(
        child: Padding(
          padding: const EdgeInsets.all(5.0),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.start,
            crossAxisAlignment: CrossAxisAlignment.start,
            children: <Widget>[
              Text(
                _permission.name,
                style: Theme.of(context).textTheme.bodyLarge,
              ),
              const SizedBox(height: 5),
              Text(
                '权限级别(Level): ${_permission.permissionLevel}',
              ),
              const SizedBox(height: 5),
              Text(
                '起始版本(Version): ${_permission.startVersion}',
              ),
              const SizedBox(height: 5),
              Text.rich(TextSpan(children: <InlineSpan>[
                const TextSpan(text: '权限状态(Status): '),
                TextSpan(
                  text: _permissionStatus.name,
                  style: TextStyle(color: getPermissionColor()),
                )
              ]))
            ],
          ),
        ),
      ),
    );
  }

  Future<void> requestPermission(PermissionOhos permission) async {
    final PermissionStatusOhos status = await PermissionHandlerOhos.requestPermission(permission.name);

    setState(() {
      if (kDebugMode) {
        print(status);
      }
      _permissionStatus = status;
      if (kDebugMode) {
        print(_permissionStatus);
      }
    });
  }
}