GitHub repositoryDRSchlaubi/contact_picker

contact_picker

A Flutter plugin for picking a contact from the address book.

contact_picker project cover
Stars
18
Forks
43
Last push (UTC)
Mar 15, 2024
Project status
Archived

Original README

English project snapshot. Visit GitHub for the latest content.

fluttercontactpicker

pub.dev

Interact with native OS contact pickers using Flutter

Note: This plugin requires at least Kotlin 1.5.0 to compile. See (#38 (comment) for more information)

Web demo: https://fcp.mik.wtf/

Contents

Getting Started

Grab contact.

final PhoneContact contact =
                    await FlutterContactPicker.pickPhoneContact();

For more info read the docs or take a look at the example

Features

  • Pick a phone/email contact using the OSs native contact picker
  • Pick a Full contact (except iOS)
  • Support Flutter Web

Permissions

If you target Android 11+ (API 30+) you need to obtain the android.permission.READ_CONTACTS permission, which is declared as a library permission here this permission will be requested automatically if the askForPermission parameter is true.

Alternatively you can request the permission manually with FlutterContactPicker.requestPermission() or check with FlutterContactPicker.hasPermission()

Obtain Full Contact (Android Only)

Note: Unlike Android iOS does not offer a way to directly get a full contact from the ContactPicker therefore this library does not support it. Apple might add it in 2030 so stay tuned

final FullContact contact =
                    await FlutterContactPicker.pickFullContact();
Obtain profile picture

The FullContact class has a photo property if the picked contact has an avatar. You can use the asWidget() method to get a renderable Image widget.

Full documentation: https://pub.dev/documentation/fluttercontactpicker/latest/fluttercontactpicker/fluttercontactpicker-library.html

Web support

This plugin also supports the Web Contact Picker API.

Michael Rittmeister GitHub avatar
GitHub author

Michael Rittmeister ↗

I like planes

LanguagesDartKotlinSwiftHTMLRubyObjective-C

Categories

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