AndroidContacts - GitLite

KO | EN

gitlite — search

#python #go #golang #machine-learning #rust #deep-learning #linux #nodejs #windows #awesome #cli #vue #security #openai

AndroidContacts

(★ 100)

Easy to use library for contacts aggregation

파일 탐색기

최종 버전 다운로드 (.zip)

- bintray.gradle
- build.gradle
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
.gitignore
build.gradle
CHANGELOG.md
deps.gradle
gradle.properties
gradlew
gradlew.bat
LICENSE.txt
README.md
settings.gradle

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/blainepwnz/AndroidContacts

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AndroidContacts

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd androidcontacts

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

AndroidContacts
===================
----------------------------------
[![GitHub license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/blainepwnz/AndroidContacts/blob/master/LICENSE.txt)
[![](https://jitpack.io/v/blainepwnz/AndroidContacts.svg)](https://jitpack.io/#blainepwnz/AndroidContacts)

Gradle Dependency
---------------------------
**Step 1.** Add it in your root build.gradle at the end of repositories:
```
allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
    }
}
```
**Step 2.** Add the dependency
```
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
1. Get all contacts from android device
2. Get specific data from contacts
3. Querying inside contacts
4. Save new contacts
5. Delete contacts
5. 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

Easiest way to get all data by one time:
```
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
[More documentation](https://github.com/blainepwnz/AndroidContacts/wiki/Documentation)

#### Changelog
[More documentation](https://github.com/blainepwnz/AndroidContacts/blob/master/CHANGELOG.md)