フォアグラウンド サービスの変更

フォアグラウンド サービスのドキュメントでは、Android フォアグラウンド サービスの現在の動作について説明しています。このドキュメントでは、最新バージョンの Android をターゲットとしているかどうかにかかわらず、ほとんどのアプリのベスト プラクティスについて説明します。

このページでは、フォアグラウンド サービスの最近の重要な変更と、最新バージョンの Android プラットフォームをターゲットとしていないアプリへの影響について説明します。多くの場合、低い API レベルをターゲットとするアプリでは任意だったベスト プラクティスが、高い API レベルをターゲットとするアプリでは必須になります。

Android 15(API レベル 35)

API レベル 35 以降をターゲットとするアプリには、次の要件が適用されます。

Android 14(API レベル 34)

API レベル 34 以降をターゲットとするアプリには、次の要件が適用されます。

  • サービスタイプとともにすべてのフォアグラウンド サービスを申告する必要があります。
  • アプリは、フォアグラウンド サービスが行う処理の種類に適した権限タイプをリクエストする必要があります。各フォアグラウンド サービスのタイプには、対応する権限タイプがあります。たとえば、アプリがカメラを使用するフォアグラウンド サービスを起動する場合は、FOREGROUND_SERVICE 権限と FOREGROUND_SERVICE_CAMERA 権限の両方をリクエストする必要があります。API レベル 34 以降をターゲットとするアプリで、適切な特定の権限をリクエストしていない場合、システムは SecurityException をスローします。

Android 12(API レベル 31)

API レベル 31 以降を対象とするアプリには、次の要件が適用されます。

Android 11(API レベル 30)

API レベル 30 以降をターゲットとするアプリには、次の要件が適用されます。

  • アプリのフォアグラウンド サービスがカメラまたはマイクを利用する場合は、それぞれ camera サービスタイプまたは microphone サービスタイプでサービスを宣言する必要があります。

Android 10(API レベル 29)

API レベル 29 以降をターゲットとするアプリには、次の要件が適用されます。

  • アプリのフォアグラウンド サービスが位置情報を使用する場合、アプリは location サービス タイプでサービスを宣言する必要があります。

Android 9(API レベル 28)

Android 9 では、FOREGROUND_SERVICE 権限が導入されました。Android 9 で実行され、フォアグラウンド サービスを使用しているアプリには、その権限が必要です。

API レベル 28 以降をターゲットとするアプリが、FOREGROUND_SERVICE 権限をリクエストせずにフォアグラウンド サービスを作成しようとすると、システムは SecurityException をスローします。