lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

인텐트 및 인텐트 필터

Intent는 일종의 메시지 객체입니다. 이것을 사용해 다른 앱 구성 요소로부터 작업을 요청할 수 있습니다. 인텐트가 여러 구성 요소 사이의 통신을 용이하게 하는 데에는 몇 가지 방법이 있지만, 기본적인 사용 사례는 다음과 같은 세 가지입니다.

  • 액티비티 시작:

    Activity는 앱 안의 단일 화면을 나타냅니다. Activity의 새 인스턴스를 시작하려면 IntentstartActivity()로 전달하면 됩니다. Intent는 시작할 액티비티를 설명하고 모든 필수 데이터를 담고 있습니다.

    액티비티가 완료되었을 때 결과를 수신하려면, startActivityForResult()를 호출합니다. 여러분의 액티비티는 해당 결과를 이 액티비티의 onActivityResult() 콜백에서 별도의 Intent 객체로 수신합니다. 자세한 정보는 액티비티 가이드를 참조하세요.

  • 서비스 시작:

    Service는 사용자 인터페이스 없이 백그라운드에서 작업을 수행하는 구성 요소입니다. 서비스를 시작하여 일회성 작업을 수행하도록 하려면(예: 파일 다운로드) IntentstartService()에 전달하면 됩니다. Intent는 시작할 서비스를 설명하고 모든 필수 데이터를 담고 있습니다.

    서비스가 클라이언트-서버 인터페이스로 디자인된 경우, 다른 구성 요소로부터 서비스에 바인드하려면 IntentbindService()에 전달하면 됩니다. 자세한 정보는 서비스 가이드를 참조하세요.

  • 브로드캐스트 전달:

    브로드캐스트는 모든 앱이 수신할 수 있는 메시지입니다. 시스템은 여러 시스템 이벤트에 대해 다양한 브로드캐스트를 전달합니다. 예를 들어 시스템이 부팅될 때 또는 기기가 변경되기 시작할 때 등이 해당됩니다. 다른 여러 앱에 브로드캐스트를 전달하려면 IntentsendBroadcast(), sendOrderedBroadcast() 또는 sendStickyBroadcast()에 전달하면 됩니다.

인텐트 유형

인텐트에는 두 가지 유형이 있습니다.

  • 명시적 인텐트는 시작할 구성 요소를 이름으로 지정합니다(완전히 정규화된 클래스 이름). 명시적 인텐트는 일반적으로 본인의 앱 안에서 구성 요소를 시작할 때 씁니다. 시작하고자 하는 액티비티 또는 서비스의 클래스 이름을 알고 있기 때문입니다. 예를 들어, 사용자 작업에 응답하여 새 액티비티를 시작하거나 백그라운드에서 파일을 다운로드하기 위해 서비스를 시작하는 것 등이 여기에 해당됩니다.
  • 암시적 인텐트는 특정 구성 요소의 이름을 대지 않지만, 그 대신 수행할 일반적일 작업을 선언하여 또 다른 앱의 구성 요소가 이를 처리할 수 있도록 해줍니다. 예를 들어, 사용자에게 지도에 있는 한 위치를 표시해주고자 하는 경우, 암시적 인텐트를 사용하여 다른, 해당 기능을 갖춘 앱이 지정된 위치를 지도에 표시하도록 요청할 수 있습니다.

명시적 인텐트를 생성하여 액티비티나 서비스를 시작하도록 하면, 시스템이 즉시 Intent 객체에서 지정된 앱 구성 요소를 시작합니다.

그림 1. 암시적 인텐트가 시스템을 통해 전달되어 다른 액티비티를 시작하는 방법을 보여주는 그림. [1] 액티비티 A가 작업 설명이 있는 Intent를 생성하여 이를 startActivity()에 전달합니다. [2] Android 시스템이 해당 인텐트와 일치하는 인텐트 필터를 찾아 모든 앱을 검색합니다. 일치하는 항목을 찾으면, [3] 시스템이 일치하는 액티비티(액티비티 B)를 시작하기 위해 그 액티비티의 onCreate() 메서드를 호출하여 이를 Intent에 전달합니다.

암시적 인텐트를 생성하면 Android 시스템이 시작시킬 적절한 구성 요소를 찾습니다. 이때 인텐트의 내용을 기기에 있는 다른 여러 앱의 매니페스트 파일에서 선언된 인텐트 필터와 비교하는 방법을 씁니다. 해당 인텐트와 일치하는 인텐트 필터가 있으면 시스템이 해당 구성 요소를 시작하고 이에 Intent 객체를 전달합니다. 호환되는 인텐트 필터가 여러 개인 경우, 시스템은 대화상자를 표시하여 사용자가 어느 앱을 사용할지 직접 선택할 수 있게 합니다.

인텐트 필터란 앱의 매니페스트 파일에 들어 있는 표현으로, 해당 구성 요소가 수신하고자 하는 인텐트의 유형을 나타낸 것입니다. 예를 들어 액티비티에 대한 인텐트 필터를 선언하면 다른 여러 앱이 특정한 종류의 인텐트를 가지고 여러분의 액티비티를 직접 시작할 수 있습니다. 이와 마찬가지로, 액티비티에 대한 인텐트 필터를 전혀 선언하지 않으면 명시적 인텐트로만 시작할 수 있습니다.

