Ograniczenia dotyczące uruchamiania usługi na pierwszym planie z poziomu tła

Aplikacje kierowane na Androida 12 (poziom API 31) lub nowszego nie mogą uruchamiać usług na pierwszym planie, gdy działają w tle, z wyjątkiem kilku szczególnych przypadków. Jeśli aplikacja próbuje uruchomić usługę na pierwszym planie, gdy działa w tle, a usługa na pierwszym planie nie spełnia warunków jednego z wyjątkowych przypadków, system zgłasza błąd ForegroundServiceStartNotAllowedException.

Jeśli aplikacja chce uruchomić usługę na pierwszym planie, która wymaga uprawnień podczas używania (np. czujników biometrycznych, aparatu, mikrofonu lub dostępu do lokalizacji), nie może utworzyć usługi, gdy działa w tle, nawet jeśli jest objęta jednym ze zwolnień z ograniczeń uruchamiania w tle. Powód został wyjaśniony w sekcji Ograniczenia dotyczące uruchamiania usług na pierwszym planie, które wymagają uprawnień podczas używania.

Wyjątki od ograniczeń dotyczących uruchamiania w tle

W tych sytuacjach aplikacja może uruchamiać usługi na pierwszym planie, nawet gdy działa w tle:

Ograniczenia dotyczące uruchamiania usług działających na pierwszym planie, które wymagają uprawnień podczas używania

W przypadku Androida 14 (API na poziomie 34) lub nowszego należy pamiętać o szczególnych sytuacjach, jeśli uruchamiasz usługę na pierwszym planie, która wymaga uprawnień podczas używania.

Jeśli Twoja aplikacja jest kierowana na Androida 14 lub nowszego, system operacyjny sprawdza, czy podczas tworzenia usługi na pierwszym planie aplikacja ma wszystkie odpowiednie uprawnienia dla tego typu usługi. Na przykład gdy tworzysz usługę na pierwszym planie typu mikrofon, system operacyjny sprawdza, czy aplikacja ma obecnie uprawnienie RECORD_AUDIO. Jeśli nie masz tego uprawnienia, system wyświetli błąd SecurityException.

W przypadku uprawnień „podczas używania” powoduje to potencjalny problem. Jeśli aplikacja ma uprawnienie „podczas używania”, ma je tylko wtedy, gdy działa na pierwszym planie. Oznacza to, że jeśli aplikacja działa w tle i próbuje utworzyć usługę działającą na pierwszym planie typu aparat, lokalizacja lub mikrofon, system widzi, że aplikacja obecnie nie ma wymaganych uprawnień, i wyświetla błąd SecurityException.

Podobnie, jeśli aplikacja tworzy usługę health, która wymaga uprawnienia BODY_SENSORS, gdy działa w tle, system zgłasza wyjątek. (Nie dotyczy to sytuacji, gdy usługa health wymaga innych uprawnień, takich jak ACTIVITY_RECOGNITION).

Wywołanie metody PermissionChecker.checkSelfPermission nie zapobiega temu problemowi. Jeśli aplikacja ma uprawnienie do używania tylko podczas korzystania i wywołuje metodę checkSelfPermission, aby sprawdzić, czy ma to uprawnienie, metoda zwraca PERMISSION_GRANTED, nawet jeśli aplikacja działa w tle. Gdy metoda zwraca wartość PERMISSION_GRANTED, oznacza to, że aplikacja ma to uprawnienie, gdy jest używana.

Z tego powodu, jeśli usługa na pierwszym planie wymaga uprawnienia „podczas używania”, musisz wywołać Context.startForegroundService() lub Context.bindService(), gdy aplikacja ma widoczną aktywność, chyba że usługa jest objęta jednym ze zdefiniowanych wyjątków.

Wyjątki od ograniczeń dotyczących uprawnień podczas używania

W niektórych sytuacjach, nawet jeśli usługa na pierwszym planie zostanie uruchomiona, gdy aplikacja działa w tle, może ona nadal uzyskiwać dostęp do informacji o lokalizacji, aparacie i mikrofonie, gdy aplikacja działa na pierwszym planie („podczas używania”).

W tych samych sytuacjach, jeśli usługa deklaruje typ usługi na pierwszym planie jako location i jest uruchamiana przez aplikację, która ma uprawnienie ACCESS_BACKGROUND_LOCATION, może ona uzyskiwać dostęp do informacji o lokalizacji przez cały czas, nawet gdy aplikacja działa w tle.

Na liście poniżej znajdziesz te sytuacje:

  • Komponent systemowy uruchamia usługę.
  • Usługa zaczyna działać, gdy użytkownik wejdzie w interakcję z widżetami aplikacji.
  • Usługa rozpoczyna się od interakcji z powiadomieniem.
  • Usługa uruchamia się jako PendingIntent wysyłany z innej, widocznej aplikacji.
  • Usługa jest uruchamiana przez aplikację, która jest kontrolerem zasad dotyczących urządzeń działającym w trybie właściciela urządzenia.
  • Usługa jest uruchamiana przez aplikację, która udostępnia VoiceInteractionService.
  • Usługa jest uruchamiana przez aplikację, która ma uprawnienia uprzywilejowane START_ACTIVITIES_FROM_BACKGROUND.

Określanie, których usług w aplikacji dotyczy problem

Podczas testowania aplikacji uruchom jej usługi działające na pierwszym planie. Jeśli uruchomiona usługa ma ograniczony dostęp do lokalizacji, mikrofonu i aparatu, w Logcat pojawi się ten komunikat:

Foreground service started from background can not have \
location/camera/microphone access: service SERVICE_NAME