W Androidzie 9 i nowszych platforma może monitorować aplikacje pod kątem negatywnie wpływa na żywotność baterii urządzeń. Platforma wykorzystuje ocenia reguły konfiguracji, aby zapewnić użytkownikowi możliwość ograniczanie dostępu do aplikacji, które naruszają reguły.
W Androidzie 8.0 i starszych wersjach występowały ograniczenia takich jak uśpienie, tryb gotowości aplikacji, limity działania w tle oraz lokalizacja w tle. i ograniczeniach. Jednak niektóre aplikacje nadal wykazują niewłaściwe działanie, które są opisane w Android Vitals. W Androidzie 9 wprowadzono infrastrukturę systemu operacyjnego, która może wykrywać i ograniczać dostęp na podstawie reguł konfiguracji, które z czasem można aktualizować.
Ograniczenia w tle
Użytkownicy mogą ograniczać dostęp do aplikacji lub system może sugerować aplikacje, co ma negatywny wpływ na kondycję urządzenia.
Aplikacje z ograniczeniami:
- Może nadal być uruchamiany przez użytkownika.
- Nie można uruchamiać zadań ani alarmów ani używać sieci w tle.
- Nie można uruchomić usług działających na pierwszym planie.
- Użytkownik może zmienić ją na aplikację bez ograniczeń.
Narzędzia implementujące na urządzeniach mogą nakładać na aplikacje dodatkowe ograniczenia, aby:
- Ogranicz możliwość samodzielnego ponownego uruchamiania aplikacji.
- Ogranicz powiązanie usług (duże ryzyko).
Aplikacje z ograniczeniami w tle nie powinny zużywać zasobów urządzenia takich jak: pamięci, procesora i baterii. Aplikacje z dostępem w tle nie powinny wpływać na stan urządzenia, gdy użytkownik nie korzysta aktywnie z tych aplikacji. Jednak te same aplikacje powinny być w pełni funkcjonalne, gdy użytkownik je uruchomi.
Korzystanie z implementacji niestandardowych
Twórcy implementacji na urządzeniach nadal mogą używać własnych metod, aby nakładać ograniczenia na aplikacje.
Integracja ograniczeń aplikacji
W sekcjach poniżej opisujemy, jak zdefiniować i zintegrować aplikację ograniczenia na Twoim urządzeniu. Jeśli korzystasz z metod ograniczania dostępu do aplikacji na Androidzie 8.x lub starszym, zapoznaj się dokładnie z tymi sekcjami zmian w Androidzie 9 i nowszych.
Ustawianie flagi AppOpsManager
Jeśli dostęp do aplikacji jest ograniczony, ustaw odpowiednią flagę w
AppOpsManager Przykładowy fragment kodu z
packages/apps/Settings/src/com/android/settings/fuelgauge/BatteryUtils.java:
public void setForceAppStandby(int uid, String packageName,
int mode) {
final boolean isPreOApp = isPreOApp(packageName);
if (isPreOApp) {
// Control whether app could run in the background if it is pre O app
mAppOpsManager.setMode(AppOpsManager.OP_RUN_IN_BACKGROUND, uid, packageName, mode);
}
// Control whether app could run jobs in the background
mAppOpsManager.setMode(AppOpsManager.OP_RUN_ANY_IN_BACKGROUND, uid, packageName, mode);
}
Sprawdź, czy parametr isBackgroundRestricted zwraca wartość „true”
Jeśli dostęp do aplikacji jest ograniczony, upewnij się, że:
ActivityManager.isBackgroundRestricted() zwraca wartość true.
Zapisz przyczynę nałożenia ograniczenia
Jeśli dostęp do aplikacji jest ograniczony, zapisz przyczyny tego ograniczenia. An
przykładowy fragment kodu logowania z
packages/apps/Settings/src/com/android/settings/fuelgauge/batterytip/actions/RestrictAppAction.java:
mBatteryUtils.setForceAppStandby(mBatteryUtils.getPackageUid(packageName), packageName,AppOpsManager.MODE_IGNORED);
if (CollectionUtils.isEmpty(appInfo.anomalyTypes)) {
// Only log context if there is no anomaly type
mMetricsFeatureProvider.action(mContext,
MetricsProto.MetricsEvent.ACTION_TIP_RESTRICT_APP, packageName,
Pair.create(MetricsProto.MetricsEvent.FIELD_CONTEXT,metricsKey));
} else {
// Log ALL the anomaly types
for (int type : appInfo.anomalyTypes) {
mMetricsFeatureProvider.action(mContext,
MetricsProto.MetricsEvent.ACTION_TIP_RESTRICT_APP, packageName,
Pair.create(MetricsProto.MetricsEvent.FIELD_CONTEXT, metricsKey),
Pair.create(MetricsProto.MetricsEvent.FIELD_ANOMALY_TYPE, type));
}
Zastąp type wartością z AnomalyType.
Implementatory urządzeń mogą używać stałych zdefiniowanych w
src/com/android/settings/fuelgauge/batterytip/StatsManagerConfig.java:
public @interface AnomalyType {
// This represents an error condition in the anomaly detection.
int NULL = -1;
// The anomaly type does not match any other defined type.
int UNKNOWN_REASON = 0;
// The application held a partial (screen off) wake lock for a period of time that
// exceeded the threshold with the screen off when not charging.
int EXCESSIVE_WAKELOCK_ALL_SCREEN_OFF = 1;
// The application exceeded the maximum number of wakeups while in the background
// when not charging.
int EXCESSIVE_WAKEUPS_IN_BACKGROUND = 2;
// The application did unoptimized Bluetooth scans too frequently when not charging.
int EXCESSIVE_UNOPTIMIZED_BLE_SCAN = 3;
// The application ran in the background for a period of time that exceeded the
// threshold.
int EXCESSIVE_BACKGROUND_SERVICE = 4;
// The application exceeded the maximum number of wifi scans when not charging.
int EXCESSIVE_WIFI_SCAN = 5;
// The application exceed the maximum number of flash writes
int EXCESSIVE_FLASH_WRITES = 6;
// The application used more than the maximum memory, while not spending any time
// in the foreground.
int EXCESSIVE_MEMORY_IN_BACKGROUND = 7;
// The application exceeded the maximum percentage of frames with a render rate of
// greater than 700ms.
int EXCESSIVE_DAVEY_RATE = 8;
// The application exceeded the maximum percentage of frames with a render rate
// greater than 16ms.
int EXCESSIVE_JANKY_FRAMES = 9;
// The application exceeded the maximum cold start time - the app has not been
// launched since last system start, died or was killed.
int SLOW_COLD_START_TIME = 10;
// The application exceeded the maximum hot start time - the app and activity are
// already in memory.
int SLOW_HOT_START_TIME = 11;
// The application exceeded the maximum warm start time - the app was already in
// memory but the activity wasn't created yet or was removed from memory.
int SLOW_WARM_START_TIME = 12;
// The application exceeded the maximum number of syncs while in the background.
int EXCESSIVE_BACKGROUND_SYNCS = 13;
// The application exceeded the maximum number of gps scans while in the background.
int EXCESSIVE_GPS_SCANS_IN_BACKGROUND = 14;
// The application scheduled more than the maximum number of jobs while not charging.
int EXCESSIVE_JOB_SCHEDULING = 15;
// The application exceeded the maximum amount of mobile network traffic while in
// the background.
int EXCESSIVE_MOBILE_NETWORK_IN_BACKGROUND = 16;
// The application held the WiFi lock for more than the maximum amount of time while
// not charging.
int EXCESSIVE_WIFI_LOCK_TIME = 17;
// The application scheduled a job that ran longer than the maximum amount of time.
int JOB_TIMED_OUT = 18;
// The application did an unoptimized Bluetooth scan that exceeded the maximum
// time while in the background.
int LONG_UNOPTIMIZED_BLE_SCAN = 19;
// The application exceeded the maximum ANR rate while in the background.
int BACKGROUND_ANR = 20;
// The application exceeded the maximum crash rate while in the background.
int BACKGROUND_CRASH_RATE = 21;
// The application exceeded the maximum ANR-looping rate.
int EXCESSIVE_ANR_LOOPING = 22;
// The application exceeded the maximum ANR rate.
int EXCESSIVE_ANRS = 23;
// The application exceeded the maximum crash rate.
int EXCESSIVE_CRASH_RATE = 24;
// The application exceeded the maximum crash-looping rate.
int EXCESSIVE_CRASH_LOOPING = 25;
// The application crashed because no more file descriptors were available.
int NUMBER_OF_OPEN_FILES = 26;
}
Gdy użytkownik lub system usunie ograniczenia aplikacji, musisz:
zapisać przyczyny usunięcia ograniczeń. Przykładowy fragment kodu logowania z
packages/apps/Settings/src/com/android/settings/fuelgauge/batterytip/actions/UnrestrictAppAction.java:
public void handlePositiveAction(int metricsKey) {
final AppInfo appInfo = mUnRestrictAppTip.getUnrestrictAppInfo();
// Clear force app standby, then app can run in the background
mBatteryUtils.setForceAppStandby(appInfo.uid, appInfo.packageName,
AppOpsManager.MODE_ALLOWED);
mMetricsFeatureProvider.action(mContext,
MetricsProto.MetricsEvent.ACTION_TIP_UNRESTRICT_APP, appInfo.packageName,
Pair.create(MetricsProto.MetricsEvent.FIELD_CONTEXT, metricsKey));
}
Testuj ograniczenia aplikacji
Aby przetestować działanie ograniczeń aplikacji na Androidzie 9 i nowszych, użyj jednej z metod następujące polecenia:
- Wprowadzanie aplikacji w ograniczenia:
appops set
package-name RUN_ANY_IN_BACKGROUND ignore - Przywróć aplikację z ograniczeń i przywróć jej domyślne działanie:
appops set
package-name RUN_ANY_IN_BACKGROUND allow - Aplikacje działające w tle natychmiast staną się bezczynne:
am make-uid-idle [--user
user-id | all | current]package-name - Dodaj pakiet do
tempwhitelistna krótki czas:cmd deviceidle tempwhitelist [-u
user ] [-dduration ] [packagepackage-name ] - Dodawanie pakietu do białej listy użytkownika lub usuwanie go z niej:
cmd deviceidle whitelist [+/-]
package-name - Sprawdź stan wewnętrzny urządzenia
jobscheduleri menedżera alarmów:dumpsys jobschedulerdumpsys alarm
Tryb gotowości aplikacji
Tryb czuwania aplikacji wydłuża czas pracy na baterii, opóźniając działanie sieci w tle w przypadku aplikacji, których użytkownik aktywnie nie używa.
Cykl życia aplikacji w trybie gotowości
Platforma wykrywa nieaktywne aplikacje i umieszcza je w aplikacji w trybie gotowości, dopóki użytkownik nie zacznie aktywnie korzystać z aplikacji.
Na fazie wykrywania platforma wykrywa, że aplikacja jest nieaktywna, gdy urządzenie się nie ładuje a użytkownik nie uruchomił aplikacji bezpośrednio lub pośrednio przez określony czas zegara, jak i czas aktywności ekranu. (Uruchomienia pośrednie mają miejsce, gdy aplikacja na pierwszym planie uzyskuje dostęp do usługi w drugiej aplikacji).
W trybie czuwania aplikacji platforma uniemożliwia aplikacjom większy dostęp do sieci niż raz dziennie, opóźniając synchronizację aplikacji i wykonywanie innych zadań.
Platforma wyjdzie z trybu gotowości, gdy:
- Aplikacja stanie się aktywna.
- Urządzenie jest podłączone i się ładuje.
Tryb gotowości aplikacji nie ma wpływu na aktywne aplikacje. Aplikacja jest aktywna, jeśli:
- Proces na pierwszym planie (jako aktywność lub usługi na pierwszym planie bądź używane przez inną aktywność lub usługę na pierwszym planie); takich jak detektor powiadomień, usługi ułatwień dostępu, animowana tapeta itp.
- powiadomienie wyświetlone przez użytkownika, na przykład na ekranie blokady lub panel powiadomień
- być wyraźnie uruchomione przez użytkownika,
Aplikacja jest nieaktywna, jeśli przez okres nie wystąpiła żadna z powyższych aktywności czasu.
Tryb gotowości aplikacji testowej
Możesz ręcznie przetestować tryb gotowości aplikacji za pomocą tego adb
polecenia:
adb shell dumpsys battery unplugadb shell am set-idlepackage-name trueadb shell am set-idlepackage-name falseadb shell am get-idlepackage-name