Uygulama güç yönetimi

Android 9 ve sonraki sürümlerde platform, cihazların pil ömrünü olumsuz yönde etkileyen davranışları tespit etmek için uygulamaları izleyebilir. Platform, kullanıcılara kuralları ihlal eden uygulamaları kısıtlama seçeneği sunan bir kullanıcı deneyimi akışı sağlamak için kurulum kurallarını kullanır ve değerlendirir.

Android 8.0 ve önceki sürümlerde Doze, uygulama bekleme, arka plan sınırlamaları ve arka plan konum sınırlamaları gibi özellikler aracılığıyla kısıtlamalar vardı. Ancak bazı uygulamalar kötü davranışlar sergilemeye devam etti. Bu davranışlardan bazıları Android vitals'da açıklanmaktadır. Android 9, zaman içinde güncellenebilen kurulum kurallarına göre uygulamaları algılayıp kısıtlayabilen bir işletim sistemi altyapısı kullanıma sundu.

Arka plan kısıtlamaları

Kullanıcılar uygulamaları kısıtlayabilir veya sistem, cihazın sağlığını olumsuz yönde etkilediğini tespit ettiği uygulamaları önerebilir.

Kısıtlanmış uygulamalar:

  • Kullanıcı tarafından başlatılmaya devam edebilir.
  • Arka planda iş/alarm çalıştıramaz veya ağı kullanamaz.
  • Ön plan hizmetleri çalıştırılamaz.
  • Kullanıcı tarafından kısıtlanmamış bir uygulamaya değiştirilebilir.

Cihaz uygulayıcıları, uygulamalara ek kısıtlamalar ekleyerek şunları yapabilir:

  • Uygulamanın kendi kendini yeniden başlatmasını kısıtlayın.
  • Hizmetlerin bağlanmasını kısıtlayın (yüksek riskli).

Arka planda kısıtlanmış uygulamaların bellek, CPU ve pil gibi cihaz kaynaklarını tüketmesi beklenmez. Arka planda kısıtlanmış uygulamalar, kullanıcı bu uygulamaları etkin olarak kullanmıyorken cihaz sağlığını etkilememelidir. Ancak kullanıcı bu uygulamaları başlattığında aynı uygulamaların tam işlevli olması beklenir.

Özel uygulamaları kullanma

Cihaz uygulayıcıları, uygulamalara kısıtlama uygulamak için özel yöntemlerini kullanmaya devam edebilir.

Uygulama kısıtlamalarını entegre etme

Aşağıdaki bölümlerde, uygulama kısıtlamalarının cihazınızda nasıl tanımlanacağı ve entegre edileceği açıklanmaktadır. Android 8.x veya önceki sürümlerdeki uygulama kısıtlama yöntemlerini kullanıyorsanız Android 9 ve sonraki sürümlerdeki değişiklikler için aşağıdaki bölümleri dikkatlice inceleyin.

AppOpsManager işaretini ayarlama

Bir uygulama kısıtlandığında AppOpsManager içinde uygun işareti ayarlayın. packages/apps/Settings/src/com/android/settings/fuelgauge/BatteryUtils.java kaynağından örnek bir kod snippet'i:

   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);
    }

isBackgroundRestricted işlevinin doğru değerini döndürdüğünden emin olun

Bir uygulama kısıtlandığında ActivityManager.isBackgroundRestricted() işlevinin true değerini döndürdüğünden emin olun.

Kısıtlama nedenini günlüğe kaydetme

Bir uygulama kısıtlandığında kısıtlama nedenlerini günlüğe kaydedin. packages/apps/Settings/src/com/android/settings/fuelgauge/batterytip/actions/RestrictAppAction.java kaynağından günlük kaydını gösteren örnek kod snippet'i:

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));
  }

type değerini AnomalyType değerinden alınan değerle değiştirin.

