フォアグラウンド サービスのタイムアウト

Android 15 以降をターゲットとするアプリの場合、アプリがバックグラウンドで実行されているときに、特定のフォアグラウンド サービスの実行を許可する時間が制限されます。現在、この制限は dataSyncmediaProcessing フォアグラウンド サービスのタイプのフォアグラウンド サービスにのみ適用されます。shortService フォアグラウンド サービス タイプには、そのサービス タイプのドキュメントで説明されている、より厳しい制限があります。

タイムアウトの動作

システムは、dataSyncmediaProcessing のフォアグラウンド サービスを 24 時間以内に合計 6 時間実行することを許可します。その後、システムは実行中のサービスの Service.onTimeout(int, int) メソッド(Android 15 で導入)を呼び出します。(mediaProcessing フォアグラウンド サービス タイプは Android 15 で追加されました)。6 時間の制限時間は、dataSync サービスと mediaProcessing サービスで別々に追跡されます。たとえば、dataSync サービスが 1 時間だけ実行された場合、アプリでは mediaProcessing フォアグラウンド サービスは 5 時間しか使用できませんが、dataSync サービスは 6 時間分使用できます。

フォアグラウンド サービスが 6 時間の制限に達すると、数秒で Service.stopSelf() を呼び出します。システムが Service.onTimeout() を呼び出すと、サービスはフォアグラウンド サービスとみなされなくなります。サービスが Service.stopSelf() を呼び出さない場合、システムは内部例外をスローします。例外は Logcat に次のメッセージとともに記録されます。

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type [service type] did not stop within its timeout: [component name]"

この動作の変更による問題を回避するには、次のいずれかを行います。

  1. サービスに新しい Service.onTimeout(int, int) メソッドを実装します。アプリがコールバックを受信したら、数秒以内に stopSelf() を呼び出します。(アプリをすぐに停止しないと、システムは障害を生成します)。
  2. アプリの dataSync サービスと mediaProcessing サービスが 24 時間以内に合計 6 時間を超えて実行されないようにしてください(ユーザーがアプリを操作してタイマーをリセットした場合を除きます)。
  3. dataSync または mediaProcessing フォアグラウンド サービスは、ユーザーの直接操作の結果としてのみ開始します。サービスが開始されるときにアプリはフォアグラウンドにあるため、アプリがバックグラウンドに移動した後も、サービスは 6 時間間存続します。
  4. これらのフォアグラウンド サービスを使用する代わりに、WorkManager などの代替 API を使用してください。特に、dataSync フォアグラウンド サービスを使用する代わりに、代替 API の使用を検討してください。

アプリの dataSync フォアグラウンド サービスが過去 24 時間以内に 6 時間実行されている場合、ユーザーがアプリをフォアグラウンドに表示した(これによりタイマーがリセットされる)場合を除き、別の dataSync フォアグラウンド サービスを開始することはできません。別の dataSync フォアグラウンド サービスを開始しようとすると、システムは ForegroundServiceStartNotAllowedException をスローし、「フォアグラウンド サービス タイプ dataSync の制限時間はすでに経過しています」などのエラー メッセージを出力します。

テスト

アプリの動作をテストするには、アプリが Android 15 をターゲットとしていない場合でも、データ同期のタイムアウトを有効にできます(アプリが Android 15 デバイスで実行されている場合)。タイムアウトを有効にするには、次の adb コマンドを実行します。

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

また、タイムアウト時間を調整して、上限に達したときのアプリの動作を簡単にテストすることもできます。dataSync フォアグラウンド サービスの新しいタイムアウト期間を設定するには、次の adb コマンドを実行します。

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

mediaProcessing フォアグラウンド サービスの新しいタイムアウト期間を設定するには、次のコマンドを実行します。

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds