[kotlin] 인텐트 개념 복습

『Do it! 깡샘의 안드로이드 앱 프로그래밍 with 코틀린』 교재를 바탕으로 정리한 내용입니다.

인텐트 이해하기

인텐트란?

• '컴포넌트를 실행하려고 시스템에 전달하는 메시지'
• MainActivity 실행 후 DetailActivity로 화면 전환을 하려고 할 때
  • 보통의 경우에는 DetailActivity 클래스의 객체를 생성해서 실행하면 되지만,
  • 만약 DetailActivity가 컴포넌트 클래스라면 개발자가 코드에서 직접 생성해서 실행할 수 없음 → 시스템에 인텐트를 전달해 주어야 함
    
• 인텐트의 중재 역할은 같은 앱의 컴포넌트뿐 아니라 외부 앱의 컴포넌트와 연동할 때에도 마찬가지
  • A앱의 컴포넌트에서 인텐트를 시스템에 전달하고 그 정보를 분석하여 B앱의 컴포넌트 실행 가능
• 컴포넌트는 매니페스트 파일에 등록하여 사용
  

    // Activity 등록
    <activity android:name=".DetailActivity"></activity>
    <activity android:name=".MainActivity">. .. 생략 ... </activity>

    val intent: Intent = Intent(this, DetailActivity::class.java)
    startActivity(intent)

• startActivity()함수를 통해 시스템에 실행을 요청할 컴포넌트의 정보가 담긴 Intent 객체를 전달
  • DetailActivity를 실행해 달라는 정보를 Intent 객체에 대입한 것을 의미함

인텐트 엑스트라 데이터

• 컴포넌트 객체는 시스템이 생성하므로 개발자 코드로는 직접 접근 불가 → 컴포넌트 객체로 어떤 함수를 호출할 수는 없음
  
• 따라서 인텐트에 컴포넌트 실행을 요청할 때 데이터를 함께 전달하려면 엑스트라 데이터를 이용
• putExtra() 함수 이용해 인텐트에 엑스트라 데이터를 추가
  

    val intent = Intent(this, DetailActivity::class.java)
    intent.putExtra("data1", "hello")
    intent.putExtra("data2",10)
    startActivity(intent)

• 실행된 컴포넌트에서 엑스트라 데이터를 가져오려면
  • getIntent() 함수로 자신을 실행한 인텐트 객체를 얻어온 후
  • 그 인텐트 객체를 get IntExtra() 형태의 함수로 데이터를 가져오면 됨(함수는 타입별로 제공)

    val intent = Intent
    val data1 = intent.getStringExtra("data1")
    val data2 = intent.getIntExtra("data2", 0)

액티비티 화면 되돌리기

• 액티비티는 화면을 구성하는 컴포넌트이므로, 다른 액티비티를 인텐트로 실행하면 화면이 전환됨
• 액티비티가 다른 액티비티를 실행해 화면이 전환되었을 때, 화면을 되돌리거나 되돌리지 않을 수 있음 → 이 옵션을 선택적으로 사용하기 위해 아래 함수 사용
  

startActivity() : 화면을 되돌릴 필요 없을 때사용
registerForActivityResult() : 결과를 포함해 화면을 되돌릴 때 사용 (실행 시 launch()사용)

기존에 사용하던 startActivityForResult()는 deprecated 된 이유

- 프로젝트가 커지면그에 따라 onActivityResult 메서드 안에 들어가는 코드도 굉장히 많아지기 때문
    
    → 유지보수성이 떨어짐
    
    → requestCode를 지정하는 데에도 명확하지 않다는 단점이 있음
    
- 퍼미션 요청 시 불편하기 때문
    
   → requestCode에 따라 분기를 나누고 해당 권한을 가지고 있는지 없는지에 따라 또 분기를 나누게 되므로 퍼미션 요청을 여러 개 해야 하는 경우에는 코드가 복잡해짐
    

