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