주의: 앱의 보안을 보장하려면 Service를 시작할 때에는 항상 명시적 인텐트만 사용하고 서비스에 대한 인텐트 필터는 선언하지 마세요. 암시적 인텐트를 사용하여 서비스를 시작하면 보안 위험을 초래합니다. 인텐트에 어느 서비스가 응답할 것인지 확신할 수 없고, 사용자가 어느 서비스가 시작되는지 볼 수 없기 때문입니다. Android 5.0(API 레벨 21)부터 시스템은 개발자가 암시적 인텐트로 bindService()를 호출하면 예외를 발생시킵니다.

인텐트 구축

Intent 객체에는 Android 시스템이 어느 구성 요소를 시작할지 판별하는 데 사용하는 정보가 담겨 있습니다(예를 들어 정확한 구성 요소 이름 또는 인텐트를 수신해야 하는 구성 요소 카테고리 등). 또한 수신자 구성 요소가 작업을 적절히 수행하기 위해 사용할 정보(예: 수행할 작업 및 조치를 취할 데이터 위치 등)도 이 안에 담겨 있습니다.

Intent에 포함된 기본 사항은 다음과 같습니다.

구성 요소 이름
시작할 구성 요소의 이름입니다.

이것은 선택 항목이지만, 이것이 바로 인텐트를 명시적인 것으로 만들어주는 중요한 정보입니다. 다시 말해 이 인텐트는 구성 요소 이름이 정의한 앱 구성 요소에만 전달되어야 한다는 뜻입니다. 구성 요소 이름이 없으면 해당 인텐트는 암시적이며, 인텐트를 수신해야 하는 구성 요소는 다른 인텐트 정보를 기반으로 시스템이 결정합니다(예를 들어 작업, 데이터 및 카테고리 — 아래 설명 참조). 따라서 앱에서 특정한 구성 요소를 시작해야 하는 경우에는, 구성 요소 이름을 지정해야 합니다.

참고: Service를 시작하는 경우, 항상 구성 요소 이름을 지정해야 합니다. 그렇지 않으면 인텐트에 어느 서비스가 응답할지 확신할 수 없고, 사용자도 어느 서비스가 시작되는지 볼 수 없게 됩니다.

Intent의 필드는 ComponentName 객체로, 대상 구성 요소의 정규화된 클래스 이름(앱의 패키지 이름 포함)을 사용하여 지정할 수 있습니다. 예: com.example.ExampleActivity 구성 요소 이름을 설정하려면 setComponent(), setClass(), setClassName()을 사용하거나 또는 Intent 생성자를 사용합니다.

작업
수행할 일반적인 작업을 나타내는 문자열입니다(예: 보기 또는 선택).

브로드캐스트 인텐트의 경우, 이것이 발생한 작업이자 보고되는 것이기도 합니다. 인텐트의 나머지 부분이 어떻게 구조화될지는 대부분 작업이 결정합니다. 특히, 데이터 안에 들어 있는 것과 엑스트라 등이 해당됩니다.

본인의 앱 내에 있는 인텐트가 사용할 작업(또는 다른 앱이 사용하여 본인의 앱 안의 구성 요소를 호출하도록 함)을 직접 지정할 수도 있지만, 보통은 Intent 클래스나 다른 프레임워크 클래스가 정의한 작업 상수를 써야 합니다. 다음은 액티비티를 시작하는 데 쓰이는 보편적인 작업입니다.

ACTION_VIEW
이 작업은 액티비티가 사용자에게 표시할 수 있는 어떤 정보를 가지고 있을 때 startActivity()가 있는 인텐트에서 사용합니다. 예를 들어 갤러리 앱에서 볼 사진이나 지도 앱에서 볼 주소 등이 이에 해당됩니다.
ACTION_SEND
"공유" 인텐트라고도 하며, 사용자가 다른 앱을 통해 공유할 수 있는 데이터를 가지고 있을 때 startActivity()가 있는 인텐트에서 사용해야 합니다. 예를 들어 이메일 앱 또는 소셜 공유 앱 등이 이에 해당됩니다.

일반적인 작업을 정의하는 상수에 대한 자세한 내용은 Intent 클래스 참조를 확인하세요. 다른 작업은 Android 프레임워크의 다른 곳에서 정의됩니다. 예를 들어 시스템의 설정 앱에서 특정 화면을 여는 작업의 경우 Settings에서 정의됩니다.

인텐트에 대한 작업을 지정하려면 setAction() 또는 Intent 생성자를 사용하면 됩니다.

나름의 작업을 직접 정의하는 경우, 앱의 패키지 이름을 접두어로 포함시켜야 합니다. 예:

