萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 判斷 Service 是否運行:通用工具類實作

在開發過程中,常需檢查特定 Service(如播放音樂、定位上傳)是否仍在後台運行,避免重複啟動或進行狀態同步。本文封裝一個靜態工具方法 ServiceStateUtils.isServiceRunning(Context, String),傳入上下文與 Service 完整類名,回傳布林值,方便全專案複用。

核心實作邏輯

  1. 透過 Context.getSystemService(Context.ACTIVITY_SERVICE) 取得 ActivityManager 實例(注意:參數必須使用大寫常數 Context.ACTIVITY_SERVICE,小寫會導致回傳 null,且不報錯,極易誤判)。
  2. 呼叫 am.getRunningServices(100) 取得前 100 個正在運行的服務資訊列表(List<RunningServiceInfo>)。
  3. 遍歷列表,比對 info.service.getClassName() 與目標服務類名,相符即回傳 true。

完整工具類程式碼

import java.util.List;
import android.app.ActivityManager;
import android.app.ActivityManager.RunningServiceInfo;
import android.content.Context;

public class ServiceStateUtils {

    /**
     * 檢查指定 Service 是否正在運行
     * @param context      上下文(Application 或 Activity 均可)
     * @param serviceName  Service 完整類名(如 "com.example.MyService")
     * @return true 表示正在運行,false 表示未運行
     */
    public static boolean isServiceRunning(Context context, String serviceName) {
        // 1. 取得 ActivityManager,注意參數大寫!
        ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
        if (am == null) return false;

        // 2. 獲取運行中服務列表(最大 100 筆)
        List infos = am.getRunningServices(100);
        if (infos == null || infos.isEmpty()) return false;

        // 3. 遍歷比對類名
        for (RunningServiceInfo info : infos) {
            String className = info.service.getClassName();
            if (serviceName.equals(className)) {
                return true; // 找到目標服務
            }
        }
        return false; // 遍歷完畢未找到
    }
}

使用範例

// 在 Activity 或 Fragment 中
if (ServiceStateUtils.isServiceRunning(this, "com.example.music.MusicPlaybackService")) {
    // Service 正在運行,可直接發送控制指令或更新 UI
} else {
    // Service 未啟動,視需求決定是否 startService()
}

避坑指南

  • Context.ACTIVITY_SERVICE 大小寫: 必須使用 Context.ACTIVITY_SERVICE(全大寫),切勿寫成 "activity_service" 或 Context.activity_service,否則 getSystemService 回傳 null,導致空指標或誤判。
  • 權限無需額外宣告: getRunningServices 不需特別權限,但 Android 5.0+ 僅回傳呼叫者自身進程的服務,若需檢查其他 App 的 Service,需持有 GET_TASKS 或 PACKAGE_USAGE_STATS 權限(受限)。
  • 服務類名完整性: 傳入的 serviceName 必須為完整包名+類名,建議使用 MyService.class.getName() 避免手打錯誤。

適用場景

  • 音樂播放器:播放頁檢查播放服務是否存活,決定顯示「播放中」狀態。
  • 即時通訊:檢查推送/心跳服務是否運行,未運行則重啟。
  • 定位追蹤:確認 GPS 上傳服務存活,避免重複啟動造成電量浪費。
copyright © 萬盛學電腦網 all rights reserved