Android 권한 요청 처리하기 (런타임 권한??)

들어가기 전에

프로젝트를 진행하며 사용자의 위치를 측정하는 기능에서는 위치 권한 요청이라는 권한이 필요했다. 

처음에는 권한 요청에 대해 대수롭지 않게 여겼는데, 권한을 제대로 설정해주지 않으면 기능이 정상적으로 작동하지 않았다. 

 

위치가 제대로 받아와지지 않아서 골치가 아팠는데 결국 나중에 보니 권한 이녀석이 문제였다!!!!

처음에는 설마 권한 문제일까 생각치 못해서 엄청 헤맸다 ㅠㅠ

 

앞으로도 필수적으로 알아야할 사항이니 제대로 정리하고 넘어가려고 한다!!!

권한이란?

먼저 권한이 무엇을 말하는 걸까?

앱을 설치해서 들어가려하면 여러가지 창이 뜨면서 ~허용하시겠습니까? 라는 멘트를 자주 본 기억이 있을텐데 바로 여기서 허용/거부에 대해 묻는 것이 오늘 다룰 권한이다!

정확히 말하자면 권한은 사용자의 민감한 정보에 접근하는 것을 제한하고 앱이 어떤 정보에 접근하는지 명확하게 알 수 있게 해주어 인지도를 높여주는 역할을 한다.

버전 별로 필요한 권한이 다르기 때문에 개발 환경에 따라 필요한 권한을 추가해서 사용해야한다.

권한의 종류

권한은 2가지 종류로 나뉜다.

1. Install-time 

앱을 설치할 때  자동으로 부여되는 권한이다. 사용자에게 별도의 허가를 요청하지 않아도 된다. 예를 들어 인터넷 접근 권한이 여기에 해당한다. 이러한 권한은 사용자의 개인정보에 직접적인 위험을 주지 않는 기능들에 대한 접근을 허용한다.

 

2. Runtime

앱이 실행 중일 때 사용자에게 직접 요청해야하는 권한이다. 주로 사용자의 개인 정보와 관련된 민감한 데이터에 접근할 때 필요하다.

 

권한 요청 과정

권한 검사하기

1. 우선 이미 권한이 부여되었는지 확인해야한다.

앱의 최소 시작 시에는 당연히 권한 요청을 바로 해도 된다. 그런데 다음부터는 권한이 있는지 어떻게 검사할까?

 

이 때는 ContextCompat.checkSelfPermission(Context, 권한)을 통해 권한을 전달하여 반환값을 얻을 수 있다. 

이 반환값과  PackManager.PERMISSION.GRANTED와 비교해주면 된다.

 

- 만약  권한이 이미 허용되어있다면 ContextCompat.checkSelfPermission(Context, 권한) 는  PERMISSION.GRANTED를 반환해서  조건은 참이 된다.

- 만약 권한이 없다면 거짓인 경우   ContextCompat.checkSelfPermission(Context, 권한) 는  PERMISSION_DENIED를 반환해서   조건은 거짓이 되고 , 이 때 위치 권한을 요청해주면 된다.

 

앱에서 권한이 필요한 이유를 설명하기

만약 위 과정에서 권한이 아직 부여되어있지 않다면 사용작가 해당 권한을 허용하기 위해서 해당 권한이 필요한 이유를 설명해주면 좋다.

 shouldShowRequestPermissionRationale()를 호출하여 이 앱에서 해당 권한이 필요한 이유를 사용자에게 설명하거나 바로 권한을 요청할 수 있다

 

권한 요청

설명을 하고 사용자가 동의한 경우 권한을 요청할 수 있다. 위에서 살펴본 install-in 권한과 runtime 권한은 요청방법이 조금 다르다.

 

우선 공통적으로 두 권한 모두 매니페스트 파일에서 필요한 permission을 명시해준다. 

 

나는 웹 서버와 통신하기 때문에 인터넷 권한을 허용해주어야했다. 그래서 아래와 같이 매니페스트에 인터넷 권한을 허가해주었다.

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

 

또한 워치를 사용할 사용자의 위치 정보를 가져오기 위해서 위치 관련 권한이 필요했기 때문에  아래와 같이 위치 관련 권한을 추가해주었다.

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

 

자 그럼 권한 요청 끝 ~?

 

install-time 권한의 한 종류였던 인터넷 권한 요청은 매니페스트에 선언해주는 것으로 권한 요청이 완료된다.

그러나 runtime 권한의 경우 추가적인 작업이 필요하다.

 

권한 요청 방법 

1. onRequestPermissionResult (deprecated) : 처음에는 이 방식을 사용했지만 이제 deprecated되었다고 한다.

그래도 안보면 아쉬우니까 onRequestPermissionResult 방식도 간단하게만 코드를 보자.

grantResults값을 통해 권한이 허가되었는지 거부되었는지를 검사해주고 케이스에 맞게 코드를 작성해주면 된다. 

  override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<out String>,
        grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        if	(grantResults[0] == PackManager.PERMISSION_GRANTED) {
        	// 권한이 허가된 경우 동작 정의
        }
        else {
           // 권한이 거부된 경우 동작 정의
        }
    }

 

위 방식은 deprecated라면 어떻게 권한을 요청해야하나요 !!?

 

2.  registerForActivityResult(ActivityResultContracts.RequestPermission() ) 를 사용해주면 된다.

 

1. 우선 런타임 권한 요청이 필요한 권한 목록을 만들어준다.

 private val permissionList = arrayOf(
        Manifest.permission.ACCESS_FINE_LOCATION,
        Manifest.permission.ACCESS_COARSE_LOCATION,
        )

 

그리고 권한 요청을 보내고, 응답을 처리하는 로직을 작성해준다.

  private val requestPermissionResult = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permission ->
        if (permission.all { it.value }) {
            Log.d("권한 허용", "${permission} 권한 허용")
        } else {
            Log.d("권한 거부", "$permission 권한 필요합니다")
        }
    }

 

자 그리고 마지막으로 아래의 코드 한줄만 작성해주면 권한 요청과 응답 처리가 완료된다.

        requestPermissionResult.launch(permissionList)

 

코드로 알아보기

1. 권한이 이미 부여되어있는지 체크하기

2. 아닌 경우 권한을 요청하는 이유 설명하기 

3. 동의한 경우 위치 권한 요청하기

 private fun checkPermission() {
        when {
            permissionList.all { ContextCompat.checkSelfPermission(this,it) == PackageManager.PERMISSION_GRANTED }
            -> {
                Log.d("권한", "모든 권한이 이미 부여되었습니다.")

            }
                ActivityCompat.shouldShowRequestPermissionRationale(
                    this, Manifest.permission.ACCESS_FINE_LOCATION
                ) -> {
                showPermissionContextPopup()

          }
            else -> {
              requestPermissionResult.launch(permissionList)
            }
        }
    }

  private fun showPermissionContextPopup(){
        androidx.appcompat.app.AlertDialog.Builder(this)
            .setTitle("위치 권한이 필요합니다")
            .setMessage("귀하의 안전을 보호하기 위해 위치 권한이 필요합니다.")
            
          // 3. 동의 버튼 클릭 시 위치 권한 요청
            .setPositiveButton("동의") {_,_ ->
                ActivityCompat.requestPermissions(
                    this,
                    arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),0
                )
            }
            .setNegativeButton("취소") {_,_ ->}
            .create()
            .show()
    }

 

결과

권한을 요청하는 이유를 보여주는 창과 동의 시 권한 요청 창에 뜬 화면