static final String ACTION_TIMETRAVEL = "com.example.action.TIMETRAVEL";
데이터
작업을 수행할 데이터 및/또는 해당 데이터의 MIME 유형을 참조하는 URI(Uri 객체)입니다. 제공된 데이터의 유형을 나타내는 것은 일반적으로 인텐트의 작업입니다. 예를 들어 인텐트가 ACTION_EDIT인 경우, 데이터에 편집할 문서의 URI가 들어있어야 합니다.

인텐트를 생성할 때에는 URI외에도 데이터의 유형(MIME 유형)을 지정하는 것이 중요한 경우가 많습니다. 예를 들어, 이미지를 표시할 수 있는 액티비티는 아마도 오디오 파일을 재생할 수 없을 가능성이 큽니다. 두 가지 기능의 URI 형식은 비슷할지라도 말입니다. 그러므로 데이터의 MIME 유형을 지정해두면 Android 시스템이 인텐트를 수신할 최상의 구성 요소를 찾는 데 도움이 됩니다. 하지만, MIME 유형은 URI에서 추론되는 경우도 종종 있습니다. 특히 데이터가 content: URI인 경우 더욱 그러한데, 이는 데이터가 기기에 위치하고 있으며 ContentProvider가 제어한다는 것을 나타내어 해당 데이터 MIME 유형이 시스템에 표시되도록 합니다.

데이터 URI만 설정하려면 setData()를 호출하세요. MIME 유형만 설정하려면, setType()을 호출합니다. 필요한 경우, setDataAndType()을 사용하여 두 가지를 모두 명시적으로 설정할 수 있습니다.

주의: URI와 MIME 유형을 둘 다 설정하고자 하는 경우, setData()setType()을 호출하면 안 됩니다. 이 둘은 서로의 값을 무효화하기 때문입니다. URI와 MIME 유형을 둘 모두 설정하려면 항상 setDataAndType()을 사용하세요.

카테고리
인텐트를 처리해야 하는 구성 요소의 종류에 관한 추가 정보를 담은 문자열입니다. 인텐트 안에는 카테고리 설명이 얼마든지 들어있을 수 있지만, 대부분의 인텐트에는 카테고리가 없어도 됩니다. 다음은 몇 가지 보편적인 카테고리입니다.
CATEGORY_BROWSABLE
대상 액티비티가 스스로 웹 브라우저가 자신을 시작해도 되도록 허용하여 링크로 참조된 데이터를 표시하게 합니다. 예컨대 이미지나 이메일 메시지 등이 이에 해당합니다.
CATEGORY_LAUNCHER
이 액티비티가 작업의 최초 액티비티이며, 이것이 시스템의 애플리케이션 시작 관리자에 목록으로 게재되어 있습니다.

카테고리의 전체 목록을 보려면 Intent 클래스 설명을 참조하세요.

카테고리를 지정하려면 addCategory()를 사용하면 됩니다.

위에 나열된 이러한 특성(구성 요소 이름, 작업, 데이터 및 카테고리)은 인텐트를 정의하는 특성을 나타냅니다. Android 시스템은 이와 같은 속성을 읽어 어느 앱 구성 요소를 시작해야 할지 확인할 수 있습니다.

그러나 인텐트는 앱 구성 요소로 확인되는 방법에 영향을 미치지 않는 추가 정보도 담고 있을 수 있습니다. 인텐트가 제공할 수 있는 기타 정보는 다음과 같습니다.

엑스트라
요청한 작업을 수행하기 위해 필요한 추가 정보를 담고 있는 키-값 쌍입니다. 몇몇 작업이 특정한 종류의 데이터 URI를 사용하는 것과 마찬가지로, 몇몇 작업은 특정한 엑스트라도 사용합니다.

엑스트라 데이터를 추가하려면 여러 가지 putExtra() 메서드를 사용할 수 있습니다. 이들은 각기 두 개의 매개변수를 허용합니다. 즉 키 이름과 값입니다. 모든 추가 데이터를 가진 Bundle 객체를 생성할 수도 있고, 그런 다음 BundleIntentputExtras()로 삽입해도 됩니다.

예를 들어 ACTION_SEND로 이메일을 전송할 인텐트를 생성하는 경우 "받는 사람" 수신자를 지정할 때 EXTRA_EMAIL 키를 사용한 다음 "제목"은 EXTRA_SUBJECT 키로 지정하면 됩니다.

Intent 클래스는 표준화된 데이터 유형에 대해 수많은 EXTRA_* 상수를 지정합니다. 나름의 추가 키를 선언해야 하는 경우(본인의 앱이 수신할 인텐트에 대하여), 앱의 패키지 이름을 접두어로 포함시커야 합니다. 예:

static final String EXTRA_GIGAWATTS = "com.example.EXTRA_GIGAWATTS";
플래그
Intent 클래스에서 정의된 플래그로, 인텐트에 대한 메타데이터와 같은 기능을 합니다. 이런 플래그는 Android 시스템에 액티비티를 시작할 방법에 대한 지침을 줄 수도 있고(예를 들어 액티비티가 어느 작업에 소속되어야 하는지 등) 액티비티를 시작한 다음에 어떻게 처리해야 하는지도 알려줄 수 있습니다(예를 들어 해당 액티비티가 최근 액티비티 목록에 소속되는지 여부).

