本頁面由 Cloud Translation API 翻譯而成。

應用電源管理

在 Android 9 及更高版本中，該平台可以監控應用程序是否存在對設備電池壽命產生負面影響的行為。該平台使用並評估設置規則以提供用戶體驗流程，讓用戶可以選擇限制違反規則的應用程序。

在 Android 8.0 及更低版本中，通過 Doze、應用待機、後台限制和後台位置限制等功能進行了限制。但是，一些應用程序繼續表現出不良行為，其中一些在Android Vitals中有所描述。 Android 9 引入了一種操作系統基礎架構，該基礎架構可以根據可隨時間更新的設置規則檢測和限制應用程序。

背景限制

用戶可以限制應用程序，或者係統可能會建議它檢測到的應用程序對設備的健康產生負面影響。

受限應用：

仍然可以由用戶啟動。
無法在後台運行作業/警報或使用網絡。
無法運行前台服務。
可以由用戶更改為不受限制的應用程序。

設備實施者可以為應用添加額外的限制：

限制應用程序自行重啟。
限制服務被綁定（高風險）。

後台受限制的應用程序預計不會消耗任何設備資源，例如內存、CPU 和電池。當用戶不主動使用這些應用程序時，後台受限應用程序不應影響設備運行狀況。但是，當用戶啟動應用程序時，相同的應用程序預計會完全正常運行。

使用自定義實現

設備實施者可以繼續使用他們的自定義方法對應用程序施加限制。

集成應用限制

以下部分概述瞭如何在您的設備上定義和集成應用程序限制。如果您使用的是 Android 8.x 或更低版本的應用限制方法，請仔細查看以下部分，了解 Android 9 及更高版本的變化。

設置 AppOpsManager 標誌

當應用程序受到限制時，請在AppOpsManager中設置適當的標誌。來自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);
    }

確保 isBackgroundRestricted 返回 true

當應用程序受到限制時，請確保ActivityManager.isBackgroundRestricted()返回true 。

記錄限制原因

當應用程序受到限制時，請記錄限制原因。來自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));
  }

將type替換為AnomalyType中的值。

設備實現者可以使用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;
}

當用戶或系統移除應用程序的限制時，您必須記錄移除限制的原因。來自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));
    }

測試應用限制

要測試 Android 9 及更高版本中應用限制的行為，請使用以下命令之一：

限制應用：

appops set package-name RUN_ANY_IN_BACKGROUND ignore

讓應用擺脫限制並恢復默認行為：

appops set package-name RUN_ANY_IN_BACKGROUND allow

讓後台的應用程序立即空閒：

am make-uid-idle [--user user-id | all | current] package-name

將包短時間添加到tempwhitelist ：

cmd deviceidle tempwhitelist [-u user] [-d duration] [package package-name]

從用戶白名單中添加/刪除包：

cmd deviceidle whitelist [+/-]package-name

檢查jobscheduler器和警報管理器的內部狀態：
```
dumpsys jobscheduler
dumpsys alarm
```

應用待機

應用待機通過延遲後台網絡活動和用戶不活躍使用的應用的作業來延長電池壽命。

應用待機生命週期

該平台檢測不活動的應用程序並將其置於應用程序待機狀態，直到用戶開始主動使用該應用程序。

在檢測階段，當設備未充電並且用戶在特定的時鐘時間以及特定的屏幕開啟時間內沒有直接或間接啟動應用程序時，平台會檢測到應用程序處於非活動狀態. （當前台應用程序訪問第二個應用程序中的服務時，會發生間接啟動。）

在應用待機期間，平台會阻止應用每天多次訪問網絡，從而推遲應用同步和其他工作。

平台在以下情況下退出應用程序：

應用程序變為活動狀態。
設備已插入並正在充電。

活動應用不受應用待機的影響。應用程序在以下情況下處於活動狀態：

當前處於前台的進程（作為活動或前台服務，或正在被另一個活動或前台服務使用），例如通知偵聽器、無障礙服務、動態壁紙等。
用戶查看的通知，例如在鎖定屏幕或通知托盤中
由用戶明確啟動

如果在一段時間內沒有發生上述任何活動，則應用程序處於非活動狀態。

測試應用待機

您可以使用以下adb命令手動測試應用待機：

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