👉  이러한 문제를 해결하기 위해 **[ActivityResultContracts](https://developer.android.com/training/basics/intents/result#custom) 도입**

//결과를 포함해 화면을 되돌리는 경우
val intent = Intent(this, DetailActivity<::class.java)
	//startActivityForResult(intent, 10)      // deprecated
	registerActivity.launch(intent)

private val registerActivity: ActivityResultLauncher<Intent> = registerForActivityResult(
	ActivityResultContracts.StartActivityForResult() // ◀ StartActivityForResult 처리를 담당
	) { result ->
		if (result.resultCode == RESULT_OK) {
			val value = result.data?.getStringExtra("resultData")
			... 생략 ...
	}
}

//DetailActivity에서 화면 되돌리면서 데이터 전달
intent.putExtra("resultData","world")
setResult(RESULT_OK,intent)
finish()

• setResult() 함수로 결과를 지정할 때 RESULT_OK, RESULT_CANCELED 등의 상수 지정 가능
• 결과가 되돌아와서 다시 자신이 화면에 출력되면 StartActivityForResult()가 자동으로 호출됨
• 이 함수의 매개변수
  • resultCode : 인텐트로 실행된 곳에서 돌려받은 결과 코드
  • data : 결과 데이터가 들어있는 인텐트 객체

인텐트 필터

• 아래처럼 인텐트에서 클래스 타입 레퍼런스 로 설정하는 경우, 같은 앱이면 가능하지만 외부 앱의 컴포넌트는 실행 불가

val intent: Intent = Intent(this, DetailActivity::class.java)

• 인텐트는 실행할 컴포넌트 정보를 어떻게 설정하는지에 따라 2가지로 나뉨
  1. 명시적 인텐트 : 클래스 타입 레퍼런스 정보를 활용한 인텐트(내부 앱의 컴포넌트 요청하는 객체 생성)
  2. 암시적 인텐트 : 인텐트 필터 정보를 활용한 인텐트(외부 앱 컴포넌트 요청 시 이용)

    //암시적 인텐트는 intent-filter 이용
    //name만 지정한 OneActivity는 명시적 인텐트로만 실행 가능
    <activity android:name=".OneActivity"/>
    <activity android:name=".TwoActivity">
    	<intent-filter>
    		<action android:name="ACTION_EDIT"/>
    	</intent-filter>
    </activity>

• 암시적 인텐트의 경우 클래스의 이름만 지정해줘도 등록된 정보와 비교해서 실행할 수 있지만, 어떤 컴포넌트를 외부에서도 인텐트로 실행할 수 있어야 한다면 해당 컴포넌트가 있는 앱의 매니페스트 파일에 암시적 인텐트로 실행할 수 있게 <intent-filter>를 설정해줘야 함
• <intent-filter>는 <activity>, <service>,<receiver> 등 컴포넌트 등록 태그 하위에 작성 가능
• <intent-filter>의 하위에는 다음 태그들을 이용해 정보 설정
  • <action> : 컴포넌트의 기능을 나타내는 문자열 - 개발자 임의 지정
  • <category> : 컴포넌트가 포함되는 범주를 나타내는 문자열 - 플랫폼 API에서 제공하는 문자열 이용
  • <data> : **컴포넌트에서 처리할 데이터의 성격을 나타내는 문자열 - URL형식으로 표현하며, 이나 처럼 문자열 하나로 선언하지 않고 android:scheme, android:host** 등의 속성을 필요한 만큼 선언하여 사용
• 암시적 인텐트 대표적 예 → 자동으로 만들어지는 메인 액티비티
  • 사용자가 아이콘 터치 시 외부 앱(런처)에서 실행하는 것이기 때문에 앱의 첫 화면인 MainActivity에 인텐트 필터를 설정해야 함

    <activity android:name=".MainActivity">
    	<intent-filter>
    		<action android:name="android.intent.action.MAIN" />
    		<category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

• 다른 컴포넌트도 외부 앱과 연동하려면 인텐트 필터 등록
  • TwoActivity를 다음처럼 등록하면 인텐트 필터에 선언된 정보에 맞춰 액티비티 시작해야 함

    <activity android:name=".TwoActivity">
    	<intent-filter>
    		<action android:name="ACTION_EDIT"/>
    		<category android:name="android.intent.category.DEFAULT"/>
    		<data android:scheme="http"/>
    		//<data android:mimeType="image/*"/>
    	</intent-filter>   
    </activity>

• 액티비티에 action과 data 프로퍼티에 실행 대상인 컴포넌트 정보 지정
  • 인텐트 정보에 <category>를 설정하지 않으면 DEFAULT값으로 지정됨
  • 만약 매니페스트 파일에 DEFAULT가 아닌 다른 문자열을 지정했다면, 인텐트에도 해당 문자열을 그대로 지정해야 함

    //action, data 정보를 인텐트의 각 프로퍼티에 설정하는 방법
    val intent = Intent()
    intent.action = "ACTION_EDIT"
    intent.data = Uri.parse("http://www.google.com")
    //intent.type = "image/*"
    startActivity(intent)
    
    //생성자의 매개변수로 지정하는 방법
    val intent = Intent("ACTION_EDIT", Uri.parse("http://www.google.com"))
    startActivity(intent)

액티비티 인텐트 동작 방식

• 명시적 인텐트는 클래스 타입 레퍼런스 정보를 이용하므로 액티비티가 없거나, 여러 개일 수 없음
• 암시적 인텐트는 실행할 액티비티를 <action>, <category> 등의 문자열 정보로 나타내므로 없거나 여러 개일 수 있음
  • 없을 때 : 인텐트를 시작한 곳에 오류가 발생
  • 1개일 때 : 문제없이 실행
  • n개일 때 : 사용자 선택으로 하나만 실행
• 실행할 액티비티 없는 경우, 오류가 발생하기 때문에 예외 처리를 해야함
  

    val intent = Intent("ACTION_HELLO")
    try {
    	startActivity(intent)
    } catch (e: Exception){
    	Toast.makeText(this,"no app...",Toast.LENGTH_SHORT).show()
    }

• 사용자의 폰에 실행할 액티비티가 여러 개이면, 다이얼로그를 띄워서 선택한 액티비티를 실행
  

    //지도 앱 액티비티 실행 예시
    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("geo:37.7749,129.4194"))
    startActivity(intent)

