アプリが Android 15 以降をターゲットとしている場合、アプリがバックグラウンドにあるときに特定のフォアグラウンド
サービスを実行できる時間に制限が設けられます。現在、この制限は
dataSync と
mediaProcessing フォアグラウンド サービス タイプの フォアグラウンド
サービスにのみ適用されます。shortService フォアグラウンド
サービス タイプには、より厳しい制限が適用されます。詳細については、そのサービス タイプ's
ドキュメントをご覧ください。
タイムアウトの動作
システムは、dataSync と mediaProcessing フォアグラウンド サービスを 24 時間以内に合計 6 時間実行することを許可します。その後、システムは実行中のサービスの Service.onTimeout(int, int) メソッド（Android 15 で導入）を呼び出します。（mediaProcessing フォアグラウンド サービス タイプは Android 15
で追加されました）。 6 時間の制限時間は、dataSync サービスと mediaProcessing
サービスで個別に追跡されます。たとえば、dataSync サービスが 1 時間実行された場合、アプリは dataSync フォアグラウンド
サービスに 5 時間しか使用できませんが、mediaProcessing サービスには 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]"
この動作変更による問題を回避するには、次のいずれかを行います。
- サービスに新しい
Service.onTimeout(int, int)メソッドを実装します。 アプリがコールバックを受信したら、数秒以内にstopSelf()を呼び出してください。（アプリをすぐに停止しないと、システムでエラーが発生します）。 - アプリの
dataSyncサービスとmediaProcessingサービスが、24 時間以内に合計 6 時間を超えて実行されないようにします（ユーザーがアプリを操作してタイマーをリセットした場合を除く）。 - 直接的なユーザー インタラクションの結果としてのみ、
dataSyncまたはmediaProcessingフォアグラウンド サービスを開始します。サービスが開始されるときにアプリがフォアグラウンドにあるため、アプリがバックグラウンドに移行した後も 6 時間すべて使用できます。 - これらのフォアグラウンド サービスを使用する代わりに、WorkManager などの代替
APIを使用します。特に、
dataSyncフォアグラウンド サービスを使用する代わりに、 代替 API の使用を検討してください。
アプリの dataSync フォアグラウンド サービスが過去
24 時間に 6 時間実行された場合、ユーザーがアプリをフォアグラウンドにしない限り（タイマーがリセットされます）、別の dataSync フォアグラウンド サービスを開始することはできません。別の dataSync フォアグラウンド サービスを開始しようとすると、システムは「Time limit already exhausted for foreground service type dataSync」のようなエラー メッセージとともに ForegroundServiceStartNotAllowedException をスローします。
テスト
アプリの動作をテストするには、アプリが 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