Android開發 API指南

2021-07-11 07:51:25 字數 2996 閱讀 2852

英文原文:

採集(更新)日期:2014-7-2

語法:

< service android:enabled=["true" | "false"] 

android:exported=["true" | "false"] 

android:icon="drawable resource" 

android:isolatedprocess=["true" | "false"] 

android:label="string resource" 

android:name="string" 

android:permission="string" 

android:process="string"  >  

. . . 

< /service > 

包含於:

可包含:

< intent-filter >

< meta-data >

說明:

宣告乙個服務( 

的子類),並成為應用程式的乙個元件。 與 activity 不同,服務缺少視覺化的使用者介面。 服務用於實現需要長時間執行的後台操作,或是可被其他應用程式呼叫的通訊頻繁的api。

所有的服務都必須在 manifest 檔案中用< service >元素宣告。 任何未宣告的服務都會被系統忽略,也肯定不會被執行。

屬性:

android:enabled

服務是否能被系統例項化 —「true」可以,「false」不允許。 預設值是「true」。

元素擁有自己的enabled< service >的此屬性都必須設定為「true」(均為預設值即可)。 如果其中任何乙個為「false」,則服務將被禁用,它就不能被例項化。

android:exported

其它應用程式的元件能否呼叫服務或與服務互動 — 「true」可以,「false」不可以。 如果設為「false」,則只有本應用程式或使用者 id 相同程式的元件才能啟動或繫結該服務。

預設值取決於服務是否包含 intent 過濾器。 如果不含任何過濾器,則意味著只能通過指定精確類名的 intent 物件來呼叫。 這表示該服務僅**用程式內部使用(因為其他應用程式通常不知道確切的類名稱)。這時的預設值是「false」。 另一方面,如果存在乙個以上的過濾器,則表示服務願意被外部使用,因此預設值是「true」。

本屬性並不是限**務對其他應用程式的公開程度的唯一途徑。 還可以利用許可權機制對可與服務進行互動的外部物件進行限制(請參閱permission屬性)。

android:icon

icon 屬性)。

< intent-filter > 元素的icon屬性)。

android:isolatedprocess

如果設為 true ,則本服務將會執行於乙個特殊的程序中。 該程序與系統其他部分隔離,且沒有自己的許可權。 與其通訊的唯一手段就是通過 service api (繫結和啟動)。

android:label

元素的label屬性)。

元素中設定的 — 同時也是本服務中所有 intent 過濾器的預設文字標籤(參閱< intent-filter >元素的label屬性)。

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

android:name

子類的名稱。 這應該是乙個完全限定格式的類名(比如「com.example.project.roomservice」)。 不過作為簡稱,如果首字元為句點(比如「.roomservice」),則會在前面自動加上< manifest >元素定義的包名稱。

應用程式一經發布,就 不應再更改名稱 (除非設定了android:exported="false")。

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

android:permission

要啟動或繫結服務的物件所必須擁有的許可權名稱。 如果startservice()bindservice()stopservice()的呼叫者未獲得本屬性設定的許可權,這些方法將會失效,intent 物件也不會分發給本服務。

元素的permission屬性所定義的許可權應用於本服務。 如果兩個地方的屬性都沒有設定,則本服務將不受許可權機制的保護。

關於許可權的詳細資訊,請參閱 manifest 介紹一文中的 許可權 一節及另一篇文件 安全和許可權。

android:process

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

如果本屬性設定的名稱以冒號(':')開頭,則必要時會新建乙個屬於該程式私有的程序,服務將在該新程序中執行。 如果程序名稱以小寫字母開頭,則服務將執行於乙個以此名字命名的全域性程序中,並賦予應有的訪問許可權。 這就允許分屬於不同應用程式的多個元件共享同乙個程序,以減少資源的占用。

Android開發 API指南

英文原文 採集 更新 日期 2014 7 2 語法 receiver android enabled true false android exported true false android icon drawable resource android label string resource...

Android開發 API指南

英文原文 採集 更新 日期 2014 5 29 語法 permission group android description string resource android icon drawable resource android label string resource android n...

OpenTSDB 開發指南之 Api運算元據

引數 說明example summary 返回主要摘要 api put?summary details 返回詳細資訊 api put?details sync 是否同步,即是否等待資料都寫入成功後才返回結果 api put?sync sync timeout 返回結果之前的等待時間 api put ...