Android - 휴대폰 전화번호 가져오는 방법

Android에서 phone 번호를 가져오는 방법을 소개합니다.

1. TelephonyManager.getLine1Number() API

TelephonyManager.getLine1Number()는 Phone 번호를 리턴합니다.

다음과 같이 코틀린에서 구현할 수 있습니다.

override fun onCreate(savedInstanceState: Bundle?) {
    ...

    val number = getPhoneNumber()
    Log.d("Test", "number: $number")
}

@SuppressLint("MissingPermission")
fun getPhoneNumber(): String {
    var tm = getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
    return tm.line1Number
}

위의 코드를 실행해보면, 다음과 같이 Phone 번호를 출력합니다.

10-26 23:21:31.171 22398 22398 D Test    : number: 01012349876

2. Permission 설정

getLine1Number() API를 사용하려면 Phone 권한이 있어야 합니다. Android 11에서 필요한 퍼미션이 변경되었고, 이것을 고려하여 권한을 요청하셔야 합니다.

Target SDK API가 30(Android 11) 이상일 때는, Manifest에서 READ_PHONE_NUMBERS 권한을 요청해야 합니다. 물론, Runtime Permission이기 때문에 사용자에게 요청하여 권한을 받아야 합니다.

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

Target SDK API가 30 미만(Android 10 이하)일 때는, Manifest에서 READ_PHONE_STATE 권한을 요청해야 합니다. 이 권한도 Runtime Permission입니다.

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

일반적으로 앱은 Android 10, 11에서 모두 동작하기 때문에, 위의 두 퍼미션을 모두 정의해야 합니다. Android 10 이하에서만 READ_PHONE_NUMBERS 퍼미션을 요청하려면 아래와 같이 maxSdkVersion="29"로 Max SDK version을 설정하시면 됩니다.

<manifest>
    <!-- Grants the READ_PHONE_STATE permission only on devices that run
         Android 10 (API level 29) and lower. -->
    <uses-permission android:name="READ_PHONE_STATE"
                     android:maxSdkVersion="29" />
    <uses-permission android:name="READ_PHONE_NUMBERS" />
</manifest>

Android 11의 변경사항 중 하나로, 전화번호를 가져올 때 필요한 퍼미션이 READ_PHONE_STATE에서 READ_PHONE_NUMBERS로 변경되었습니다.

2.1 SMS 권한

대표적으로 READ_PHONE_NUMBERS 퍼미션이 사용되지만, API 문서를 보면 READ_SMS 퍼미션이 있어도 getLine1Number()을 사용하여 Phone 번호를 가져올 수 있습니다.


/**
 * Returns the phone number string for line 1, for example, the MSISDN
 * for a GSM phone for a particular subscription. Return null if it is unavailable.
 * <p>
 * The default SMS app can also use this.
 *
 * <p>Requires Permission:
 *     {@link android.Manifest.permission#READ_SMS READ_SMS},
 *     {@link android.Manifest.permission#READ_PHONE_NUMBERS READ_PHONE_NUMBERS},
 *     that the caller is the default SMS app,
 *     or that the caller has carrier privileges (see {@link #hasCarrierPrivileges})
 *     for any API level.
 *     {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
 *     for apps targeting SDK API level 29 and below.
 */
@RequiresPermission(anyOf = {
        android.Manifest.permission.READ_PHONE_STATE,
        android.Manifest.permission.READ_SMS,
        android.Manifest.permission.READ_PHONE_NUMBERS
})
public String getLine1Number() {
    return getLine1Number(getSubId());
}

2.2 READ_PRIVILEGED_PHONE_STATE 권한

android.permission.READ_PRIVILEGED_PHONE_STATE는 Platform과 동일한 서명인 앱 또는 Privileged 앱에게 부여되는 권한입니다. 시스템 앱에게만 허용되는 권한이기 때문에 API 문서에 소개되지 않았는데요. 이 퍼미션을 갖고 있어도 getLine1Number()으로 Phone 번호를 가져올 수 있습니다.

이 퍼미션은 Runtime permission이 아니고 Install permission이기 때문에 사용자에게 권한을 요청할 필요는 없습니다. 하지만, 앞에서 설명한 것처럼 일반적인 3rd party app은 이 권한을 받을 수 없습니다.

References

Loading script...

Related Posts

codechachaCopyright ©2019 codechacha