자세한 정보는 setFlags() 메서드를 참조하세요.

명시적 인텐트 예시

명시적 인텐트는 앱 내의 특정 액티비티나 서비스 등 특정한 앱 구성 요소를 시작하기 위해 사용하는 인텐트입니다. 명시적 인텐트를 생성하려면 Intent 객체에 대한 구성 요소 이름을 정의합니다. 다른 인텐트 속성은 모두 선택 사항입니다.

예를 들어 앱 안에 DownloadService라는 서비스를 구축했다고 합시다. 이 서비스는 웹 상에서 파일을 다운로드하도록 설계된 것입니다. 이것을 시작하려면 다음과 같은 코드를 사용하면 됩니다.

// Executed in an Activity, so 'this' is the Context
// The fileUrl is a string URL, such as "http://www.example.com/image.png"
Intent downloadIntent = new Intent(this, DownloadService.class);
downloadIntent.setData(Uri.parse(fileUrl));
startService(downloadIntent);

Intent(Context, Class) 생성자가 앱에 Context를 제공하고 구성 요소에 Class 객체를 제공합니다. 이처럼, 이 인텐트는 앱 내의 DownloadService 클래스를 명시적으로 시작합니다.

서비스를 구축하고 시작하는 데 대한 자세한 정보는 서비스 가이드를 참조하세요.

암시적 인텐트 예시

암시적 인텐트는 작업을 지정하여 기기에서 해당 작업을 수행할 수 있는 모든 앱을 호출할 수 있도록 합니다. 암시적 인텐트를 사용하면 본인의 앱은 작업을 수행할 수 없지만 다른 앱은 아마도 할 수 있을 때, 그리고 사용자로 하여금 어느 앱을 사용할지 선택하도록 하고자 할 때 유용합니다.

예를 들어 사용자가 다른 사람들과 공유했으면 하는 콘텐츠를 가지고 있는 경우, ACTION_SEND 작업이 있는 인텐트를 생성한 다음 공유할 콘텐츠를 지정하는 엑스트라를 추가하면 됩니다. 해당 인텐트로 startActivity()를 호출하면 사용자가 어느 앱을 통해 콘텐츠를 공유할지 선택할 수 있습니다.

주의: 개발자가 startActivity()로 전송한 암시적 인텐트를 처리할 앱이 사용자에게 전혀 표시되지 않을 수도 있습니다. 이런 일이 발생하면, 호출이 실패하고 앱이 작동 중단됩니다. 어느 액티비티든 이 인텐트를 수신하도록 확실히 하려면, Intent 객체의 resolveActivity()를 호출합니다. 결과가 null이 아닌 경우, 인텐트를 처리할 수 있는 앱이 최소한 하나는 있다는 뜻이며 startActivity()를 호출해도 안전합니다. 결과가 null이면, 해당 인텐트를 사용해서는 안 되며 가능한 경우 해당 인텐트를 발생시키는 기능을 비활성화해야 합니다.

// Create the text message with a string
Intent sendIntent = new Intent();
sendIntent.setAction(Intent.ACTION_SEND);
sendIntent.putExtra(Intent.EXTRA_TEXT, textMessage);
sendIntent.setType("text/plain");

// Verify that the intent will resolve to an activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(sendIntent);
}

참고: 이 경우 URI가 사용되지 않지만 엑스트라에 의해 전달되는 콘텐츠를 지정하도록 인텐트의 데이터 유형이 선언됩니다.

startActivity()가 호출되면 시스템이 설치된 앱을 모두 살펴보고 이런 종류의 인텐트를 처리할 수 있는 앱이 어느 것인지 알아봅니다(ACTION_SEND 작업을 포함하고 "text/plain" 데이터를 전달하는 인텐트). 이것을 처리할 수 있는 앱이 하나뿐이면, 해당 앱이 즉시 열리고 이 앱에 인텐트가 주어집니다. 인텐트를 허용하는 액티비티가 여러 개인 경우, 시스템은 대화상자를 표시하여 사용자가 어느 앱을 사용할지 직접 선택할 수 있게 합니다.

그림 2. 선택기 대화상자.

앱 선택기 강제 적용

암시적 인텐트에 응답하는 앱이 하나 이상인 경우, 사용자가 어느 앱을 사용할지 선택할 수 있으며 해당 앱을 이 작업에 대한 기본 선택으로 만들 수 있습니다. 이는 사용자가 이제부터 계속 같은 앱을 사용하고자 할 것이라고 추정되는 작업을 수행할 때 좋습니다. 예를 들어 웹 페이지를 열 때가 이에 해당됩니다(대다수 사용자가 웹 브라우저는 하나만 사용하는 것을 선호합니다).

