Flutter联系人权限管理插件contact_permission的使用

contact_permission

这是一个用于Flutter的插件，用于请求和验证联系人权限。

为什么需要这个包？

在将Flutter框架集成到Android和iOS的“add-to-app”场景时，可能会遇到一些挑战。在一个实例中，当我们尝试集成permission_handler时，错误地将GCC_PREPROCESSOR_DEFINITIONS标志添加到了根项目中，而不是模块包中。经过数小时的研究，发现这种方法并不有效。因此，我们不得不将这些标志移动到Flutter模块的Podfile中，而这本不应该提交。然而，即使进行了这一调整，我们仍然发现Android权限在许多设备上无法正常工作。这一困境促使我们开发了这个包。

开始使用

1. 打开pubspec.yaml
2. 添加contact_permission并替换[version]为最新版本：

dependencies:
  flutter:
    sdk: flutter
  contact_permission: ^[version]

1. 点击“获取包”按钮或运行flutter pub get

导入包

import 'package:contact_permission/contact_permission.dart';

检查权限是否已授予

onTap: () async {
  if (await ContactPermission.isPermissionGranted) {
    showSnackBar(
      _scaffoldKey,
      title: "Contact Permission Granted",
      color: Colors.green,
    );
  } else {
    showSnackBar(
      _scaffoldKey,
      title: "Contact Permission Not Granted",
    );
  }
},

请求权限

onTap: () async {
  if (await ContactPermission.requestPermission) {
    showSnackBar(
      _scaffoldKey,
      title: "Contact Permission Granted",
      color: Colors.green,
    );
  } else {
    showSnackBar(
      _scaffoldKey,
      title: "Contact Permission Not Granted",
    );
  }
},

示例代码

以下是一个完整的示例代码，展示了如何使用contact_permission插件来检查和请求联系人权限：

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

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

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  bool? _isPermissionGranted;

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              if (_isPermissionGranted != null)
                _isPermissionGranted!
                    ? const Icon(
                        Icons.check,
                        color: Colors.green,
                        size: 100,
                      )
                    : const Icon(
                        Icons.close,
                        color: Colors.red,
                        size: 100,
                      ),
              Text('Permission granted: $_isPermissionGranted'),
              ElevatedButton(
                onPressed: () async {
                  final result = await ContactPermission.isPermissionGranted();
                  setState(() {
                    _isPermissionGranted = result;
                  });
                  debugPrint('Permission granted: $_isPermissionGranted');
                },
                child: const Text('Check Permission'),
              ),
              ElevatedButton(
                onPressed: () async {
                  final result = await ContactPermission.requestPermission();
                  setState(() {
                    _isPermissionGranted = result;
                  });
                  debugPrint('Permission granted: $_isPermissionGranted');
                },
                child: const Text('Request Permission'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

贡献

有几种方式可以贡献：

• 提出任何功能或增强建议
• 报告一个bug
• 修复一个bug
• 参与讨论并帮助决策
• 编写和改进文档。文档非常重要，其重要性不容忽视！
• 发送Pull Request :-)

感谢所有贡献者