Android開發 API指南

英文原文：

採集（更新）日期：2014-7-2

語法：

< receiver 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 >

包含於：

可包含：

< intent-filter >

< meta-data >

說明：

宣告乙個廣播接收器（broadcastreceiver的子類），並成為應用程式的乙個元件。廣播接收器使得應用程式能接收由系統或其他應用程式廣播的 intent，即使本應用程式的其他元件都沒有執行也沒關係。

向系統宣告廣播接收器的方式有兩種：一種是在 manifest 檔案中以本元素宣告，另一種是用**動態建立接收器並用context.registerreceiver()方法註冊。關於動態建立廣播接收器的更多資訊，請參閱broadcastreceiver類的說明。

屬性：

android:enabled

廣播接收器是否能被系統例項化 — 「true」可以，「false」不可以。預設值是「true」。

元素擁有自己的enabled和< receiver >的本屬性都必須設定為「true」。只要其中任何乙個為「false」，則廣播接收器就將被禁用，它將不能被例項化。

android:exported

廣播接收器能否接收來自應用程式之外的訊息 — 「true」可接收，「false」不接收。如果設為「false」，則本接收器只能接收本應用程式或使用者 id 相同程式的元件所發出的訊息。

預設值依賴於廣播接收器是否包含 intent 過濾器。如果不含任何過濾器，則意味著只能通過指定精確類名的 intent 物件來觸發。這表示該接收器僅**用程式內部使用（因為其他程式通常不知道精確的類名稱）。這時預設值是「false」。另一方面，如果存在乙個以上的過濾器，則表示廣播接收器願意接收來自系統或其他應用程式的 intent，因此預設值是「true」。

本屬性並不是限制廣播接收器對外公開程度的唯一途徑。還可以利用許可權來對可傳送訊息的外部物件進行限制（請參閱permission屬性）。

android:icon

元素的icon屬性）。

元素中設定的 — 同時也是接收器中所有 intent 過濾器的預設圖示（參閱< intent-filter >元素的icon屬性）。

android:label

元素的label屬性）。

本文本標籤應該設為對字串資源的引用，這樣就能像使用者介面中的其他字串一樣對其進行本地化。不過為了應用程式開發時的便利，也可以直接設定為字串。

android:name

實現廣播接收器的類的名稱，即broadcastreceiver的子類。這應該是乙個完全限定格式的類名（比如「com.example.project.reportreceiver」）。不過作為簡稱，如果首字元為句點（比如「. reportreceiver」，則會自動在前面加上< manifest >元素指定的包名稱。

應用程式一經發布，就不應更改本名稱（除非設定了android:exported="false"）。

沒有預設值。本名稱必須指定。

android:permission

元素的permission屬性所設定的許可權將應用於廣播接收器。如果以上兩個屬性都未設定，則本接收器將不受許可權機制的保護。

關於許可權的詳細資訊，請參閱 manifest 介紹一文的 permissions 部分和另一篇文件安全和許可權。

android:process

元素的process屬性可以為每個元件設定不同的預設程序。但每個元件也可以用各自的process屬性覆蓋該預設值，使得程式可以跨越多個程序執行。

如果本屬性值的名稱以冒號（':'）開頭，則必要時會新建乙個屬於該程式私有的程序，廣播接收器將執行於該新程序中。如果程序名稱以小寫字母開頭，則廣播接收器將執行於乙個以此名字命名的全域性程序中，並賦予相應的訪問許可權。這就允許不同應用程式的多個元件共享同乙個程序，以減少資源的占用。

Android開發 API指南

Android開發 API指南

Android開發 API指南

OpenTSDB 開發指南之 Api運算元據

相關推薦