Flutter联系人管理插件contacts_service的使用

contacts_service 是一个Flutter插件，允许访问和管理设备上的联系人信息。以下是如何使用这个插件的详细说明。

安装

要在项目中使用此插件，请在 pubspec.yaml 文件中添加依赖项：

dependencies:  
    contacts_service: ^0.6.3

然后运行 flutter pub get 来安装该包。

权限配置

Android

对于Android应用，在 AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />

iOS

对于iOS应用，在 Info.plist 文件中设置 NSContactsUsageDescription 键：

<key>NSContactsUsageDescription</key>
<string>本应用需要访问您的联系人以正常工作。</string>

注意：contacts_service 不会处理请求或检查权限的过程。建议结合使用 permission_handler 插件来实现权限管理功能。

示例代码

下面是一个完整的示例应用程序，演示如何使用 contacts_service 插件读取、添加和删除联系人。

import 'package:flutter/material.dart';
import 'package:contacts_service/contacts_service.dart';
import 'package:permission_handler/permission_handler.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Contacts Service Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: ContactPage(),
    );
  }
}

class ContactPage extends StatefulWidget {
  @override
  _ContactPageState createState() => _ContactPageState();
}

class _ContactPageState extends State<ContactPage> {
  List<Contact> _contacts = [];
  bool _hasPermission = false;

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

  Future<void> _checkPermissions() async {
    final status = await Permission.contacts.status;
    if (status.isGranted) {
      setState(() {
        _hasPermission = true;
      });
      _loadContacts();
    } else {
      final result = await Permission.contacts.request();
      if (result.isGranted) {
        setState(() {
          _hasPermission = true;
        });
        _loadContacts();
      }
    }
  }

  Future<void> _loadContacts() async {
    try {
      final Iterable<Contact> contacts = await ContactsService.getContacts(
        withThumbnails: false,
      );
      setState(() {
        _contacts = contacts.toList();
      });
    } catch (e) {
      print('Failed to load contacts: $e');
    }
  }

  Future<void> _addContact() async {
    final newContact = Contact(
      givenName: 'John',
      familyName: 'Doe',
      phones: [Item(label: 'mobile', value: '123456789')],
    );
    try {
      await ContactsService.addContact(newContact);
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Contact added successfully')),
      );
      _loadContacts(); // Refresh the list after adding a contact
    } catch (e) {
      print('Failed to add contact: $e');
    }
  }

  Future<void> _deleteContact(Contact contact) async {
    try {
      await ContactsService.deleteContact(contact);
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Contact deleted successfully')),
      );
      _loadContacts(); // Refresh the list after deleting a contact
    } catch (e) {
      print('Failed to delete contact: $e');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Contacts'),
      ),
      body: _hasPermission
          ? ListView.builder(
              itemCount: _contacts.length,
              itemBuilder: (context, index) {
                final contact = _contacts[index];
                return ListTile(
                  title: Text('${contact.displayName}'),
                  subtitle: Text(contact.phones.isNotEmpty
                      ? contact.phones.first.value ?? ''
                      : ''),
                  trailing: IconButton(
                    icon: Icon(Icons.delete),
                    onPressed: () => _deleteContact(contact),
                  ),
                );
              },
            )
          : Center(child: Text('Please grant permission to access contacts.')),
      floatingActionButton: FloatingActionButton(
        onPressed: _addContact,
        tooltip: 'Add Contact',
        child: Icon(Icons.person_add),
      ),
    );
  }
}

此示例展示了如何：

• 检查并请求联系人访问权限。
• 加载设备上的所有联系人。
• 添加新联系人。
• 删除现有联系人。

请注意，实际应用中还需要考虑更多边界情况（如用户拒绝权限时的操作），并且可能需要根据具体需求调整UI设计。