그러나, 인텐트에 응답할 수 있는 앱이 여러 개이고 사용자가 매번 다른 앱을 사용하기를 원할 수도 있는 경우라면, 선택기 대화상자를 명시적으로 표시해야 합니다. 선택기 대화상자는 사용자가 작업에 사용할 앱을 매번 선택하도록 물어봅니다(사용자는 작업에 사용할 기본 앱을 선택할 수 없습니다). 예를 들어 앱이 ACTION_SEND 작업에 "공유"를 수행하는 경우, 사용자는 각자의 현재 상황에 따라 여러 가지 다른 앱을 사용하여 공유하기를 원할 수도 있습니다. 따라서 항상 선택기 대화상자를 사용해야 합니다(그림 2 참조).

선택기를 표시하려면, createChooser()를 사용하여 Intent를 만들고 startActivity()에 전달합니다. 예:

Intent sendIntent = new Intent(Intent.ACTION_SEND);
...

// Always use string resources for UI text.
// This says something like "Share this photo with"
String title = getResources().getString(R.string.chooser_title);
// Create intent to show the chooser dialog
Intent chooser = Intent.createChooser(sendIntent, title);

// Verify the original intent will resolve to at least one activity
if (sendIntent.resolveActivity(getPackageManager()) != null) {
    startActivity(chooser);
}

이 예시는 createChooser() 메서드에 전달된 인텐트에 응답하는 앱들의 목록을 대화상자에 표시하며, 제공된 텍스트를 대화상자 제목으로 사용합니다.

암시적 인텐트 수신

본인의 앱이 수신할 수 있는 암시적 인텐트가 어느 것인지 알리려면, 각 앱 구성 요소에 대한 하나 이상의 인텐트 필터를 <intent-filter> 요소로 매니페스트 파일에 선언합니다. 각 인텐트 필터가 인텐트의 작업, 데이터 및 카테고리를 근거로 어느 유형의 인텐트를 허용하는지 나타냅니다. 시스템이 앱 구성 요소에 암시적 인텐트를 전달하는 것은 인텐트가 개발자의 인텐트 필터 중 하나를 통과해 지나갈 수 있는 경우뿐입니다.

참고: 명시적 인텐트는 항상 자신의 대상에 전달되며, 이는 구성 요소가 어떤 인텐트 필터를 선언하든 무관합니다.

앱 구성 요소는 자신이 수행할 수 있는 각 고유한 작업에 대해 별도의 필터를 선언해야 합니다. 예를 들어 이미지 갤러리 앱에 있는 한 액티비티에 두 개의 필터가 있을 수 있습니다. 한 필터는 이미지를 보고, 또 다른 필터는 이미지를 편집하기 위한 것입니다. 액티비티가 시작되면, 이는 Intent를 검사한 다음 Intent에 있는 정보를 근거로 어떻게 동작할 것인지 결정합니다(편집기 제어 항목을 표시할 것인지 말 것인지 등).

각 인텐트 필터는 앱의 매니페스트 파일에 있는 <intent-filter> 요소에 의해 정의되며, 이는 상응하는 앱 구성 요소에 중첩되어 있습니다(예: <activity> 요소). <intent-filter> 내부에서는 다음과 같은 세 가지 요소 중 하나 이상을 사용하여 허용할 인텐트 유형을 지정할 수 있습니다.

<action>
name 특성에서 허용된 인텐트 작업을 선언합니다. 이 값은 어떤 작업의 리터럴 문자열 값이어야 하며, 클래스 상수가 아닙니다.
<data>
허용된 데이터 유형을 선언합니다. 이때 데이터 URI(scheme, host, port, path 등)와 MIME 유형의 여러 가지 측면을 나타내는 하나 이상의 속성을 사용하는 방법을 씁니다.
<category>
name 특성에서 허용된 인텐트 카테고리를 선언합니다. 이 값은 어떤 작업의 리터럴 문자열 값이어야 하며, 클래스 상수가 아닙니다.

참고: 암시적 인텐트를 수신하려면 인텐트 필터 안에 CATEGORY_DEFAULT 카테고리를 반드시 포함해야 합니다. startActivity()startActivityForResult() 메서드는 모든 인텐트를 마치 CATEGORY_DEFAULT 카테고리를 선언한 것처럼 취급합니다. 이 카테고리를 인텐트 필터에서 선언하지 않으면 액티비티에 어떤 암시적 인텐트도 확인되지 않습니다.

예를 들어, 다음은 데이터 유형이 텍스트인 경우 ACTION_SEND 인텐트를 수신할 인텐트 필터가 있는 액티비티 선언입니다.

<activity android:name="ShareActivity">
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
</activity>

<action>, <data> 또는 <category>의 인스턴스가 하나 이상 포함된 필터를 생성해도 됩니다. 그렇게 하는 경우, 그저 해당 구성 요소가 그와 같은 필터 요소의 모든 조합을 처리할 수 있도록 확실히 하기만 하면 됩니다.

여러 가지 종류의 인텐트를 처리하고자 하되 특정 조합의 작업, 데이터 및 카테고리 유형으로만 한정하고자 한다면 여러 가지 인텐트 필터를 생성해야 합니다.

