Ön plan hizmeti zaman aşımları

Android 15 veya sonraki sürümleri hedefleyen uygulamalarda sistem, uygulamanız arka plandayken belirli ön plan hizmetlerinin ne kadar süre boyunca çalışabileceğine dair kısıtlamalar uygular. Şu anda bu kısıtlama yalnızca dataSync ve mediaProcessing ön plan hizmet türü ön plan hizmetleri için geçerlidir. shortService ön plan hizmet türü için daha kısıtlayıcı sınırlar vardır. Bu hizmet türünün dokümanlarında bu sınırlar hakkında bilgi verilmektedir.

Zaman aşımı davranışı

Sistem, dataSync ve mediaProcessing ön plan hizmetlerinin 24 saat içinde toplam 6 saat boyunca çalışmasına izin verir. Ardından sistem, çalışan hizmetin Service.onTimeout(int, int) yöntemini çağırır (Android 15'te kullanıma sunulmuştur). (mediaProcessing ön plan hizmeti türü Android 15'te eklenmiştir.) Altı saatlik zaman sınırı, dataSync ve mediaProcessing hizmetleri için ayrı ayrı izlenir. Örneğin, bir dataSync hizmeti yalnızca bir saat çalıştıysa uygulamanın dataSync ön plan hizmetleri için yalnızca beş saati olur ancak mediaProcessing hizmetleri için tam altı saati olur.

Bir ön plan hizmeti altı saatlik sınıra ulaştığında, hizmetin Service.stopSelf() işlevini çağırmak için birkaç saniyelik süresi vardır. Sistem Service.onTimeout() çağrısı yaptığında hizmet artık ön plan hizmeti olarak kabul edilmez. Hizmet Service.stopSelf()'ü çağırmazsa sistem dahili bir istisna atar. İstisna, aşağıdaki mesajla Logcat'e kaydedilir:

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

Bu davranış değişikliğiyle ilgili sorunları önlemek için aşağıdakilerden en az birini yapabilirsiniz:

  1. Hizmetinizin yeni Service.onTimeout(int, int) yöntemini uygulamasını sağlayın. Uygulamanız geri aramayı aldığında birkaç saniye içinde stopSelf()'ü aradığınızdan emin olun. (Uygulamayı hemen durdurmazsanız sistem bir hata oluşturur.)
  2. Uygulamanızın dataSync ve mediaProcessing hizmetlerinin 24 saatlik bir dönemde toplam 6 saatten fazla çalışmadığından emin olun (kullanıcı uygulamayla etkileşime geçerek zamanlayıcıyı sıfırlamazsa).
  3. dataSync veya mediaProcessing ön plan hizmetlerini yalnızca doğrudan kullanıcı etkileşimi sonucunda başlatın. Hizmetiniz başladığında uygulamanız ön planda olduğundan, uygulamanız arka plana geçtikten sonra hizmetiniz altı saat boyunca çalışır.
  4. Bu ön plan hizmetlerini kullanmak yerine WorkManager gibi bir alternatif API kullanın. Özellikle, dataSync ön plan hizmeti yerine alternatif bir API kullanmayı düşünebilirsiniz.

Uygulamanızın dataSync ön plan hizmetleri son 24 saat içinde 6 saat boyunca çalıştıysa kullanıcı uygulamanızı ön plana getirmediği (bu durumda zamanlayıcı sıfırlanır) sürece başka bir dataSync ön plan hizmeti başlatamazsınız. Başka bir dataSync ön plan hizmetini başlatmaya çalışırsanız sistem, "dataSync ön plan hizmet türü için zaman sınırı zaten aşıldı" gibi bir hata mesajıyla ForegroundServiceStartNotAllowedException oluşturur.

Test

Uygulamanızın davranışını test etmek için uygulamanız Android 15'i hedeflemese bile veri senkronizasyonu zaman aşımlarını etkinleştirebilirsiniz (uygulama Android 15 cihazda çalışıyorsa). Zaman aşımlarını etkinleştirmek için aşağıdaki adb komutunu çalıştırın:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

Ayrıca, sınıra ulaşıldığında uygulamanızın nasıl davrandığını test etmeyi kolaylaştırmak için zaman aşımı süresini ayarlayabilirsiniz. dataSync ön plan hizmetleri için yeni bir zaman aşımı süresi ayarlamak üzere aşağıdaki adb komutunu çalıştırın:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

mediaProcessing ön plan hizmetleri için yeni bir zaman aşımı süresi ayarlamak üzere şu komutu çalıştırın:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds