AndroidManifest.xml文件詳解(receiver)

語法(SYNTAX):

<receiverandroid: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>

被包含於(CONTAINED IN):

<application>

能夠包含的元素(CAN CONTAIN):

<intent-filter>

<meta-data>

說明(DESCRIPTION):

這個元素用於聲明一個廣播接收器(一個BroadcastReceiver 子類),作為應用程序的組件之一。廣播接收器能夠讓應用程序接收那些由系統或其他應用程序發出的廣播Intent對象,即使是在該應用程序的其他組件沒有運行的時候,也能夠接收來自系統或其他應用程序的廣播消息。

有兩種方式讓系統知道本應用程序用戶一個廣播接收器:

1. 在應用程序的清單文件中,使用本元素來聲明註冊一個廣播接收器;

2. 在代碼中動態的創建一個廣播接收器,並使用Context.registerReceiver()方法來註冊它。有關更多動態創建接收器的方法,請看BoradcastReceiver類說明。

 

屬性(ATTRIBUTES):

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屬性能夠覆蓋這個默認設置,這樣就允許把一個應用程序分離到多個進程中。

如果這個屬性值用“:”開頭,則在需要的時候系統會創建一個新的,應用程序私有的進程,並且該廣播接收器也會運行在這個進程中。如果這個屬性值用小寫字母開頭,那麼接收器就會運行在以這個屬性值命名的全局進程中,它提供使其工作的權限。這樣就允許不同的應用程序組件來共享這個進程。

被引入版本(INTRODUCED IN):

API Level 1

 

摘自 FireOfStar的專欄

發佈留言