암시적 인텐트를 필터에 대해 테스트하려면 인텐트를 세 가지 요소에 대해 각기 비교합니다. 인텐트가 구성 요소에 전달되려면 해당 인텐트는 세 개의 테스트를 모두 통과해야 합니다. 하나라도 일치하지 못하고 실패하면 Android 시스템이 해당 인텐트를 구성 요소에 전달하지 않습니다. 그러나 구성 요소에는 여러 개의 인텐트 필터가 있을 수도 있으므로, 구성 요소의 필터 중 하나를 통과하지 않는 인텐트도 다른 필터를 통하면 성공할 수 있습니다. 시스템이 인텐트를 확인하는 방법에 대한 자세한 정보는 인텐트 확인에 대해 다룬 아래 섹션에 제공되어 있습니다.

주의: 부주의로 다른 앱의 Service를 실행하는 일을 피하려면, 항상 명시적 인텐트를 사용하여 본인의 서비스를 시작하고 서비스에 대한 인텐트 필터는 선언하지 마세요.

참고: 액티비티 전체에 대해 인텐트 필터를 매니페스트 파일에서 선언해야 합니다. 다만 브로드캐스트 수신기에 대한 필터의 경우 동적으로 등록할 수도 있습니다. registerReceiver()를 호출하면 됩니다. 그런 다음 unregisterReceiver()를 사용하여 해당 수신기를 등록 해제할 수 있습니다. 이렇게 하면 앱이 실행되는 동안에 정해진 기간 동안만 특정한 브로드캐스트에 대해 수신 대기할 수 있습니다.

필터 예시

몇 가지 인텐트 필터 동작에 대해 이해를 돕기 위해 소셜 공유 앱의 매니페스트 파일에서 가져온 다음 스니펫을 참조하세요.

<activity android:name="MainActivity">
    <!-- This activity is the main entry, should appear in app launcher -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<activity android:name="ShareActivity">
    <!-- This activity handles "SEND" actions with text data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="text/plain"/>
    </intent-filter>
    <!-- This activity also handles "SEND" and "SEND_MULTIPLE" with media data -->
    <intent-filter>
        <action android:name="android.intent.action.SEND"/>
        <action android:name="android.intent.action.SEND_MULTIPLE"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:mimeType="application/vnd.google.panorama360+jpg"/>
        <data android:mimeType="image/*"/>
        <data android:mimeType="video/*"/>
    </intent-filter>
</activity>

첫 번째 액티비티인 MainActivity는 앱의 주요 진입 지점입니다. 즉 이것은 사용자가 시작 관리자 아이콘을 사용하여 앱을 처음 시작할 때 열리는 액티비티입니다.

  • ACTION_MAIN 작업은 이것이 주요 진입 지점이며 어느 인텐트 데이터도 기대하지 않는다는 것을 나타냅니다.
  • CATEGORY_LAUNCHER 카테고리는 이 액티비티의 아이콘이 시스템의 앱 시작 관리자에 배치되어야 한다는 것을 나타냅니다. <activity> 요소가 아이콘을 icon으로 지정하지 않은 경우, 시스템은 <application> 요소로부터 가져온 아이콘을 사용합니다.

이들 두 가지가 짝을 이루어야 액티비티가 앱 시작 관리자에 나타날 수 있습니다.

두 번째 액티비티인 ShareActivity는 텍스트와 미디어 콘텐츠 공유를 용이하게 할 목적으로 만들어진 것입니다. 사용자가 MainActivity에서 이 액티비티로 이동하여 진입할 수도 있지만, 두 가지 인텐트 필터 중 하나와 일치하는 암시적 인텐트를 발생시키는 또 다른 앱에서 ShareActivity에 직접 진입할 수도 있습니다.

참고: MIME 유형, 즉 application/vnd.google.panorama360+jpg는 파노라마 사진을 지정하는 특수 데이터 유형으로, Google Panorama API로 처리할 수 있습니다.

보류 인텐트 사용

PendingIntent 객체는 Intent 객체 주변을 감싸는 래퍼입니다. PendingIntent의 기본 목적은 외래 애플리케이션에 권한을 허가하여 안에 들어 있는 Intent를 마치 본인 앱의 자체 프로세스에서 실행하는 것처럼 사용하게 하는 것입니다.

보류 인텐트의 주요 사용 사례는 다음과 같습니다.

  • 사용자가 여러분의 알림으로 작업을 수행할 때 인텐트가 실행되도록 선언합니다(Android 시스템의 NotificationManagerIntent를 실행합니다).
  • 사용자가 여러분의 앱 위젯으로 작업을 수행할 때 인텐트가 실행되도록 선언합니다(메인 화면 앱이 Intent를 실행합니다).
  • 향후 지정된 시간에 인텐트가 실행되도록 선언합니다(Android 시스템의 AlarmManagerIntent를 실행합니다).

Intent 객체는 특정한 유형의 앱 구성 요소가(Activity, Service 또는 BroadcastReceiver) 처리하도록 설계되어 있기 때문에, PendingIntent도 같은 고려 사항을 염두에 두고 생성해야 합니다. 보류 인텐트를 사용하는 경우, 여러분의 앱은 startActivity()와 같은 호출이 있는 앱을 실행하지 않게 됩니다. 대신 PendingIntent를 생성할 때 원래 의도한 구성 요소 유형을 선언해야 합니다. 이때 각각의 생성자 메서드를 호출하는 방법을 씁니다.

