📝 SeSAC의 'JetPack과 Kotlin을 활용한 Android App 개발' 강좌를 정리한 글 입니다.

---

📇 Permission 개념

B의 앱에서 A 앱의 컴포넌트를 실행시킬 수 있게끔 하고는 싶은데 보안을 걸고 싶을 때, 이런 경우에 퍼미션을 설정하면 된다. 매니페스트 파일에 <permission> 태그 를 등록해주면 된다.
이러면 아무리 암시적 인텐트 코드가 잘 작성되어 있다 하더라도 실행이 안되거나 에러가 발생한다.

그럼 어떻게 퍼미션을 획득 할 수 있을까?
매니페스트 파일에 <uses-permission> 태그를 달아주면 된다.

📚 permission 태그

<permission android:name="com.example.permission.TEST_PERMISSION"
	android:label="Test Permission"
    android:description="@string/permission_desc"
    android:protectionLevel="dangerous"/>

• AndroidManifest.xml 파일 설정

• name : permission 의 이름

• label, description : permission 에 대한 설명

• protectionLevel : 보호 수준
  
  

📌 protectionLevel 종류

• normal : 낮은 수준의 보호. 유저에게 권한 부여 요청이 필요 없는 경우.

• dangerous : 높은 수준의 보호. 유저에게 권한 부여 요청이 필요한 경우.

• signature : 동일한 키로 사인된 앱만 실행.

• signatureOrSystem : 안드로이드 시스템 앱 이거나 동일키로 사인된 앱만 실행
  
  

🧩 Permission 설정

📌 퍼미션으로 보호

<activity
	android:name=".MainActivity"
    android:exported="true"
    android:permission="com.example.TEST_PERMISSION">
    
</activity>    

• 퍼미션을 걸고 싶은 액티비티에만 <permission> 태그에 퍼미션 이름을 적어주면 된다.
  
  

📌 퍼미션을 획득

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

• <uses-permission> 태그에 획득할 퍼미션 이름을 똑같이 적는다.
  
  

➕ 퍼미션 획득이 필요한, <uses-permission> 태그를 작성한 앱이 핸드폰에 설치되면 해당 앱이 요구하는 퍼미션을 핸드폰 환경설정의 권한에서 확인할 수 있다. 이 때, 퍼미션에 대한 설명에 label 혹은 description 문자열이 표시되는데, 이 권한에 대한 설명은 퍼미션을 이용하는 앱이 아닌, 퍼미션으로 컴포넌트를 보호하는 앱에서 작성한 문자열이 표시된다.

즉, 퍼미션으로 보호하는 A 앱과 퍼미션을 이용하는 B 앱이 설치되면, B 앱의 권한 설명에 A 앱에 작성된 퍼미션의 label 혹은 description 문자열이 표시된다.

근데 protectionLevel 이 normal 인건 아예 권한에 표시되지 않는다. dangerous 의 경우에 표시된다.

🧩 시스템 Permission

시스템에서 요구되는 퍼미션. 시스템에서 퍼미션으로 보호하는 기능이 있다.

앱과 앱 간의 연동 뿐만 아니라 시스템에서 관리되는 기능 연동에도 필요하다.

• ACCESS_FINE_LOCATION : 위치 정보 접근

• ACESS_NETWORK_STATE : 네트워크 정보 접근

• ACCESS_WIFI_STATE : Wi-Fi 네트워크 정보 접근

• BATTERY_STATS : 배터리 정보 접근

• BLUETOOTH : 블루투스 장치에 연결

• BLUETOOTH_ADMIN : 블루투스 장치를 검색하고 페어링

• CAMERA : 카메라 장치에 접근

• INTERNET : 네트워크 연결

• READ_EXTERNAL_STORAGE : 외부 저장소에서 파일 읽기

• WRITE_EXTERNAL_STORAGE : 외부 저장소에 파일 쓰기

• READ_PHONE_STATE : 전화기로서의 각종 정보 접근

• SEND_SMS : SMS 발신

• RECEIVE_SMS : SMS 수신

• RECEIVE_BOOT_COMPLETED : 부팅 완료 시 실행

• VIBRATE : 진동 울리기

---

📇 Permission Check, Request

퍼미션은 API 1 버전 부터 제공된 개념이다. 그러다 API Level 23 에서 퍼미션 정책이 변경 되었다.

• API Level 23 이전 버전에서 퍼미션은 신고제

• API Level 23 버전부터 퍼미션은 허가제

