contacts_service 0.0.8 contacts_service: ^0.0.8 copied to clipboard
A Flutter plugin to retrieve and manage contacts on Android and iOS devices.
contacts_service #
A Flutter plugin to access and manage the device's contacts.
Usage #
To use this plugin, add contacts_service
as a dependency in your pubspec.yaml
file.
Make sure you add the following permissions to your Android Manifest:
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
On iOS, make sure to set NSContactsUsageDescription
in the Info.plist
file
<key>NSContactsUsageDescription</key>
<string>This app requires contacts access to function properly.</string>
To check and request user permission to access contacts, I recommend using the following plugin: flutter_simple_permissions
Example #
// Import package
import 'package:contacts_service/contacts_service.dart';
// Get all contacts
Iterable<Contact> contacts = await ContactsService.getContacts();
// Get contacts matching a string
Iterable<Contact> johns = await ContactsService.getContacts(query : "john");
// Add a contact
// The contact must have a firstName / lastName to be successfully addded
await ContactsService.addContact(newContact);
//Delete a contact
await ContactsService.deleteContact(contact);
Todo #
- ❌ update contact
- ❌ add withThumbnails optional parameter in getContacts method
Contributions #
Contributions are welcome! If you find a bug or want a feature, please fill an issue.
If you want to contribute code please create a pull request.
Credits #
Heavily inspired from rt2zz's react native plugin