Jeśli aplikacja jest kierowana na Androida 15 lub nowszego, system nakłada ograniczenia dotyczące czasu działania niektórych usług działających na pierwszym planie, gdy aplikacja jest w tle. Obecnie to ograniczenie dotyczy tylko usług typu dataSync i mediaProcessing działających na pierwszym planie. W przypadku shortService typu usługi działającej na pierwszym planie obowiązują bardziej restrykcyjne limity, o których mowa w dokumentacji.
Zachowanie w przypadku upłynięcia limitu czasu
System zezwala usługom na pierwszym planie typu dataSync i mediaProcessing na działanie przez łącznie 6 godzin w ciągu 24 godzin, po czym wywołuje metodę Service.onTimeout(int, int) działającej usługi (wprowadzoną w Androidzie 15). (typ usługi mediaProcessing działającej na pierwszym planie został dodany w Androidzie 15). 6-godzinny limit czasu jest śledzony osobno w przypadku usług dataSync i mediaProcessing. Jeśli na przykład usługa dataSync działała przez godzinę, aplikacja miałaby do dyspozycji tylko 5 godzin na usługi mediaProcessing na pierwszym planie, ale 6 godzin na usługi dataSync.
Gdy usługa na pierwszym planie osiągnie limit 6 godzin, ma kilka sekund na wywołanie Service.stopSelf(). Gdy system wywoła usługę Service.onTimeout(), nie będzie ona już usługą na pierwszym planie.
Jeśli usługa nie wywołuje funkcji Service.stopSelf(), system zgłasza wewnętrzny wyjątek. Wyjątek jest rejestrowany w Logcat z tym komunikatem:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type [service type] did not stop within its timeout: [component name]"
Aby uniknąć problemów związanych z tą zmianą zachowania, możesz wykonać co najmniej jedną z tych czynności:
- Zaimplementuj w usłudze nową metodę
Service.onTimeout(int, int). Gdy aplikacja otrzyma połączenie zwrotne, w ciągu kilku sekund zadzwoń pod numerstopSelf(). (jeśli nie zatrzymasz aplikacji od razu, system wygeneruje błąd). - Upewnij się, że usługi
dataSyncimediaProcessingw aplikacji nie działają dłużej niż 6 godzin w ciągu 24 godzin (chyba że użytkownik wchodzi w interakcję z aplikacją, resetując w ten sposób minutnik). - Uruchamiaj usługi
dataSynclubmediaProcessingna pierwszym planie tylko w wyniku bezpośredniej interakcji z użytkownikiem. Ponieważ podczas uruchamiania usługi aplikacja jest na pierwszym planie, po przejściu aplikacji w stan w tle usługa ma do dyspozycji pełne 6 godzin. - Zamiast tych usług na pierwszym planie użyj alternatywnego interfejsu API, np. WorkManager. Zamiast używać
dataSyncusługi na pierwszym planie, rozważ użycie alternatywnego interfejsu API.
Jeśli w ciągu ostatnich 24 godzin usługi dataSync na pierwszym planie Twojej aplikacji działały przez 6 godzin, nie możesz uruchomić innej usługi dataSync na pierwszym planie chyba że użytkownik przełączył aplikację na pierwszy plan (co spowoduje zresetowanie minutnika). Jeśli spróbujesz uruchomić inną usługę dataSync na pierwszym planie, system wyświetli komunikat o błędzie, np. „Limit czasu usługi na pierwszym planie typu dataSync został już wyczerpany”.ForegroundServiceStartNotAllowedException
Testowanie
Aby przetestować działanie aplikacji, możesz włączyć limity czasu synchronizacji danych, nawet jeśli aplikacja nie jest kierowana na Androida 15 (o ile jest uruchomiona na urządzeniu z Androidem 15). Aby włączyć limity czasu, uruchom to polecenie adb:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
Możesz też dostosować czas oczekiwania, aby łatwiej testować działanie aplikacji po osiągnięciu limitu. Aby ustawić nowy okres oczekiwania dla usług dataSync na pierwszym planie, uruchom to polecenie adb:
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
Aby ustawić nowy okres oczekiwania dla usług mediaProcessing na pierwszym planie, uruchom to polecenie:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds