No Android 9 e superior, a plataforma pode monitorar aplicativos em busca de comportamentos que afetem negativamente a vida útil da bateria dos dispositivos. A plataforma usa e avalia regras de configuração para fornecer um fluxo de experiência do usuário que dá aos usuários a opção de restringir aplicativos que violam as regras.
No Android 8.0 e inferior, havia restrições por meio de recursos como Soneca, espera de aplicativos, limites de segundo plano e limites de localização em segundo plano. No entanto, alguns aplicativos continuaram a apresentar comportamentos inadequados, alguns dos quais são descritos no Android vitals . O Android 9 introduziu uma infraestrutura de sistema operacional que pode detectar e restringir aplicativos com base em regras de configuração que podem ser atualizadas ao longo do tempo.
Restrições de segundo plano
Os usuários podem restringir os aplicativos ou o sistema pode sugerir que os aplicativos detectados estão impactando negativamente a integridade do dispositivo.
Aplicativos restritos:
- Ainda pode ser iniciado pelo usuário.
- Não é possível executar trabalhos/alarmes ou usar a rede em segundo plano.
- Não é possível executar serviços em primeiro plano.
- Pode ser alterado para um aplicativo irrestrito pelo usuário.
Os implementadores de dispositivos podem adicionar restrições adicionais aos aplicativos para:
- Restrinja a reinicialização automática do aplicativo.
- Restringir a vinculação de serviços (altamente arriscado).
Não se espera que aplicativos restritos em segundo plano consumam recursos do dispositivo, como memória, CPU e bateria. Os aplicativos restritos em segundo plano não devem afetar a integridade do dispositivo quando o usuário não estiver usando ativamente esses aplicativos. No entanto, espera-se que os mesmos aplicativos estejam totalmente funcionais quando o usuário os inicia.
Use implementações personalizadas
Os implementadores de dispositivos podem continuar a usar seus métodos personalizados para aplicar restrições aos aplicativos.
Integrar restrições de aplicativos
As seções a seguir descrevem como definir e integrar restrições de aplicativos em seu dispositivo. Se você estiver usando métodos de restrição de aplicativos do Android 8.x ou inferior, revise atentamente as seções a seguir para ver as alterações no Android 9 e superior.
Defina o sinalizador AppOpsManager
Quando um aplicativo for restrito, defina o sinalizador apropriado em AppOpsManager . Um exemplo de trecho de código de 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);
}
Certifique-se de que isBackgroundRestricted retorne verdadeiro
Quando um aplicativo for restrito, certifique-se de que ActivityManager.isBackgroundRestricted() retorne true .
Registre o motivo da restrição
Quando um aplicativo é restrito, registre os motivos da restrição. Um exemplo de trecho de código de registro de 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));
}
Substitua type pelo valor de AnomalyType .
Os implementadores de dispositivos podem usar as constantes definidas em 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;
}
Quando o usuário ou o sistema remove as restrições de um aplicativo, você deve registrar os motivos da remoção das restrições. Um exemplo de trecho de código de registro de 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));
}
Testar restrições de aplicativos
Para testar o comportamento das restrições de aplicativos no Android 9 e superior, use um dos seguintes comandos:
- Colocar um aplicativo em restrição:
appops set package-name RUN_ANY_IN_BACKGROUND ignore
- Retire um aplicativo da restrição e restaure o comportamento padrão:
appops set package-name RUN_ANY_IN_BACKGROUND allow
- Faça com que um aplicativo em segundo plano fique ocioso imediatamente:
am make-uid-idle [--user user-id | all | current] package-name
- Adicione um pacote ao
tempwhitelistpor um curto período:cmd deviceidle tempwhitelist [-u user] [-d duration] [package package-name]
- Adicionar/remover um pacote da lista de permissões do usuário:
cmd deviceidle whitelist [+/-]package-name
- Verifique o estado interno do
jobschedulere do gerenciador de alarmes:dumpsys jobschedulerdumpsys alarm
Modo de espera do aplicativo
O modo de espera de aplicativos prolonga a vida útil da bateria, adiando atividades de rede em segundo plano e trabalhos para aplicativos que o usuário não está usando ativamente.
Ciclo de vida em espera do aplicativo
A plataforma detecta aplicativos inativos e os coloca em espera até que o usuário comece a interagir ativamente com o aplicativo.
Durante a fase de detecção , a plataforma detecta que um aplicativo está inativo quando o dispositivo não está carregando e o usuário não iniciou o aplicativo direta ou indiretamente por um período específico de tempo de relógio, bem como por um período específico de tempo de tela ligada . (As inicializações indiretas ocorrem quando um aplicativo em primeiro plano acessa um serviço em um segundo aplicativo.)
Durante o modo de espera do aplicativo , a plataforma impede que aplicativos acessem a rede mais de uma vez por dia, adiando sincronizações de aplicativos e outros trabalhos.
A plataforma sai do aplicativo do modo de espera quando:
- O aplicativo fica ativo.
- O dispositivo está conectado e carregando.
Os aplicativos ativos não são afetados pelo modo de espera do aplicativo. Um aplicativo está ativo quando tem:
- Um processo atualmente em primeiro plano (seja como uma atividade ou serviço em primeiro plano, ou em uso por outra atividade ou serviço em primeiro plano), como ouvinte de notificação, serviços de acessibilidade, papel de parede ao vivo, etc.
- Uma notificação visualizada pelo usuário, como na tela de bloqueio ou na bandeja de notificações
- Foi lançado explicitamente pelo usuário
Um aplicativo fica inativo se nenhuma das atividades acima ocorrer por um período de tempo.
Teste o modo de espera do aplicativo
Você pode testar manualmente o modo de espera do aplicativo usando os seguintes comandos adb :
adb shell dumpsys battery unplugadb shell am set-idle package-name trueadb shell am set-idle package-name falseadb shell am get-idle package-name