<수신자>

문법:

<receiver android:directBootAware=["true" | "false"]
          android:enabled=["true" | "false"]
          android:exported=["true" | "false"]
          android:icon="drawable resource"
          android:label="string resource"
          android:name="string"
          android:permission="string"
          android:process="string" >
    ...
</receiver>

포함된 위치:

<application>

포함 가능한 요소:

<intent-filter>
<meta-data>

설명:

broadcast receiver(BroadcastReceiver 서브클래스)를 애플리케이션의 구성요소 중 하나로 선언합니다. broadcast receiver를 사용하면 애플리케이션의 다른 구성요소가 실행되고 있지 않을 때도 시스템이나 다른 애플리케이션에서 브로드캐스트하는 인텐트를 애플리케이션에서 수신할 수 있습니다.

broadcast receiver를 시스템에 알리는 방법에는 두 가지가 있습니다. 한 가지 방법은 이 요소를 사용해 매니페스트 파일에 broadcast receiver를 선언하는 것입니다. 또 다른 방법은 코드에서 동적으로 broadcast receiver를 만든 다음 Context.registerReceiver() 메서드 또는 오버로드된 버전 중 하나를 사용해 등록하는 것입니다.

broadcast receiver를 동적으로 만드는 방법에 관한 자세한 내용은 BroadcastReceiver 클래스 설명을 참고하세요.

이 broadcast receiver가 시스템 이외의 브로드캐스트를 처리하는 경우 android:exported 값을 지정합니다. broadcast receiver가 다른 애플리케이션에서 브로드캐스트를 수신할 수 있게 하려면 이 값을 "true"로 설정하고 broadcast receiver가 내 앱의 브로드캐스트만 수신할 수 있게 하려면 "false"로 설정합니다.

android:permission 속성을 이미 선언했다면 삭제하지 않아도 됩니다.

경고: 앱에 설정하는 broadcast receiver 수를 제한합니다. broadcast receiver가 너무 많으면 앱 성능과 사용자 기기의 배터리 수명에 영향을 줄 수 있습니다. 백그라운드 작업 예약에 BroadcastReceiver 클래스 대신 사용할 수 있는 API에 관한 자세한 내용은 백그라운드 최적화를 참고하세요.

속성:

android:directBootAware

broadcast receiver가 직접 부팅을 인식하는지 여부입니다. 즉, 사용자가 기기를 잠금 해제하기 전에 기기가 실행될 수 있는지 여부를 지정합니다.

참고: 직접 부팅되는 동안 애플리케이션의 broadcast receiver는 기기 보호 저장소에 저장된 데이터에만 액세스할 수 있습니다.

기본값은 "false"입니다.

android:enabled

시스템에서 broadcast receiver를 인스턴스화할 수 있는지 여부입니다. 인스턴스화할 수 있으면 "true"이고 인스턴스화할 수 없으면 "false"입니다. 기본값은 "true"입니다.

<application> 요소에는 broadcast receiver를 비롯하여 모든 애플리케이션 구성요소에 적용되는 자체 enabled 속성이 있습니다. broadcast receiver를 사용하려면 <application> 및 <receiver> 속성이 모두 "true"여야 합니다. 둘 중 하나가 "false"면 broadcast receiver가 사용 중지되며 인스턴스화될 수 없습니다.

android:exported

broadcast receiver에서 애플리케이션 외부의 비시스템 소스에서 메시지를 수신할 수 있는지 여부입니다. 할 수 있으면 "true"이고 할 수 없으면 "false"입니다. "false"인 경우 broadcast receiver는 시스템이나 동일한 애플리케이션의 구성요소, 사용자 ID가 같은 애플리케이션에서 보낸 메시지만 수신할 수 있습니다.

지정하지 않으면 기본값은 broadcast receiver에 인텐트 필터가 포함되어 있는지에 따라 달라집니다. broadcast receiver에 인텐트 필터가 1개 이상 포함되어 있으면 기본값은 "true"이고 그 외 경우 기본값은 "false"입니다.

