- 문법:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > . . . </intent-filter>
- 포함된 위치:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- 포함해야 하는 요소
<action>
- 포함 가능한 요소
<category>
<data>
- 설명:
- 활동, 서비스, broadcast receiver가 응답할 수 있는 인텐트의 유형을 지정합니다. 인텐트 필터는 상위 구성요소의 기능, 즉 활동이나 서비스가 할 수 있는 작업과 수신기가 처리할 수 있는 브로드캐스트의 유형을 선언합니다. 전달된 유형의 수신 인텐트로 구성요소를 열고 이 구성요소에 의미가 없는 인텐트를 필터링합니다.
필터 내용의 대부분은
<action>
,<category>
,<data>
하위 요소에서 설명됩니다.필터에 관한 자세한 내용은 인텐트 및 인텐트 필터 문서와 소개의 인텐트 필터 섹션을 참고하세요.
- 속성:
android:icon
- 필터에 설명된 기능이 구성요소에 있다는 것을 사용자에게 설명할 때 상위 활동, 서비스, broadcast receiver를 나타내는 아이콘입니다.
이 속성은 이미지 정의가 포함된 드로어블 리소스의 참조로 설정해야 합니다. 기본값은 상위 구성요소의
icon
속성에 의해 설정된 아이콘입니다. 상위 요소가 아이콘을 지정하지 않으면 기본값은<application>
요소에 의해 설정된 아이콘입니다.인텐트 필터 아이콘에 관해 자세히 알아보려면 소개의 아이콘 및 라벨을 참고하세요.
android:label
- 사용자가 읽을 수 있는 상위 구성요소 라벨입니다. 필터에 설명된 기능이 구성요소에 있다는 것을 사용자에게 설명할 때는 상위 구성요소에서 설정한 라벨이 아니라 이 라벨이 사용됩니다.
라벨은 사용자 인터페이스의 다른 문자열처럼 현지화될 수 있도록 문자열 리소스의 참조로 설정해야 합니다. 하지만 애플리케이션을 개발하는 동안 편의를 위해 라벨을 원시 문자열로 설정할 수도 있습니다.
기본값은 상위 구성요소에서 설정한 라벨입니다. 상위 요소가 라벨을 지정하지 않으면 기본값은
<application>
요소의label
속성에서 설정된 라벨입니다.인텐트 필터 라벨에 관해 자세히 알아보려면 소개의 아이콘 및 라벨을 참고하세요.
android:priority
- 필터에 설명된 유형의 인텐트 처리와 관련하여 상위 구성요소에 부여해야 하는 우선순위입니다. 이 속성은 활동과 broadcast receiver에 모두 의미가 있습니다.
- 활동이 필터와 일치하는 인텐트에 응답하는 능력이 같은 인텐트에 응답할 수 있는 다른 활동과 비교할 때 어느 정도인지 알려줍니다. 우선순위가 서로 다른 여러 활동이 인텐트를 처리할 수 있는 경우 Android에서는 우선순위 값이 더 높은 활동만 인텐트의 잠재적 타겟으로 간주합니다.
방송 메시지를 수신하기 위해 broadcast receiver를 실행하는 순서를 제어합니다. 우선순위 값이 더 높은 수신기가 값이 더 낮은 수신기보다 먼저 호출됩니다. 순서는 동기 메시지에만 적용되며 비동기 메시지의 경우 무시됩니다.
브로드캐스트를 반드시 특정 순서에 따라 수신해야 하거나 Android에서 특정 활동을 다른 활동보다 먼저 처리하도록 강제하려는 경우에만 이 속성을 사용하세요.
값은 정수(예: '
100
')여야 합니다. 숫자가 클수록 우선순위가 높습니다. 기본값은 0입니다.상황에 따라 요청된 우선순위가 무시되고 값이
0
으로 제한되기도 합니다. 다음과 같은 경우에 발생합니다.- 권한이 없는 애플리케이션이 0보다 큰 우선순위를 요청하는 경우
- 권한이 있는 애플리케이션이
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
,ACTION_SEND_MULTIPLE
을 위해 0보다 큰 우선순위를 요청하는 경우
setPriority()
도 참고하세요. android:order
- 일치하는 필터가 여럿일 때 필터의 처리 순서입니다.
order
는priority
와는 다릅니다. 즉,priority
는 앱 전체적으로 적용되고order
는 단일 앱에서 일치하는 여러 필터 간의 차이를 구별합니다.여러 필터가 일치할 가능성이 있을 때는 대신 단일 수신자 인텐트를 사용하세요.
값은 정수(예:
100
)여야 합니다. 숫자가 높을수록 먼저 일치됩니다. 기본값은0
입니다.이 속성은 API 수준 28에 도입되었습니다.
android:autoVerify
- 지정된 호스트 내 디지털 애셋 링크 JSON 파일과 이 애플리케이션의 일치 여부를 Android에서 확인해야 하는지를 나타냅니다.
기본값은
false
입니다.이 속성은 API 수준 23에서 도입되었습니다.
- 도입 시기:
- API 수준 1
- 참고 항목:
<action>
<category>
<data>
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2022-10-17(UTC)
[]
[]