<receiver
android:enabled=["true" | "false"]
android:exported=["true" | "false"]
android:icon="drawable resource"
android:label="string resource"
android:name=".MBroadcastReceiver"
android:permission="string"
android:process="string" >
//用于接收網絡狀態改變時發出的廣播
<intent-filter android:priority="1">
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
</receiver>
- android:enabled
這個屬性用于定義系統是否能夠實例化這個廣播接收器,如果設置為true,則能夠實例化,如果設置為false,則不能被實例化。默認值是true。
<application>
元素有它自己的enabled
屬性,這個屬性會應用給應用程序的所有組件,包括廣播接收器。<application>
和<receiver>
元素的這個屬性都必須是true,這個廣播接收器才能夠被啟用。如果有一個被設置為false,該廣播接收器會被禁止實例化。
- android:exported
這個屬性用于指示該廣播接收器是否能夠接收來自應用程序外部的消息,如果設置true,則能夠接收,如果設置為false,則不能夠接收。如果設置為false,這該接收只能接收那些由相同應用程序組件或帶有相同用戶ID的應用程序所發出的消息。
它的默認值依賴它所包含的Intent過濾器。如果不包含過濾器,則接收器只能由指定了明確類名的Intent對象來調用,這就意味著該接收器只能在應用程序內部使用(因為通常在應用程序外部是不會知道這個類名的)。這種情況下默認值就是false。另一方面,如果接受器至少包含了一個過濾器,那么就意味著這個接收器能夠接收來自系統或其他應用程序的Intent對象,因此默認值是true。
這個屬性不是唯一的限制廣播接收外部調用的方法,還能夠通過全限來限制能夠給它發送消息的外部實體。
- android:icon
這個屬性定義了一個代表廣播接收器的圖標,這個屬性必須用包含圖片定義的可繪制資源來設定。如果沒有設置這個屬性,會是應用
<application>
元素的icon
屬性值來代替。無論是這個屬性還是<application>
元素的icon
屬性,它們設置的圖標也是所有的接收器的Intent過濾器的默認圖標。
- android:label
這個屬性給廣播接收器設定一個用戶可讀的懂的文本標簽。如果這個屬性沒有設置,那么就會使用
<application>
元素的label屬性值來代替。
無論是這個屬性還是<application>
元素的label
屬性,它們設置的標簽也是所有的接收器的Intent過濾器的默認標簽。
應該使用一個字符串資源來設置這個屬性,以便它能夠像用戶界面中的其他字符串一樣能夠被本地化。但是,為了應用開發的便利,也能夠使用原生的字符串來設置。
- android:name
這個屬性值要用廣播接收器的實現類的類名來設置,它是
BroadcastReceiver
類的一個子類。通常要使用類的全名來設置(如:com.example.project.ReportReceiver)。但是,也可以使用簡寫(如:.ReportReceiver)。系統會自動的把<manifest>
元素中的package屬性所設定的包名添加到這個簡寫的名稱上。
一旦發布了應用程序,就不應該在改變這個名字了(除非android:exported=”false”)。
這個屬性沒有默認值,這個名字必須被指定。
- android:permission
這個屬性用于定義把消息發送給該廣播接收器的廣播器所必須要有的權限。如果沒有設置這個屬性,那么
<application>
元素的permission
屬性所設置的權限就適用于這個廣播接收器。如果<application>
元素也沒有設置權限,那么該接收器就不受權限的保護。
- android:process
這個屬性用于設置該廣播接收器應該運行在那個進程中的進程名。通常,應用程序的所有組件都在給應用程序創建的默認進程中運行,它又與應用程序包名相同的名稱。
<application>
元素的process
屬性能夠給它的所有組件設置一個不同的默認進程,但是它的每個組件自己的process
屬性能夠覆蓋這個默認設置,這樣就允許把一個應用程序分離到多個進程中。
如果這個屬性值用“:”開頭,則在需要的時候系統會創建一個新的,應用程序私有的進程,并且該廣播接收器也會運行在這個進程中。如果這個屬性值用小寫字母開頭,那么接收器就會運行在以這個屬性值命名的全局進程中,它提供使其工作的權限。這樣就允許不同的應用程序組件來共享這個進程。
- android:priority
用于有序廣播
OrderedBroadcast
的接收者們將按照事先命的優先級依次接收,數越大優先級越高(取值范圍:-1000~10000)
BroadcastReceiver-廣播系列
《BroadcastReceiver-廣播(一)實現原理及注冊》
《BroadcastReceiver-廣播(二)靜態注冊屬性說明》
《BroadcastReceiver-廣播(三)發送及自定義廣播權限》
《BroadcastReceiver-廣播(四)五種類型》