服務總覽

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 fun onCreate() {
        // The service is being created
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // The service is starting, due to a call to startService()
        return startMode
    }

    override fun onBind(intent: Intent): IBinder? {
        // A client is binding to the service with bindService()
        return binder
    }

    override fun onUnbind(intent: Intent): Boolean {
        // All clients have unbound with unbindService()
        return allowRebind
    }

    override fun onRebind(intent: Intent) {
        // A client is binding to the service with bindService(),
        // after onUnbind() has already been called
    }

    override fun onDestroy() {
        // The service is no longer used and is being destroyed
    }
}

注意:與活動生命週期回呼方法不同,您不需要呼叫這些回呼方法的父類別實作。

圖 2. 服務生命週期。左圖顯示使用 startService() 建立服務時的生命週期,右圖則顯示使用 bindService() 建立服務時的生命週期。

圖 2 說明服務的一般回呼方法。雖然圖中將 startService() 建立的服務與 bindService() 建立的服務分開,但請注意,無論服務如何啟動,任何服務都可能允許用戶端繫結。如果服務一開始是透過 onStartCommand() 啟動 (由用戶端呼叫 startService()),仍可接收 onBind() 呼叫 (當用戶端呼叫 bindService() 時)。

實作這些方法後,您就可以監控服務生命週期的這兩個巢狀迴圈:

注意:雖然呼叫 stopSelf() 或 stopService() 會停止已啟動的 Service,但 Service 沒有對應的回呼 (沒有 onStop() 回呼)。除非服務繫結至用戶端,否則系統會在服務停止時刪除服務,且只會收到 onDestroy() 回呼。

如要進一步瞭解如何建立提供繫結的服務,請參閱「繫結服務」文件,其中「管理繫結服務的生命週期」一節包含 onRebind() 回呼方法的詳細資訊。