Cihaz uygulayıcıları, src/com/android/settings/fuelgauge/batterytip/StatsManagerConfig.java içinde tanımlanan sabitleri kullanabilir:

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;
    }

Kullanıcı veya sistem bir uygulamanın kısıtlamalarını kaldırdığında, kısıtlamaların kaldırılma nedenlerini günlüğe kaydetmeniz gerekir. packages/apps/Settings/src/com/android/settings/fuelgauge/batterytip/actions/UnrestrictAppAction.java kaynağından günlük kaydı oluşturma örneği kod snippet'i:

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));
    }

Test uygulaması kısıtlamaları

Android 9 ve sonraki sürümlerde uygulama kısıtlamalarının davranışını test etmek için aşağıdaki komutlardan birini kullanın:

  • Bir uygulamayı kısıtlamaya alma:
    appops set package-name RUN_ANY_IN_BACKGROUND ignore
  • Bir uygulamayı kısıtlamadan çıkarıp varsayılan davranışı geri yükleyin:
    appops set package-name RUN_ANY_IN_BACKGROUND allow
  • Arka planda çalışan bir uygulamayı hemen boşta durumuna getirin:
    am make-uid-idle [--user user-id | all | current] package-name
  • Bir paketi kısa süreliğine tempwhitelist'e ekleyin:
    cmd deviceidle tempwhitelist [-u user] [-d duration] [package package-name]
  • Kullanıcı beyaz listesine paket ekleme/kaldırma:
    cmd deviceidle whitelist [+/-]package-name
  • jobscheduler ve alarm yöneticisinin dahili durumunu kontrol edin:
    dumpsys jobscheduler
    dumpsys alarm

Uygulamayı beklemeye alma

Uygulama bekleme modu, kullanıcının etkin olarak kullanmadığı uygulamaların arka plan ağ etkinliğini ve işlerini erteleyerek pil ömrünü uzatır.

Uygulamayı beklemeye alma yaşam döngüsü

Platform, etkin olmayan uygulamaları algılar ve kullanıcı uygulamayla etkin bir şekilde etkileşime geçene kadar bunları uygulama bekleme moduna yerleştirir.

Algılama aşamasında platform, cihaz şarj olmuyorsa ve kullanıcı belirli bir süre boyunca doğrudan veya dolaylı olarak uygulamayı başlatmamışsa uygulamanın etkin olmadığını algılar. (Dolaylı başlatmalar, ön plan uygulaması ikinci bir uygulamadaki bir hizmete eriştiğinde gerçekleşir.)

Uygulama bekleme sırasında platform, uygulama senkronizasyonlarını ve diğer işleri erteleyerek uygulamaların günde bir defadan fazla ağa erişmesini engeller.

Platform aşağıdaki durumlarda uygulamayı bekleme modundan çıkarır:

  • Uygulama etkin hale gelir.
  • Cihaz fişe takılı ve şarj oluyor.

Etkin uygulamalar, uygulama bekleme modundan etkilenmez. Aşağıdaki özelliklere sahip uygulamalar etkin olarak kabul edilir:

  • Bildirim dinleyici, erişilebilirlik hizmetleri, canlı duvar kağıdı vb. gibi şu anda ön planda olan bir işlem (etkinlik veya ön plan hizmeti olarak ya da başka bir etkinlik veya ön plan hizmeti tarafından kullanılıyor).
  • Kullanıcı tarafından görüntülenen bildirim (ör. kilit ekranında veya bildirim tepsisinde)
  • Kullanıcı tarafından açıkça başlatılmış olmalıdır.

Bir süre boyunca yukarıdaki etkinliklerden hiçbiri gerçekleşmezse uygulama etkin değildir.

Uygulamayı beklemeye alma özelliğini test etme

Uygulama bekleme modunu aşağıdaki adb komutları kullanarak manuel olarak test edebilirsiniz:

adb shell dumpsys battery unplug
adb shell am set-idle package-name true
adb shell am set-idle package-name false
adb shell am get-idle package-name