원래는 퍼미션 요구를 유저가 거부할 수 없었다. 핸드폰 환경설정의 앱 권한에서 어떤 퍼미션을 요구 하는지는 확인할 수 있지만, 끌 수는 없었다고 한다. 그래서 이것이 유저 사생활 보호에 문제가 있다는 판단 하에 23 버전부터 정책이 변경되어 유저가 권한을 거부할 수 있게 되었다.

📚 Permission Check

val status = ContextCompat.checkSelfPermission(this, "android.permission.ACCESS_FINE_LOCATION")
if (status == PackageManager.PERMISSION_GRANTED) {
	Log.d("Permission", "permission granted")
} else {
	Log.d("Permission", "permission denied")
}

• 퍼미션 체크는 checkSelfPermission() 함수 이용. 매개변수로 퍼미션 이름을 준다.

• 결과 값은 상수로 전달

• PackageManager.PERMISSION_GRANTED : 퍼미션이 허락된 경우

• PackageManager.PERMISSION_DENIED : 퍼미션이 거부된 경우

퍼미션이 허락된 상황이면 그냥 그 작업을 실행하면 된다. 그런데 퍼미션이 막혀 있다면?

유저에게 퍼미션을 허락해 달라는 요청을 보내야 한다.

📚 Permission Request

오래 전부터 이용한 방법과 최근에 추가된 방법, 2가지의 요청 방법이 있다.

📌 requestPermissions() 방법

ActivityCompat.requestPermissions(this, arrayOf<String>("android.permission.ACCESS_FINE_LOCATION"), 100)

• 매개변수로 퍼미션 이름을 주는데, 한꺼번에 여러개의 퍼미션을 배열로 줄 수 있다.

• requestPermissions() 함수를 호출하면 핸드폰에 퍼미션 요청을 위한 시스템 다이얼로그가 뜬다.

• 유저가 거부 혹은 확인을 선택하여 다이얼로그가 종료된 순간 onRequestPermissionsResult() 함수가 자동 콜 된다.

override fun onRequestPermissionsResult(
	requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
	super.onRequestPermissionsResult(requestCode, permissions,grantResults)
    if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
    	Toast.makeText(this, "permission granted", Toast.LENGTH_SHORT).show()
    } else {
    	Toast.makeText(this, "permission denied", Toast.LENGTH_SHORT).show()
    }       
}

• 세 번째 매개변수 값으로 유저의 선택이 전달 된다.
  
  

📌 registerForActivityResult() 방법

API 31 버전에서 추가된 개념

val requestPermissionLauncher = registerForActivityResult(
	ActivityResultContracts.RequestPermission()
) { isGranted ->
	if (isGranted) {
    	Toast.makeText(this, "permission granted", Toast.LENGTH_SHORT).show()
	} else {
    	Toast.makeText(this, "permission denied", Toast.LENGTH_SHORT).show()
	}        
}

requestPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)

🧩 실습 예제

유저 위치 정보 퍼미션 요청

• AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

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

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AndroidLab">
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

• MainActivity.kt

package com.kotdev99.android.c51

class MainActivity : AppCompatActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContentView(R.layout.activity_main)

		// test2...
		val requestPermissionLauncher = registerForActivityResult(
			ActivityResultContracts.RequestPermission()
		) {
			if (it) {
				Toast.makeText(this, "granted...", Toast.LENGTH_SHORT).show()
			} else {
				Toast.makeText(this, "denied...", Toast.LENGTH_SHORT).show()
			}
		}

		// 퍼미션의 허락/거부 여부 확인
		val status = ContextCompat.checkSelfPermission(
			this,
			"android.permission.ACCESS_FINE_LOCATION"
		)
		if (status == PackageManager.PERMISSION_GRANTED) {
			Toast.makeText(this, "granted...", Toast.LENGTH_SHORT).show()
		}
		// 퍼미션 요청을 위한 시스템 다이얼로그 출력
		else {
			// test1...
//			ActivityCompat.requestPermissions(
//				this,
//				arrayOf<String>("android.permission.ACCESS_FINE_LOCATION"),
//				100
//			)

			// test2...
			requestPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
		}
	}

	// requestPermissions() 호출 시 자동 콜
	override fun onRequestPermissionsResult(
		requestCode: Int,
		permissions: Array<out String>,
		grantResults: IntArray
	) {
		super.onRequestPermissionsResult(requestCode, permissions, grantResults)
		if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
			Toast.makeText(this, "granted...", Toast.LENGTH_SHORT).show()
		} else {
			Toast.makeText(this, "denied...", Toast.LENGTH_SHORT).show()
		}
	}
}

📲 결과