在開發過程中,常需檢查特定 Service(如播放音樂、定位上傳)是否仍在後台運行,避免重複啟動或進行狀態同步。本文封裝一個靜態工具方法 ServiceStateUtils.isServiceRunning(Context, String),傳入上下文與 Service 完整類名,回傳布林值,方便全專案複用。
Context.getSystemService(Context.ACTIVITY_SERVICE) 取得 ActivityManager 實例(注意:參數必須使用大寫常數 Context.ACTIVITY_SERVICE,小寫會導致回傳 null,且不報錯,極易誤判)。am.getRunningServices(100) 取得前 100 個正在運行的服務資訊列表(List<RunningServiceInfo>)。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(全大寫),切勿寫成 "activity_service" 或 Context.activity_service,否則 getSystemService 回傳 null,導致空指標或誤判。getRunningServices 不需特別權限,但 Android 5.0+ 僅回傳呼叫者自身進程的服務,若需檢查其他 App 的 Service,需持有 GET_TASKS 或 PACKAGE_USAGE_STATS 權限(受限)。serviceName 必須為完整包名+類名,建議使用 MyService.class.getName() 避免手打錯誤。