flutter_contacts

Co-authored-by: Claude Fable 5 [email protected]

• Fix showCreator() name prefill not displaying in some Android contact editors (e.g. Samsung) by passing Insert.NAME instead of a StructuredName row — thanks @CrashKiki for the fix (#241) and @Eunno-An for the report (#242).

Co-authored-by: Claude Fable 5 [email protected]

• Android now returns the same contacts the system Contacts app displays, instead of filtering on IN_VISIBLE_GROUP = 1: contacts from sync adapters that don't mark them visible (e.g. MS365/Exchange) are included in getAll(), operations by ID work regardless of visibility, and filters matching no contacts return none instead of all (#240).
• Fix showCreator() dropping the pre-filled photo on Android: the system editor ignores photos passed through the insert intent, so the photo is now applied to the contact after creation when the app holds WRITE_CONTACTS (#242).

• Update README.

• Fix name updates writing to the wrong raw contact on Android contacts with multiple raw contacts (e.g. Google + WhatsApp): the name is now updated in place on the raw contact that already holds it, instead of the raw contact with the most properties (#236).

• Round-trip unknown vCard properties via contact.extras (#21).
• Migrate Android plugin to Built-in Kotlin; requires Flutter 3.44+ (#234).

• FlutterContacts.native.showPicker() now returns Contact? (with id and displayName always populated) and accepts a properties: set for additional fields. The picker itself remains permissionless on both platforms; on Android, requesting properties requires READ_CONTACTS and throws otherwise. Breaking: replace await …showPicker() with (await …showPicker())?.id (#232).
• Dedupe phone numbers and emails returned by aggregated contacts on Android, keyed on normalized value + label (#229).

• Fix Flutter SDK path resolution for FVM and IDE sync compatibility

The plugin's build.gradle assumed local.properties was always in
rootProject.projectDir, which breaks under FVM setups and certain IDE
sync scenarios where the working directory differs.

Resolution now:

1. Checks the flutter.sdk Gradle property (supports -Pflutter.sdk=)
2. Walks up from project dir looking for local.properties
3. Falls back to FLUTTER_ROOT environment variable

This makes the plugin build reliably across normal Flutter, FVM, and
IDE-triggered Gradle sync without requiring user workarounds.

Co-Authored-By: Claude Opus 4.6 (1M context) [email protected]

• Add rootProject lookup and flutter-root property for pub-cache compatibility

When the plugin is resolved from ~/.pub-cache, walking up from
project.projectDir cannot reach the host app's local.properties.
Add rootProject.projectDir lookup and support for the flutter-root
Gradle property (passed by Flutter tooling during builds) to cover
this case.

Co-Authored-By: Claude Opus 4.6 (1M context) [email protected]

• Bump version to 2.0.2

Co-Authored-By: Claude Opus 4.6 (1M context) [email protected]

Co-authored-by: Claude Opus 4.6 (1M context) [email protected]

• Fix Flutter SDK resolution for FVM and IDE sync compatibility (#227)

• Fix Android build failure from hardcoded Flutter SDK path (#223)

Release stable version 2.0.0, incorporating all changes from beta ver…

• Stable 2.0 release. Includes all changes from 2.0.0-beta.1 through 2.0.0-beta.5.

• Relax Dart/Flutter version requirements
• Fix for older Android versions without Settings.getDefaultAccount()

• Migrate to Swift Package Manager
• Migrate to UISceneDelegate

• Fix for #214
• Disable Swift Package Manager for example app

Expose Android identifiers and timestamp, refactor Android-specific f…

• Expose Android identifiers and timestamp
• Add androidLookup parameter to get()

• Complete rewrite with improved architecture and performance
• Full support for Android, iOS, and macOS platforms
• Added support for all contact fields including groups, accounts, and metadata
• vCard import/export support (v2.1, v3.0, v4.0)
• Native dialogs for contact creation, editing, viewing, and picking
• Contact change listeners for real-time updates
• SIM contacts support (Android)
• Number blocking support (Android)
• Ringtone management (Android)
• Profile/Me card support
• Bulk operations for creating, updating, and deleting contacts
• Account-aware contact management

• Fix kotlin/android incompability issues with java 1.8 and java 17 (https://github.com/QuisApp/flutter_contacts/issues/142, https://github.com/QuisApp/flutter_contacts/issues/147, https://github.com/QuisApp/flutter_contacts/issues/158, https://github.com/QuisApp/flutter_contacts/issues/169, https://github.com/QuisApp/flutter_contacts/pull/170) - thanks to Valent1, Hirohumi, himsarevenus, PcolBP, and other contributors
• Fix openExternalInsert() crash - thanks rahulraj-idt

• Fix openExternalInsert returning null on android (https://github.com/QuisApp/flutter_contacts/issues/100, https://github.com/QuisApp/flutter_contacts/issues/161)

• Fix wrong namespace on android (https://github.com/QuisApp/flutter_contacts/issues/171) - thanks mattmapadmi

• Upgrade gradle, add null-safety in example_full.

• Add feature to pre-populate fields in openExternalInsert() - thanks sakchhams
• Fix openExternalView and openExternalEdit on iOS (https://github.com/QuisApp/flutter_contacts/issues/91, https://github.com/QuisApp/flutter_contacts/issues/70)
• Support Gradle 8 (https://github.com/QuisApp/flutter_contacts/issues/123)
• Fix fetching notes on iOS - thanks starshipcoder and yassinsameh
• Fix bug with address label default on iOS - thanks MohamedAl-Kainai and yassinsameh

• Fix for AGP <4.2 (https://github.com/QuisApp/flutter_contacts/issues/127) - thanks trfiladelfo

• Update kotlin/gradle versions (https://github.com/QuisApp/flutter_contacts/issues/69)

• Edit groups (iOS) / labels (Android) and group/label membership

• Fix null pointer error (https://github.com/QuisApp/flutter_contacts/pull/71 - thanks anggrayudi)
• Update README

• Fix gradle compile error (https://github.com/QuisApp/flutter_contacts/issues/49)

• Fix social media custom label bug (https://github.com/QuisApp/flutter_contacts/issues/42)

• Read/write starred contacts on Android (https://github.com/QuisApp/flutter_contacts/issues/37)
• Fix vCard photo encoding (https://github.com/QuisApp/flutter_contacts/issues/34)

• Fetch groups (iOS) / labels (Android) and containers (iOS) / accounts (Android) (https://github.com/QuisApp/flutter_contacts/issues/29)
• Ability to request read-only permissions (https://github.com/QuisApp/flutter_contacts/issues/25)

• Update README

• Update comments

• Add ability to open external contact app to view, edit, pick or insert contacts (https://github.com/QuisApp/flutter_contacts/issues/16)

• Fix a diacritics bug

• Fix hashCode and ==

• Fix withThumbnail on iOS

• Load rawContact instead of contactId after update, since Android sometimes changes the contactId

• Stable release 🎉
• Follow-up fix for https://github.com/QuisApp/flutter_contacts/issues/9
• Fix https://github.com/QuisApp/flutter_contacts/issues/14

• Fix for permission handler on Android (https://github.com/QuisApp/flutter_contacts/pull/17) - thanks @scroollocker
• Fix type cast error on iOS 14.5 (https://github.com/QuisApp/flutter_contacts/issues/19) - thanks @jadasi

• Fix lint warning

• Fix https://github.com/QuisApp/flutter_contacts/issues/9

• Remove unused dependency

• Change Dart SDK version requirements

• Migrated to null-safety

• Support for requesting permissions
• Option to return non-visible contacts on Android and raw contacts on Android/iOS (https://github.com/QuisApp/flutter_contacts/issues/5)

• Format

• Not backward compatible!
• Photo and thumbnail are now distinct fields
• Event.date is now Event.year, Event.month, Event.day
• Convenience methods contact.insert(), contact.update(), contact.delete()
• Much more advanced vCard parsing and exporting (to version 3.0 and 4.0)
• We can now add multiple listeners
• Removed dependencies to build_runner and json_serializable
• Implemented toString(), hashCode and operator== for contact and properties
• Support for notes on iOS13+ by setting FlutterContacts.config.includeNotesOnIos13AndAbove = true
• Added tests

• Remove extra print statements

• Properly delete events on iOS (https://github.com/QuisApp/flutter_contacts/issues/2)

• Fix date serialization on Android (https://github.com/QuisApp/flutter_contacts/issues/2)

• Support for vCard parsing and exporting
• Add pedantic static analyzer
• Make default values non-const so they can be mutated
• Add tests
• Update dependencies
• Deduplicate events
• Rename socialMedia.dart -> social_media.dart

• Bug fix with normalized phone number

• Added normalized phone numbers (android only)
• Deduplicate phone numbers and emails by default

• Improved README and dartdoc.
• Added option to getFullContacts() with high-res photos.
• Fixed bug on iOS where low-res photos were fetched instead of high-res and vice-versa.
• Better Kotlin null safety.

• newContact() now returns the full contact instead of ID / raw ID.

• Fix README typos.

• Fix support for iOS.

• Initial release.