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

アプリが 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