→ 지도를 실행할 액티비티가 여러 개(카카오맵, 네이버 지도, T map 등)인 경우, 사용자에게 연결 프로그램 목록을 띄워 선택하게 함

• 이처럼 액티비티가 여러 개일 때 특정 앱의 액티비티를 실행하기 위해서는 해당 앱의 패키지명을 지정
  

    val intent = Intent(Intent.ACTION_VIEW, Uri.parse("geo:37.7749,129.4194"))
    intent.setPackage("com.google.android.apps.maps")
    startActivity(intent)

패키지 공개 상태

• 안드로이드 11(API 레벨 30) 버전부터는 앱의 패키지 공개 상태를 지정하지 않으면 외부 앱의 패키지 정보에 접근할 수 없음
• 인텐트로 외부 앱에 연동하는 부분에는 영향이 없고, 외부 앱을 연동하더라도 패키지 정보를 활용하지 않는다면 문제는 없음
• 하지만, 다음과 같은 함수 사용 시, 패키지 공개 상태에 따라 영향을 받음
  • PackageManager.getPackageInfo()
  • PackageManager.queryIntentActivities()
  • Intent.resolveActivity()
  • PackageManager.getInstalledPakages()
  • PackageManager.getInstalledApplications()
  • bindService()
• 외부 앱 정보 가져오기
  

    val packageInfo = packageManager.getPackageInfo("com.example.text_outter",0)
    val versionName = packageInfo.versionName

• 안드로이드 11버전부터는 적용된 패키지 공개 상태 필터링 때문에 다음과 같은 오류 발생
  • Caused by: android.content.pm.PackageManager$NameNotFoundException: com.example.text_outter
• 매니페스트 파일에 접근하고자 하는 앱의 패키지명 선언하여 오류 해결 !

    <manifest ... 생략 ...>
    	<queries>
    		<package android:name="com.e.ch7_layout" />
    	</queries>
    <manifest>

• <uses-permission> 태그로 허용해 달라고 요청할 수는 있지만, 되도록이면 <queries>태그를 사용할 것