AndroidContacts ===================

Gradle Dependency

allprojects { 	repositories { 		... 		maven { url 'https://jitpack.io' }     } }

dependencies { 	implementation("com.github.blainepwnz:AndroidContacts:1.14.0") }

Basic Usage

>The minimum API level supported by this library is API 15. >Library is not handling 23+ API permission.

Need to add permission to read contacts in manifest.

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

Basic usage

• Get all contacts from android device
• Get specific data from contacts
• Querying inside contacts
• Save new contacts
• Delete contacts
• Managing blocked contacts

Type of fields you can get

• Phones
• Emails
• Addresses
• Groups
• Websites
• Nickname
• Note
• SIP
• Name
• Events
• Relations
• Photo
• Instant Messenger Addresses
• Lookup key
• Is favorite

new ContactsGetterBuilder(ctx)
    .allFields()
    .buildList();

Querying

Example: query that gets all contacts with photo and containing sequence "abc" in name.

new ContactsGetterBuilder(ctx)     .onlyWithPhotos()     .addField(FieldType.EMAILS, FieldType.ADDRESS)     .withNameLike("abc");

Saving new contacts

ContactData data = ContactDataFactory.createEmpty();
...Fill it with data
// id of newly created contact
int id = new ContactsSaverBuilder(context)
    .saveContact(data);

Deleting contacts

val contactData = / get contact data from somewhere /
val deleter = ContactsDeleter(context)
//usual delete with no need of callbacks
deleter.deleteContact(contactData)
//full range of callbacks, implement any you need
deleter.deleteContact(contactData) {
    onCompleted { }
    onFailure { }
    onResult { }
    doFinally { }
}

Additional info

Changelog