在Flutter中，newcontact 插件可以帮助你轻松地管理设备上的联系人。它允许你添加、更新、删除和查询联系人。以下是如何使用 newcontact 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 newcontact 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  newcontact: ^1.0.0  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 请求权限

在 Android 和 iOS 上，访问联系人需要相应的权限。你需要在 AndroidManifest.xml 和 Info.plist 文件中添加权限声明。

Android: 在 android/app/src/main/AndroidManifest.xml 中添加以下权限：

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

iOS: 在 ios/Runner/Info.plist 中添加以下权限：

<key>NSContactsUsageDescription</key>
<string>We need access to your contacts to manage them.</string>

3. 使用插件

以下是一些常见的使用场景：

添加联系人

import 'package:newcontact/newcontact.dart';

void addContact() async {
  Contact contact = Contact(
    givenName: 'John',
    familyName: 'Doe',
    phones: [Item(label: 'mobile', value: '1234567890')],
    emails: [Item(label: 'work', value: 'john.doe@example.com')],
  );

  await NewContact.addContact(contact);
}

更新联系人

void updateContact(Contact contact) async {
  contact.givenName = 'Jane';
  await NewContact.updateContact(contact);
}

删除联系人

void deleteContact(Contact contact) async {
  await NewContact.deleteContact(contact);
}

查询联系人

void getContacts() async {
  List<Contact> contacts = await NewContact.getContacts();
  for (var contact in contacts) {
    print('Name: ${contact.givenName} ${contact.familyName}');
  }
}

4. 处理权限

在访问联系人之前，你需要确保应用已经获得了必要的权限。你可以使用 permission_handler 插件来请求权限。

import 'package:permission_handler/permission_handler.dart';

void requestPermissions() async {
  if (await Permission.contacts.request().isGranted) {
    // 权限已授予，可以访问联系人
  } else {
    // 权限被拒绝
  }
}

5. 完整示例

以下是一个完整的示例，展示了如何添加、查询和删除联系人：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ContactManager(),
    );
  }
}

class ContactManager extends StatefulWidget {
  [@override](/user/override)
  _ContactManagerState createState() => _ContactManagerState();
}

class _ContactManagerState extends State<ContactManager> {
  List<Contact> contacts = [];

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

  void requestPermissions() async {
    if (await Permission.contacts.request().isGranted) {
      getContacts();
    } else {
      // 处理权限被拒绝的情况
    }
  }

  void getContacts() async {
    List<Contact> contactList = await NewContact.getContacts();
    setState(() {
      contacts = contactList;
    });
  }

  void addContact() async {
    Contact contact = Contact(
      givenName: 'John',
      familyName: 'Doe',
      phones: [Item(label: 'mobile', value: '1234567890')],
      emails: [Item(label: 'work', value: 'john.doe@example.com')],
    );

    await NewContact.addContact(contact);
    getContacts();
  }

  void deleteContact(Contact contact) async {
    await NewContact.deleteContact(contact);
    getContacts();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Contact Manager'),
      ),
      body: ListView.builder(
        itemCount: contacts.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text('${contacts[index].givenName} ${contacts[index].familyName}'),
            subtitle: Text(contacts[index].phones?.first.value ?? ''),
            trailing: IconButton(
              icon: Icon(Icons.delete),
              onPressed: () => deleteContact(contacts[index]),
            ),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: addContact,
        child: Icon(Icons.add),
      ),
    );
  }
}