Service 是一種應用程式元件,可在背景執行長時間執行的作業。不提供使用者介面。啟動後,即使使用者切換到其他應用程式,Service 仍可能繼續執行一段時間。此外,元件可以繫結至服務,與服務互動,甚至執行處理序間通訊 (IPC)。舉例來說,服務可以在背景處理網路交易、播放音樂、執行檔案 I/O,或與內容供應器互動。
注意:服務會在託管程序的主執行緒中執行,除非另有指定,否則服務「不會」建立自己的執行緒,也「不會」在獨立程序中執行。您應在服務中的獨立執行緒上執行任何封鎖作業,以免發生應用程式無回應 (ANR) 錯誤。
服務類型
以下是三種不同的服務類型:
- 前景
-
前景服務會執行使用者可察覺的作業。舉例來說,音訊應用程式會使用前景服務播放音軌。前景服務必須顯示通知。即使使用者未與應用程式互動,前景服務仍會繼續執行。
使用前景服務時,您必須顯示通知,讓使用者主動瞭解服務正在執行。除非服務停止或從前景移除,否則無法關閉這則通知。
進一步瞭解如何在應用程式中設定前景服務。
注意:WorkManager API 提供彈性的工作排程方式,並可視需要以前景服務的形式執行這些工作。在許多情況下,使用 WorkManager 會比直接使用前景服務更合適。
- 背景
- 背景服務執行的作業不會直接引起
使用者注意。舉例來說,如果應用程式使用服務壓縮儲存空間,通常會是背景服務。
注意:如果應用程式指定目標 API 級別 26 以上版本,當應用程式本身不在前景時,系統會限制執行背景服務。舉例來說,在大多數情況下,您不應在背景存取位置資訊。請改為使用 WorkManager 安排工作。
- 已繫結
- 當應用程式元件呼叫
bindService()繫結至服務時,服務就會「繫結」。繫結服務提供用戶端-伺服器介面,可讓元件與服務互動、傳送要求、接收結果,甚至透過處理序間通訊 (IPC) 跨處理序執行。繫結服務只有在另一個應用程式元件繫結至該服務時才會執行。多個元件可以同時繫結至服務,但當所有元件都解除繫結時,服務就會遭到刪除。
雖然本文件通常會分別討論啟動服務和繫結服務,但您的服務可以同時以這兩種方式運作,也就是可以啟動 (無限期執行),也可以允許繫結。這只是您是否實作幾個回呼方法的問題:onStartCommand() 允許元件啟動,onBind() 允許繫結。
無論服務是啟動、繫結或兩者兼具,任何應用程式元件都能使用服務 (即使來自其他應用程式),就像任何元件都能使用 Intent 啟動活動一樣。不過,您可以在資訊清單檔案中將服務宣告為「私人」,並封鎖其他應用程式的存取權。詳情請參閱「在資訊清單中宣告服務」一節。
選擇服務或執行緒
服務只是可在背景執行的元件,即使使用者未與應用程式互動,服務仍可執行,因此只有在需要時才應建立服務。
如果您必須在主執行緒以外執行工作,但僅限使用者與應用程式互動時,則應在其他應用程式元件的背景中建立新執行緒。舉例來說,如果您想在活動執行時播放音樂,可以在 onCreate() 中建立執行緒,在 onStart() 中開始執行,並在 onStop() 中停止。此外,建議您使用 java.util.concurrent 套件或 Kotlin 協同程式中的執行緒集區和執行程式,而非傳統的 Thread 類別。如要進一步瞭解如何將執行作業移至背景執行緒,請參閱「Android 的執行緒作業」文件。
請注意,如果您使用服務,根據預設,服務仍會在應用程式的主執行緒中執行,因此如果服務執行密集或封鎖作業,您仍應在服務中建立新執行緒。
基本概念
如要建立服務,您必須建立 Service 的子類別,或使用其現有的子類別。在實作中,您必須覆寫一些回呼方法,以處理服務生命週期的重要部分,並提供機制,讓元件繫結至服務 (如適用)。以下是您應覆寫的最重要回呼方法:
onStartCommand()- 當其他元件 (例如活動) 要求啟動服務時,系統會呼叫
startService()來叫用這個方法。執行這個方法時,服務會啟動,並可在背景無限期執行。如果實作這項功能,您有責任在工作完成時呼叫stopSelf()或stopService()來停止服務。如果只想提供繫結,則不需要實作這個方法。 onBind()- 當其他元件想要與服務繫結 (例如執行 RPC) 時,系統會呼叫
bindService()來叫用這個方法。實作這個方法時,您必須提供介面,讓用戶端透過傳回IBinder與服務通訊。您必須一律實作這個方法;不過,如果您不想允許繫結,則應傳回空值。 onCreate()- 系統會在服務初次建立時 (呼叫
onStartCommand()或onBind()之前) 叫用這個方法,執行一次性設定程序。如果服務已在執行,系統就不會呼叫這個方法。 onDestroy()- 當服務不再使用且即將刪除時,系統會叫用這個方法。服務應實作這個方法,清除執行緒、已註冊的事件監聽器或接收器等任何資源。這是服務收到的最後一個呼叫。
如果元件透過呼叫 startService() 啟動服務 (這會導致呼叫 onStartCommand()),服務會繼續執行,直到使用 stopSelf() 自行停止,或由其他元件呼叫 stopService() 停止。
如果元件呼叫 bindService() 建立服務,但「未」呼叫 onStartCommand(),則服務只會在元件繫結至服務時執行。服務與所有用戶端解除繫結後,系統就會刪除服務。
只有在記憶體不足,且必須為使用者關注的活動復原系統資源時,Android 系統才會停止服務。如果服務繫結至使用者聚焦的活動,則較不可能遭到終止;如果服務宣告為在前景執行,則極少遭到終止。如果服務已啟動且長時間執行,系統會隨著時間降低其在背景工作清單中的位置,且服務會變得極易終止。如果服務已啟動,您必須將其設計為能妥善處理系統重新啟動。如果系統終止服務,會在資源可用時立即重新啟動,但這也取決於您從 onStartCommand() 傳回的值。如要進一步瞭解系統何時會刪除服務,請參閱「程序和執行緒」文件。
在以下各節中,您將瞭解如何建立 startService() 和 bindService() 服務方法,以及如何從其他應用程式元件使用這些方法。
在資訊清單中宣告服務
您必須在應用程式的資訊清單檔案中宣告所有服務,就像宣告活動和其他元件一樣。
如要宣告服務,請將 <service> 元素新增為 <application> 元素的子項。範例如下:
<manifest ... > ... <application ... > <service android:name=".ExampleService" /> ... </application> </manifest>
如要進一步瞭解如何在資訊清單中宣告服務,請參閱 <service> 元素參考資料。
您可以在 <service> 元素中加入其他屬性,定義啟動服務所需的權限,以及服務應執行的程序等屬性。android:name 是唯一必要的屬性,用於指定服務的類別名稱。發布應用程式後,請勿變更這個名稱,以免因依賴明確意圖啟動或繫結服務而導致程式碼中斷 (請參閱網誌文章「無法變更的事項」)。
注意:為確保應用程式安全,啟動 Service 時請一律使用明確意圖,且不要為服務宣告意圖篩選器。使用隱含意圖啟動服務會危害安全性,因為您無法確定哪個服務會回應意圖,而使用者也無法查看哪個服務會啟動。自 Android 5.0 (API 級別 21) 起,如果您使用隱含意圖呼叫 bindService(),系統會擲回例外狀況。
您可以加入 android:exported 屬性並設為 false,確保只有您的應用程式可以使用服務。這樣一來,即使其他應用程式使用明確意圖,也無法啟動您的服務。
注意:使用者可以查看裝置上正在執行的服務。如果看到不認識或不信任的服務,可以停止該服務。為避免使用者不小心停止服務,您必須在應用程式資訊清單的 <service> 元素中加入 android:description 屬性。在說明中,請簡短說明服務的功能和優點。
建立已啟動的服務
啟動的 Service 是指由其他元件呼叫 startService() 啟動的 Service,這會導致呼叫 Service 的 onStartCommand() 方法。
服務啟動後,其生命週期與啟動服務的元件無關。即使啟動服務的元件已刪除,服務仍可在背景無限期執行。因此,服務應在工作完成時呼叫 stopSelf() 自行停止,或由其他元件呼叫 stopService() 停止服務。
活動等應用程式元件可以呼叫 startService() 並傳遞 Intent,藉此啟動服務。
會指定服務,並包含服務要使用的任何資料。服務會在 onStartCommand() 方法中收到這個 Intent。
舉例來說,假設某個活動需要將部分資料儲存至線上資料庫。活動可以啟動隨附服務,並將意圖傳遞至 startService(),將資料傳送至該服務進行儲存。服務會在 onStartCommand() 中接收意圖、連線至網際網路,並執行資料庫交易。交易完成後,服務會自行停止並刪除。
注意:根據預設,Service 會在宣告該 Service 的應用程式程序中執行,並在該應用程式的主執行緒中執行。如果服務在使用者與同一應用程式的活動互動時,執行密集或封鎖作業,服務會降低活動效能。為避免影響應用程式效能,請在服務中啟動新執行緒。
Service 類別是所有服務的基礎類別。擴充這個類別時,請務必建立新的執行緒,讓服務完成所有工作。服務預設會使用應用程式的主執行緒,這可能會降低應用程式執行的任何活動效能。
Android 架構也提供 Service 的 IntentService 子類別,可使用背景工作執行緒一次處理一個啟動要求。不建議在新應用程式中使用這個類別,因為自 Android 8 Oreo 起,系統會導入背景執行限制,導致這個類別無法正常運作。此外,自 Android 11 起,這項功能已淘汰。您可以使用 JobIntentService 取代 IntentService,與新版 Android 相容。
以下各節說明如何實作自訂服務,但強烈建議您在大多數用途中改用 WorkManager。請參閱 Android 背景程序處理指南,瞭解是否有符合您需求的解決方案。
擴充 Service 類別
您可以擴充 Service 類別,處理每個傳入的意圖。基本導入範例如下:
class HelloService : Service() { private var serviceLooper: Looper? = null private var serviceHandler: ServiceHandler? = null // Handler that receives messages from the thread. private inner class ServiceHandler(looper: Looper) : Handler(looper) { override fun handleMessage(msg: Message) { // Normally we would do some work here, like download a file. // For our sample, we just sleep for 5 seconds. try { Thread.sleep(5000) } catch (e: InterruptedException) { // Restore interrupt status. Thread.currentThread().interrupt() } // Stop the service using the startId, so that we don't stop // the service in the middle of handling another job. stopSelf(msg.arg1) } } override fun onCreate() { // Start up the thread running the service. Note that we create a // separate thread because the service normally runs in the process's // main thread, which we don't want to block. We also make it // background priority so CPU-intensive work will not disrupt our UI. HandlerThread("ServiceStartArguments", Process.THREAD_PRIORITY_BACKGROUND).apply { start() // Get the HandlerThread's Looper and use it for our Handler. serviceLooper = looper serviceHandler = ServiceHandler(looper) } } override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int { Toast.makeText(this, "service starting", Toast.LENGTH_SHORT).show() // For each start request, send a message to start a job and deliver the // start ID so we know which request we're stopping when we finish the job. serviceHandler?.obtainMessage()?.also { msg -> msg.arg1 = startId serviceHandler?.sendMessage(msg) } // If we get killed, after returning from here, restart. return START_STICKY } override fun onBind(intent: Intent): IBinder? { // We don't provide binding, so return null. return null } override fun onDestroy() { Toast.makeText(this, "service done", Toast.LENGTH_SHORT).show() } }
範例程式碼會處理 onStartCommand() 中的所有來電,並將工作發布至在背景執行緒上執行的 Handler。其運作方式與 IntentService 相同,會依序處理所有要求。舉例來說,如果您想同時執行多項要求,可以變更程式碼,在執行緒集區中執行工作。
請注意,onStartCommand() 方法必須傳回整數。這個整數值描述系統在終止服務時,應如何繼續服務。onStartCommand() 的傳回值必須是下列其中一個常數:
START_NOT_STICKY- 如果系統在
onStartCommand()傳回後終止服務,除非有待處理的意圖要傳送,否則「不要」重新建立服務。如果應用程式可以重新啟動任何未完成的工作,這是避免在不必要時執行服務的最安全選項。 START_STICKY- 如果系統在
onStartCommand()傳回後終止服務,請重新建立服務並呼叫onStartCommand(),但「不要」重新傳送最後一個意圖。除非有待處理的意圖要啟動服務,否則系統會呼叫onStartCommand(),並傳遞空值意圖。在這種情況下,系統會傳送這些意圖。這適用於媒體播放器 (或類似服務),這類服務不會執行指令,但會無限期執行並等待工作。 START_REDELIVER_INTENT- 如果系統在
onStartCommand()傳回後終止服務,請重新建立服務,並使用最後傳送至服務的意圖呼叫onStartCommand()。任何待處理意圖都會依序傳送。這適用於正在執行應立即恢復的工作 (例如下載檔案) 的服務。
如要進一步瞭解這些傳回值,請參閱每個常數的連結參考文件。
啟動服務
您可以將 Intent 傳遞至 startService() 或 startForegroundService(),從活動或其他應用程式元件啟動服務。Android 系統會呼叫服務的 onStartCommand() 方法,並傳遞 Intent,指定要啟動的服務。
注意:如果應用程式指定目標 API 級別 26 以上版本,除非應用程式本身位於前景,否則系統會限制使用或建立背景服務。如果應用程式需要建立前景服務,應呼叫 startForegroundService()。這個方法會建立背景服務,但會向系統發出信號,表示服務會自行升級至前景。服務建立後,必須在五秒內呼叫 startForeground() 方法。
舉例來說,活動可以使用 startService() 的明確意圖,啟動上一節的範例服務 (HelloService),如下所示:
startService(Intent(this, HelloService::class.java))
startService() 方法會立即傳回,Android 系統則會呼叫服務的 onStartCommand() 方法。如果服務尚未執行,系統會先呼叫 onCreate(),然後呼叫 onStartCommand()。
如果服務未提供繫結,則透過 startService() 傳送的意圖,就是應用程式元件與服務之間的唯一通訊模式。不過,如果您希望服務傳回結果,啟動服務的用戶端可以建立廣播的 PendingIntent (使用 getBroadcast()),並在啟動服務的 Intent 中將其傳送至服務。接著,服務可以使用廣播傳送結果。
如果有多個啟動服務的要求,系統會多次呼叫服務的 onStartCommand()。不過,只要提出一個停止服務的要求 (使用 stopSelf() 或 stopService()),即可停止服務。
停止服務
已啟動的服務必須自行管理生命週期。也就是說,除非必須復原系統記憶體,否則系統不會停止或刪除服務,且服務會在 onStartCommand() 傳回後繼續執行。服務必須呼叫 stopSelf() 自行停止,或由其他元件呼叫 stopService() 停止。
要求以 stopSelf() 或 stopService() 停止後,系統會盡快刪除服務。
如果服務同時處理多個 onStartCommand() 要求,請勿在處理完啟動要求後停止服務,因為您可能已收到新的啟動要求 (在第一個要求結束時停止會終止第二個要求)。為避免這個問題,您可以使用 stopSelf(int),確保停止服務的要求一律以最新的啟動要求為依據。也就是說,呼叫 stopSelf(int) 時,您會傳遞與停止要求對應的啟動要求 ID (傳送至 onStartCommand() 的 startId)。接著,如果服務在您呼叫 stopSelf(int) 前收到新的啟動要求,ID 就會不相符,服務也不會停止。
注意:為避免浪費系統資源和消耗電池電力,請確保應用程式在完成工作後停止服務。如有需要,其他元件可以呼叫 stopService() 來停止服務。即使您為服務啟用繫結,只要服務收到 onStartCommand() 呼叫,您就必須自行停止服務。
如要進一步瞭解服務的生命週期,請參閱下方的「管理服務的生命週期」一節。
建立繫結服務
繫結服務可讓應用程式元件透過呼叫 bindService() 繫結至該服務,建立長期連線。一般來說,不允許元件透過呼叫 startService() 啟動。
如要透過應用程式中的活動和其他元件與服務互動,或透過處理序間通訊 (IPC) 向其他應用程式公開應用程式的部分功能,請建立繫結服務。
如要建立繫結服務,請實作 onBind() 回呼方法,傳回定義與服務通訊介面的 IBinder。其他應用程式元件可以呼叫 bindService() 來擷取介面,並開始呼叫服務的方法。這項服務僅用於服務繫結至該服務的應用程式元件,因此當沒有元件繫結至該服務時,系統會刪除該服務。您不需要像透過 onStartCommand() 啟動服務時那樣,停止繫結服務。
如要建立繫結服務,您必須定義介面,指定用戶端與服務通訊的方式。服務與用戶端之間的介面必須是 IBinder 的實作,且服務必須從 onBind() 回呼方法傳回。用戶端收到 IBinder 後,即可開始透過該介面與服務互動。
多個用戶端可以同時繫結至服務。用戶端與服務互動完畢後,會呼叫 unbindService() 取消繫結。如果沒有用戶端繫結至服務,系統就會刪除服務。
繫結服務有多種實作方式,且實作方式比啟動服務更複雜。基於上述原因,繫結服務的討論會出現在另一份關於繫結服務的文件中。
傳送通知給使用者
服務執行時,可以使用 Snackbar 通知或狀態列通知,向使用者通知事件。
Snackbar 通知是顯示在目前視窗介面上的訊息,只會顯示一小段時間,然後就會消失。狀態列通知會在狀態列中提供圖示和訊息,使用者可以選取該圖示來採取動作 (例如啟動活動)。
一般來說,當檔案下載等背景工作完成,且使用者可以採取行動時,狀態列通知是最佳的使用技術。使用者從展開檢視畫面選取通知後,通知可以啟動活動 (例如顯示下載的檔案)。
管理服務的生命週期
Service 的生命週期比 Activity 簡單得多。不過,更重要的是,您必須密切注意服務的建立和刪除方式,因為服務可以在使用者不知情的情況下在背景執行。
服務的生命週期 (從建立到刪除) 可遵循下列兩種路徑:
- 已啟動的服務
當其他元件呼叫
startService()時,系統會建立服務。接著,服務會無限期執行,且必須呼叫stopSelf()自行停止。另一個元件也可以呼叫stopService()來停止服務。服務停止後,系統會將其刪除。 - 繫結服務
當其他元件 (用戶端) 呼叫
bindService()時,系統就會建立服務。接著,用戶端會透過IBinder介面與服務通訊。用戶端可以呼叫unbindService()來關閉連線。多個用戶端可以繫結至同一個服務,當所有用戶端都解除繫結時,系統就會刪除該服務。服務「不」需要自行停止。
這兩種路徑並非完全獨立。您可以繫結至已透過 startService() 啟動的服務。舉例來說,您可以呼叫 startService(),並使用 Intent 識別要播放的音樂,藉此啟動背景音樂服務。之後,當使用者想要控制播放器或取得目前歌曲的相關資訊時,活動可以呼叫 bindService(),繫結至服務。在這種情況下,stopService() 或 stopSelf() 實際上不會停止服務,直到所有用戶端都解除繫結為止。
實作生命週期回呼
與活動一樣,服務也有生命週期回呼方法,您可以實作這些方法,監控服務狀態的變化,並在適當的時間執行工作。以下骨架服務示範了各個生命週期方法:
class ExampleService : Service() { private var startMode: Int = 0 // indicates how to behave if the service is killed private var binder: IBinder? = null // interface for clients that bind private var allowRebind: Boolean = false // indicates whether onRebind should be used override funonCreate() { // The service is being created } override funonStartCommand(intent: Intent?, flags: Int, startId: Int): Int { // The service is starting, due to a call to startService() return startMode } override funonBind(intent: Intent): IBinder? { // A client is binding to the service with bindService() return binder } override funonUnbind(intent: Intent): Boolean { // All clients have unbound with unbindService() return allowRebind } override funonRebind(intent: Intent) { // A client is binding to the service with bindService(), // after onUnbind() has already been called } override funonDestroy() { // The service is no longer used and is being destroyed } }
注意:與活動生命週期回呼方法不同,您不需要呼叫這些回呼方法的父類別實作。
圖 2. 服務生命週期。左圖顯示使用 startService() 建立服務時的生命週期,右圖則顯示使用 bindService() 建立服務時的生命週期。
圖 2 說明服務的一般回呼方法。雖然圖中將 startService() 建立的服務與 bindService() 建立的服務分開,但請注意,無論服務如何啟動,任何服務都可能允許用戶端繫結。如果服務一開始是透過 onStartCommand() 啟動 (由用戶端呼叫 startService()),仍可接收 onBind() 呼叫 (當用戶端呼叫 bindService() 時)。
實作這些方法後,您就可以監控服務生命週期的這兩個巢狀迴圈:
- 服務的整個生命週期介於呼叫
onCreate()到onDestroy()傳回之間。與活動一樣,服務會在onCreate()中進行初始設定,並在onDestroy()中釋出所有剩餘資源。舉例來說,音樂播放服務可以在onCreate()中建立播放音樂的執行緒,然後在onDestroy()中停止執行緒。注意:無論服務是由
startService()或bindService()建立,系統都會呼叫onCreate()和onDestroy()方法。 - 服務的有效生命週期從呼叫
onStartCommand()或onBind()開始。每個方法都會收到傳遞至startService()或bindService()的Intent。如果服務已啟動,則有效生命週期會與整個生命週期同時結束 (即使
onStartCommand()傳回後,服務仍會保持有效)。如果服務已繫結,則onUnbind()傳回時,有效生命週期就會結束。
注意:雖然呼叫 stopSelf() 或 stopService() 會停止已啟動的 Service,但 Service 沒有對應的回呼 (沒有 onStop() 回呼)。除非服務繫結至用戶端,否則系統會在服務停止時刪除服務,且只會收到 onDestroy() 回呼。
如要進一步瞭解如何建立提供繫結的服務,請參閱「繫結服務」文件,其中「管理繫結服務的生命週期」一節包含 onRebind() 回呼方法的詳細資訊。