アプリが Android 15 以降をターゲットとしている場合、アプリがバックグラウンドで実行されているときに特定のフォアグラウンド サービスを実行できる時間に制限が適用されます。現在、この制限は dataSync
と mediaProcessing
フォアグラウンド サービスのタイプのフォアグラウンド サービスにのみ適用されます。shortService
フォアグラウンド サービス タイプには、そのサービス タイプのドキュメントで説明されている、より厳しい制限があります。
タイムアウトの動作
システムは、dataSync
と mediaProcessing
のフォアグラウンド サービスを 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]"
この動作の変更による問題を回避するには、次のいずれかを行います。
- サービスに新しい
Service.onTimeout(int, int)
メソッドを実装します。アプリがコールバックを受信したら、数秒以内にstopSelf()
を呼び出してください。(アプリをすぐに停止しないと、システムは障害を生成します)。 - アプリの
dataSync
サービスとmediaProcessing
サービスが、24 時間で合計 6 時間を超えて実行されていないことを確認します(ユーザーがアプリを操作してタイマーをリセットする場合を除きます)。 dataSync
またはmediaProcessing
フォアグラウンド サービスは、直接のユーザー操作の結果としてのみ起動します。サービスの開始時にアプリはフォアグラウンドにあるため、サービスはバックグラウンドに移行してから 6 時間すべてかかります。- これらのフォアグラウンド サービスを使用する代わりに、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