여러분의 앱이 다른 여러 앱에서 보류 인텐트를 수신하는 것이 아닌 한, 위의 메서드를 사용하여 PendingIntent를 생성하는 것이 아마도 여러분에게 필요한 유일한 PendingIntent 메서드일 것입니다.

각 메서드는 현재 앱의 Context, 랩하고자 하는 Intent와 인텐트의 적절한 사용 방식을 나타내는 하나 이상의 플래그(인텐트를 한 번 이상 사용할 수 있는지 등) 등을 취합니다.

보류 인텐트 사용에 관한 자세한 정보는 각 해당되는 사용 사례에 대한 문서에 제공되어 있습니다. 예를 들어 NotificationsApp Widgets API 가이드가 이에 해당됩니다.

인텐트 확인

시스템이 액티비티를 시작하라는 암시적 인텐트를 수신하면, 시스템은 해당 인텐트에 대한 최선의 액티비티를 검색합니다. 이때 다음과 같은 세 가지 측면을 근거로 인텐트를 인텐트 필터에 비교해 보는 방법을 씁니다.

  • 인텐트 작업
  • 인텐트 데이터(URI와 데이터 유형 둘 다)
  • 인텐트 카테고리

다음 섹션에서는 인텐트 필터가 앱 매니페스트 파일에서 어떻게 선언되었는지에 따라, 인텐트가 적절한 구성 요소에 매칭되는 방식을 설명합니다.

작업 테스트

허용된 인텐트 작업을 나타내기 위해 인텐트 필터는 0개 이상의 <action> 요소를 선언할 수 있습니다. 예:

<intent-filter>
    <action android:name="android.intent.action.EDIT" />
    <action android:name="android.intent.action.VIEW" />
    ...
</intent-filter>

이 필터를 통과하려면 Intent에 지정된 작업이 필터에 나열된 작업 중 하나와 일치해야만 합니다.

필터에 나열된 작업이 없는 경우, 인텐트가 일치될 대상이 아무것도 없으므로 모든 인텐트가 테스트에 실패합니다. 그러나, Intent가 작업을 지정하지 않는 경우, 테스트를 통과하게 됩니다(필터에 최소한 한 개 이상의 작업이 들어있지 않은 한).

카테고리 테스트

허용된 인텐트 카테고리를 나타내기 위해, 인텐트 필터는 0개 이상의 <category> 요소를 선언할 수 있습니다. 예:

<intent-filter>
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    ...
</intent-filter>

인텐트가 카테고리 테스트를 통과하려면 Intent 내의 모든 카테고리가 필터 내의 카테고리에 일치해야 합니다. 이 반대로는 반드시 성립하지 않아도 됩니다. 인텐트 필터가 Intent에서 지정된 것보다 더 많은 카테고리를 선언할 수도 있지만 그래도 Intent는 통과합니다. 그러므로, 카테고리가 없는 인텐트라면 필터에 어떤 카테고리가 선언되어 있는지와는 무관하게 이 테스트를 항상 통과하는 것이 맞습니다.

참고: Android는 startActivity()startActivityForResult()에 전달된 모든 암시적 인텐트에 CATEGORY_DEFAULT 카테고리를 적용합니다. 따라서 액티비티가 암시적 인텐트를 수신하기를 원하는 경우, 그 인텐트 필터 내에 "android.intent.category.DEFAULT"에 대한 카테고리가 반드시 포함되어 있어야 합니다(이전의 <intent-filter> 예시 참조).

데이터 테스트

허용된 인텐트 데이터를 나타내려면 인텐트 필터는 0개 이상의 <data> 요소를 선언할 수 있습니다. 예:

<intent-filter>
    <data android:mimeType="video/mpeg" android:scheme="http" ... />
    <data android:mimeType="audio/mpeg" android:scheme="http" ... />
    ...
</intent-filter>

<data> 요소는 URI 구조와 데이터 유형(MIME 미디어 유형)을 나타낼 수 있습니다. URI의 각 부분에 대해 별도의 속성—scheme, host, portpath—이 있습니다.

<scheme>://<host>:<port>/<path>

예:

content://com.example.project:200/folder/subfolder/etc

이 URI에서 구성표는 content, 호스트는 com.example.project, 포트는 200, 경로는 folder/subfolder/etc입니다.

이와 같은 특성은 각각 <data> 요소에서 선택 항목이지만, 이들 사이에 선형 종속성이 있습니다.

  • 구성표가 지정되지 않으면 호스트가 무시됩니다.
  • 호스트가 지정되지 않으면 포트가 무시됩니다.
  • 구성표와 호스트가 둘 다 지정되지 않으면 경로가 무시됩니다.

