https://github.com/Baseflow/flutter-contacts-plugin

Contact plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to read, create and update contacts from the address book.
https://github.com/Baseflow/flutter-contacts-plugin

android baseflow contacts dart flutter flutter-plugin ios

Last synced: about 1 month ago
JSON representation

Contact plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to read, create and update contacts from the address book.

• Host: GitHub
• URL: https://github.com/Baseflow/flutter-contacts-plugin
• Owner: Baseflow
• License: mit
• Created: 2018-08-28T06:45:53.000Z (about 6 years ago)
• Default Branch: develop
• Last Pushed: 2020-05-14T11:31:55.000Z (over 4 years ago)
• Last Synced: 2024-06-28T01:47:11.047Z (3 months ago)
• Topics: android, baseflow, contacts, dart, flutter, flutter-plugin, ios
• Language: Dart
• Homepage: https://baseflow.com
• Size: 130 KB
• Stars: 40
• Watchers: 8
• Forks: 18
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Flutter Contacts Plugin  

[![pub package](https://img.shields.io/pub/v/contacts.svg)](https://pub.dartlang.org/packages/contacts)

A Flutter contacts plugin which provides easy access to the platform specific address book.

Branch  | Build Status 

------- | ------------

develop | [![Build Status](https://travis-ci.com/BaseflowIT/flutter-contacts-plugin.svg?branch=develop)](https://travis-ci.com/BaseflowIT/flutter-contacts)

master  | [![Build Status](https://travis-ci.com/BaseflowIT/flutter-contacts-plugin.svg?branch=master)](https://travis-ci.com/BaseflowIT/flutter-contacts)

## Features

* Automatically check and request the necessary permissions to access the platform specific address book;

* Read contacts from the addres book;

* [WIP] Store new contacts in the address book;

* [WIP] Update details of existing contacts;

* [WIP] Delete existing contacts from the address book.

## Usage

To use this plugin, add `contacts_plugin` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/). For example:

```yaml

dependencies:

  contacts_plugin: '^0.0.3'

```

> **NOTE:** There's a known issue with integrating plugins that use Swift into a Flutter project created with the Objective-C template. See issue [Flutter#16049](https://github.com/flutter/flutter/issues/16049) for help on integration.

## API

### Fetch all contacts

To fetch all contacts from the address book make a call to the `getContacts` method:

``` dart

import 'package:geolocator/contacts_plugin.dart';

List contacts = await ContactsPlugin().getContacts();

```

## Permissions

### Android

On Android you'll need to add either the `READ_CONTACTS` or the `WRITE_CONTACTS` permissions to your Android Manifest (depending if you need read and/ or write access to the address book). Todo so open the AndroidManifest.xml file and one of the following two lines as direct children of the `` tag:

``` xml

```

### iOS

On iOS you'll need to add the `NSContactsUsageDescription` to your Info.plist file in order to access the device's address book. Simply open your Info.plist file and add the following:

``` xml

NSContactsUsageDescription

This app needs access to address book.

```

## Issues

Please file any issues, bugs or feature request as an issue on our [GitHub](https://github.com/BaseflowIT/flutter-contacts-plugin/issues) page.

## Want to contribute

If you would like to contribute to the plugin (e.g. by improving the documentation, solving a bug or adding a cool new feature), please carefully review our [contribution guide](CONTRIBUTING.md) and send us your [pull request](https://github.com/BaseflowIT/flutter-contacts-plugin/pulls).

## Author

This Contacts plugin for Flutter is developed by [Baseflow](https://baseflow.com). You can contact us at