이 속성이 broadcast receiver의 외부 노출을 제한하는 유일한 방법은 아닙니다. 권한을 사용해 broadcast receiver에 메시지를 보낼 수 있는 외부 항목을 제한할 수도 있습니다. permission 속성을 참고하세요.

android:icon

broadcast receiver를 나타내는 아이콘입니다. 이 속성은 이미지 정의가 포함된 드로어블 리소스의 참조로 설정됩니다. 이 속성이 설정되지 않은 경우 전체 애플리케이션에 지정된 아이콘이 대신 사용됩니다. <application> 요소의 icon 속성을 참고하세요.

broadcast receiver의 아이콘은 여기에 설정되었는지 또는 <application> 요소에 의해 설정되었는지 여부와 상관없이 모든 receiver 인텐트 필터의 기본 아이콘이기도 합니다. <intent-filter> 요소의 icon 속성을 참고하세요.

android:label

broadcast receiver에 관한 사용자가 읽을 수 있는 라벨입니다. 이 속성을 설정하지 않으면 애플리케이션 전체에 설정된 라벨이 대신 사용됩니다. <application> 요소의 label 속성을 참고하세요.

broadcast receiver의 라벨은 여기에 설정되었는지 또는 <application> 요소에 의해 설정되었는지 여부와 상관없이 모든 broadcast receiver 인텐트 필터의 기본 라벨이기도 합니다. <intent-filter> 요소의 label 속성을 참고하세요.

라벨은 사용자 인터페이스의 다른 문자열처럼 현지화될 수 있도록 문자열 리소스의 참조로 설정합니다. 하지만 애플리케이션을 개발하는 동안 편의를 위해 라벨을 원시 문자열로 설정할 수도 있습니다.

android:name

broadcast receiver를 구현하는 클래스의 이름으로, BroadcastReceiver의 서브클래스입니다. 이 이름은 정규화된 클래스 이름(예: "com.example.project.ReportReceiver")이어야 하지만 하지만 약식으로 이름의 첫 번째 문자가 마침표인 경우(예 ".ReportReceiver") <manifest> 요소에 지정된 패키지 이름에 추가됩니다.

애플리케이션을 게시한 후에는 android:exported="false"를 설정하지 않는 한 이 이름을 변경하지 마세요.

기본값은 없으며, 이름을 지정해야 합니다.

android:permission

broadcaster가 broadcast receiver에 메시지를 보내는 데 필요한 권한 이름입니다. 이 속성이 설정되어 있지 않으면 <application> 요소의 permission 속성에서 설정한 권한이 broadcast receiver에 적용됩니다. 아무 속성도 설정되어 있지 않으면 broadcast receiver가 권한으로 보호되지 않습니다.

권한에 관한 자세한 내용은 앱 매니페스트 개요의 권한 섹션과 보안 도움말을 참고하세요.

android:process

broadcast receiver가 실행되는 프로세스의 이름입니다. 일반적으로 애플리케이션의 모든 구성요소는 애플리케이션용으로 만들어진 기본 프로세스에서 실행됩니다. 애플리케이션 패키지와 이름이 동일합니다.

<application> 요소의 process 속성은 모든 구성요소에 다른 기본값을 설정할 수 있습니다. 하지만 각 구성요소는 고유한 process 속성을 사용해 이 기본값을 재정의할 수 있으므로, 이 방법을 통해 애플리케이션을 여러 프로세스에 확산시킬 수 있습니다.

이 속성에 지정된 이름이 콜론(:)으로 시작되면 필요에 따라 애플리케이션 전용의 새 프로세스가 만들어지고, 이 프로세스에서 broadcast receiver가 실행됩니다.

프로세스 이름이 소문자로 시작되는 경우 broadcast receiver는 그 이름의 전역 프로세스에서 실행됩니다(실행 권한이 있는 경우). 이를 통해 서로 다른 애플리케이션의 구성요소가 프로세스를 공유하여 리소스 사용을 줄일 수 있습니다.

도입 수준:

API 수준 1