인텐트 안의 URI가 필터 안의 URI 사양에 비교되는 경우, 이것은 필터 내에 포함된 URI의 몇몇 부분에만 비교되는 것입니다. 예:

  • 필터가 구성표만 지정하는 경우, 해당 구성표가 있는 모든 URI가 필터와 일치합니다.
  • 필터가 구성표와 권한은 지정하지만 경로는 지정하지 않는 경우, 같은 구성표와 권한이 있는 모든 URI가 경로와 관계 없이 필터를 통과합니다.
  • 필터가 구성표, 권한과 경로를 지정하는 경우 같은 구성표, 권한과 경로가 있는 URI만 해당 필터를 통과합니다.

참고: 경로 사양에는 경로 이름이 부분적으로만 일치하도록 요구하기 위해 와일드카드 별표(*)가 들어 있을 수 있습니다.

데이터 테스트는 인텐트 안의 URI와 MIME 유형 둘 모두를 필터 안에서 지정된 MIME 유형과 비교합니다. 규칙은 다음과 같습니다.

  1. URI도 MIME 유형도 들어 있지 않은 인텐트가 테스트를 통과하는 것은 필터가 URI나 MIME 유형을 전혀 지정하지 않은 경우뿐입니다.
  2. URI는 들어 있지만 MIME 유형은 없는 인텐트(URI로부터는 명시적이지도 않고 추론할 수도 없음)가 테스트를 통과하는 것은 그 URI가 필터의 URI 형식과 일치하며 필터가 인텐트와 마찬가지로 MIME 유형을 지정하지 않는 경우뿐입니다.
  3. MIME 유형은 들어 있지만 URI는 없는 인텐트가 테스트를 통과하는 것은 해당 필터가 같은 MIME 유형을 나열하지만 URI 형식은 지정하지 않은 경우뿐입니다.
  4. URI와 MIME 유형이 둘 다 들어 있는 인텐트(URI로부터는 명시적이지도 않고 추론할 수도 없음)가 테스트의 MIME 유형 부분을 통과하는 것은 해당 유형이 필터 내에 나열된 유형과 일치하는 경우뿐입니다. 이 인텐트가 테스트의 URI 부분을 통과하는 경우는 URI가 필터 내의 URI와 일치하는 경우나, content: 또는 file: URI가 있고 필터가 URI를 지정하지 않은 경우입니다. 달리 말하면, 필터가 MIME 유형만을 나열하는 경우, 구성 요소가 content:file: 데이터를 지원하는 것으로 간주됩니다.

마지막 규칙인 규칙 (d)는 구성 요소가 파일이나 콘텐츠 제공자로부터 로컬 파일을 가져올 수 있는지에 대한 기대 수준을 반영합니다. 따라서 이러한 필터는 데이터 유형만 목록으로 나열해도 되고, content:file: 구성표의 이름을 명시적으로 제시하지 않아도 됩니다. 이는 일반적인 경우입니다. 예를 들어, 다음 예시와 같은 <data> 요소는 구성 요소가 콘텐츠 제공자에서 이미지 데이터를 가져와 표시할 수 있다고 Android에 알립니다.

<intent-filter>
    <data android:mimeType="image/*" />
    ...
</intent-filter>

대부분의 사용 가능한 데이터는 콘텐츠 제공자가 제공하는 것이므로, 데이터 유형은 지정하지만 URI는 지정하지 않는 필터가 아마 가장 보편적인 유형일 것입니다.

또 다른 보편적인 구성을 예로 들자면 구성표와 데이터 유형을 가진 필터가 있겠습니다. 예를 들어 다음 예시와 같은 <data> 요소는 구성 요소가 작업을 수행하기 위해 네트워크에서 비디오 데이터를 검색할 수 있다고 Android에 알립니다.

<intent-filter>
    <data android:scheme="http" android:type="video/*" />
    ...
</intent-filter>

인텐트 일치

인텐트를 인텐트 필터에 비교해 일치시키면 활성화할 대상 구성 요소를 찾아낼 수 있을 뿐만 아니라, 기기에 있는 일련의 구성 요소에 대해 무언가 알아낼 수도 있습니다. 예를 들어 홈 앱이 앱 시작 관리자를 채우려면 ACTION_MAIN 작업과 CATEGORY_LAUNCHER 카테고리를 지정하는 인텐트 필터를 가진 액티비티를 모두 찾아야 합니다.

여러분의 애플리케이션도 이와 비슷한 방식으로 인텐트 매칭을 사용할 수 있습니다. PackageManager에 있는 query...() 메서드 집합은 특정 인텐트를 허용하는 구성 요소를 모두 반환하며, 이와 유사한 일련의 resolve...() 메서드는 한 인텐트에 응답하는 데 가장 좋은 구성 요소를 판별합니다. 예를 들어, queryIntentActivities()는 인수로 전달된 인텐트를 수행할 수 있는 모든 액티비티의 목록을 반환하며, {@linkandroid.content.pm.PackageManager#queryIntentServices queryIntentServices()}는 이와 비슷한 서비스 목록을 반환합니다. 어느 메서드도 구성 요소를 활성화하지는 않으며 다만 응답할 수 있는 것들을 목록으로 나열할 뿐입니다. 이와 비슷한 메서드인 queryBroadcastReceivers()는 브로드캐스트 수신기에 쓰입니다.