Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

Android에서 모든 연락처 읽는 방법 – 단계별 구현 가이드

이 튜토리얼에서는 Android에서 기기에 저장된 모든 연락처를 읽어와 화면에 표시하는 방법을 단계별로 살펴봅니다. 연락처 데이터를 읽으려면 READ_CONTACTS 권한이 반드시 필요하며, 이 예제에서는 런타임 권한 요청 처리 과정까지 함께 다룹니다.

1단계: 새 프로젝트 만들기

Android Studio를 실행한 뒤 File ⇒ New Project 메뉴로 이동하고, 새 프로젝트 생성에 필요한 정보를 모두 입력하여 프로젝트를 만듭니다.

2단계: 레이아웃 파일 작성 (activity_main.xml)

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<LinearLayout xmlns:android = "https://schemas.android.com/apk/res/android"
    android:layout_width = "match_parent"
    android:gravity = "center"
    android:layout_height = "match_parent">
    <ListView
        android:id = "@+id/list"
        android:layout_width = "wrap_content"
        android:textSize = "30sp"
        android:layout_height = "wrap_content"
        android:text = "Click"/>
</LinearLayout>

위 코드에는 연락처 목록을 표시하기 위한 ListView 하나가 배치되어 있습니다.

3단계: MainActivity.java 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다.

import android.annotation.TargetApi;
import android.content.ContentResolver;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Build;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.support.v4.app.ActivityCompat;
import android.support.v7.app.AppCompatActivity;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import java.util.ArrayList;

public class MainActivity extends AppCompatActivity {
    public static final int REQUEST_READ_CONTACTS = 79;
    ListView list;
    ArrayList mobileArray;
    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        if (ActivityCompat.checkSelfPermission(this, android.Manifest.permission.READ_CONTACTS)
            == PackageManager.PERMISSION_GRANTED) {
            mobileArray = getAllContacts();
        } else {
            requestPermission();
        }
        list = findViewById(R.id.list);
        ArrayAdapter adapter = new ArrayAdapter<String>(this,
        android.R.layout.simple_list_item_1, android.R.id.text1, mobileArray);
        list.setAdapter(adapter);
    }
    private void requestPermission() {
        if (ActivityCompat.shouldShowRequestPermissionRationale(this, android.Manifest.permission.READ_CONTACTS)) {
            // 필요하다면 여기서 권한 요청 사유를 설명하는 UI를 보여줄 수 있습니다.
        } else {
            ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.READ_CONTACTS},
            REQUEST_READ_CONTACTS);
        }
    }
    @Override
    public void onRequestPermissionsResult(int requestCode,
    String permissions[], int[] grantResults) {
        switch (requestCode) {
            case REQUEST_READ_CONTACTS: {
                if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                    mobileArray = getAllContacts();
                } else {
                    // 권한이 거부된 경우, 이 권한에 의존하는
                    // 기능을 비활성화합니다.
                }
                return;
            }
        }
    }
    private ArrayList getAllContacts() {
        ArrayList<String> nameList = new ArrayList<>();
        ContentResolver cr = getContentResolver();
        Cursor cur = cr.query(ContactsContract.Contacts.CONTENT_URI,
        null, null, null, null);
        if ((cur != null ? cur.getCount() : 0) > 0) {
            while (cur != null && cur.moveToNext()) {
                String id = cur.getString(
                cur.getColumnIndex(ContactsContract.Contacts._ID));
                String name = cur.getString(cur.getColumnIndex(
                ContactsContract.Contacts.DISPLAY_NAME));
                nameList.add(name);
                if (cur.getInt(cur.getColumnIndex( ContactsContract.Contacts.HAS_PHONE_NUMBER)) > 0) {
                    Cursor pCur = cr.query(
                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null,
                    ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = ?",
                    new String[]{id}, null);
                    while (pCur.moveToNext()) {
                        String phoneNo = pCur.getString(pCur.getColumnIndex(
                        ContactsContract.CommonDataKinds.Phone.NUMBER));
                    }
                    pCur.close();
                }
            }
        }
        if (cur != null) {
            cur.close();
        }
        return nameList;
    }
}

핵심 로직을 간단히 정리하면 다음과 같습니다.

  • 권한 확인: onCreate()에서 READ_CONTACTS 권한이 이미 부여되었는지 확인하고, 없으면 requestPermission()을 호출합니다.
  • getAllContacts(): ContentResolver로 ContactsContract.Contacts.CONTENT_URI를 조회해 각 연락처의 ID와 표시 이름(DISPLAY_NAME)을 가져옵니다.
  • 전화번호 조회: HAS_PHONE_NUMBER 값이 0보다 큰 연락처에 한해 CommonDataKinds.Phone.CONTENT_URI를 CONTACT_ID 조건으로 다시 쿼리하여 번호를 얻습니다.
  • 결과 표시: 수집된 이름 목록을 ArrayAdapter에 담아 ListView에 바인딩합니다.

4단계: 매니페스트에 권한 추가

AndroidManifest.xml 파일에 아래 코드를 추가합니다. 특히 <uses-permission> 태그로 READ_CONTACTS 권한을 선언해야 합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<manifest xmlns:android = "https://schemas.android.com/apk/res/android"
    package = "com.example.myapplication">
    <uses-permission android:name = "android.permission.READ_CONTACTS" />
    <application
        android:allowBackup = "true"
        android:theme = "@style/AppTheme.NoActionBar"
        android:icon = "@mipmap/ic_launcher"
        android:label = "@string/app_name"
        android:roundIcon = "@mipmap/ic_launcher_round"
        android:supportsRtl = "true">
        <activity
            android:name = ".MainActivity"
            android:configChanges = "keyboardHidden|orientation|screenSize">
            <intent-filter>
                <action android:name = "android.intent.action.MAIN" />
                <action android:name = "android.intent.action.CREATE_SHORTCUT" />
                <category android:name = "android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 Android 모바일 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 앱을 실행하려면 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 실행(Run) 아이콘을 클릭하세요. 옵션 목록에서 모바일 기기를 선택하면, 기기 화면에 아래와 같이 연락처 목록이 표시됩니다.

Android에서 모든 연락처 읽는 방법 – 단계별 구현 가이드