[Android] AndroidManifest <receiver>

<receiver>

developer.android.com/guide/topics/manifest/receiver-element?hl=ko

 |  Android 개발자  |  Android Developers

<application>
    ...
    <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">
                  
        ...
    
        <intent-filter>...</intent-filter>
        <meta-data>...</meta-data>
    </receiver>
    ...
</application>

 

broadcast receiver(BroadcastReceiver 서브클래스)를 애플리케이션의 component로 선언한다.

broadcast receiver를 사용하면 애플리케이션이 실행되고 있지 않을 떄에도 시스템이나 다른 애플리케이션에서 브로드케스팅하는 인텐트를 애플리케이션이 수신할 수 있다.

 

broadcast receiver를 시스템에 알리는 방법 두 가지 중 하나가 manifest 파일에 broadcast receiver를 선언하는 것. 다른 방법은 코드에서 등록하는 방식.

 

속성

android:directBootAware

broadcast receiver가 직접 부팅을 인식(direct-boot aware)하는지 여부. 사용자가 기기를 잠금 해제 하기 전에 실행할 수 있는지의 여부. Lock 상태에서 앱이 동작할 것인지의 여부.

기본값은 false

 

android:enabled

시스템에서 broadcast receiver를 인스턴스화할 수 있는지 여부. 할 수 있으면 true, 할 수 없으면 false.

<application>의 enabled 속성도 true여야지, <receiver>의 enabled true 속성이 유효하다.

 

android:exported

broadcast receiver이 애플리케이션 외부로부터 오는 메시지를 수신할 수 있는지의 여부. 

true는 수신 가능. false는 동일한 애플리케이션이나 동일한 user ID를 가진 애플리케이션의 컴포넌트가 보낸 메시지만 수신 가능.

기본값은 인텐트 필터가 없으면 false, 있으면 true. 인텐트 필터가 하나 이상 있다는 것은 broadcast receiver가 시스템이나 다른 애플리케이션에서 브로드캐스팅하는 인텐트를 수신하려고 한다는 의미. 인텐트 필터가 없다면 정확한 클래스 이름을 지정하는 인텐트 객체만 broadcast receiver를 호출할 수 있으니, receiver가 애플리케이션 내부에서만 사용한다는 의미.

 permission 속성으로 exported와 비슷한 효과를 줄 수 있다고 한다.

android:icon

broadcast receiver를 나타내는 아이콘. drawable resource 참조로 설정되어야 한다. 기본값은 <application>의 icon 값.

 

android:label

사용자가 broadcast에 대해 읽을 수 있는 라벨. 이 속성이 설정되지 않으면 <application>의 label 값이 사용된다.

broadcast receiver의 label은 receiver 인텐트 필터의 기본 라벨이 된다.

 

현지화될 수 있게 문자열 리소스 참조로 설정되어야 함. 개발 편의를 위해 원시 문자열로 설정 가능.

 

android:name

broadcast receiver의 클래스 이름. BroadcastReceiver 클래스의 서브클래스. 

애플리케이션 게시가 한 번이라도 이뤄진 경우,  android:exported="false"로 변경하지 않는 한, 이름 값을 변경하면 안된다.

기본값은 없다. 꼭 지정해야 한다.

 

android:permission

broadcaster가 broadcast receiver에게 메시지를 보내는 데 필요한 권한 이름. 

이 속성이 설정되어 있지 않으면 <application>의 permission속성을 가지게 된다.

아무 속성도 설정되어 있지 않으면 receiver가 permission으로 보호되지 않는다.

 

android:process

broadcast receiver를 실행시키는 프로세스의 이름. 보통 애플리케이션의 컴포넌트들은 애플리케이션용으로 생성된 기본 프로세스에서 실행되고, 애플리케이션 패키지오 이름이 동일하다.