Add infra for battery tip

This cl adds the basic structure for battery tip: 1. BaseBatteryTip: Model class to represent the tip and build preference and dialog 2. SummaryTip: Display a general battery summary(i.e. your battery is good..) 3. BatteryTipLoader: AsyncLoader to load the battery tips. 4. BatteryTipPreferenceController: preference controller for preference group to display battery tips This cl also: 1. Remove the anomaly code in PowerUsageSummary and we will add it to app restriction in future. 2. Add preference_category_no_title.xml to avoid the extra 32dp blank at the top. Bug: 70570352 Test: RunSettingsRoboTests Change-Id: If91a553888e2eb91d55fb1d0d7bbea69652f144c
2017-12-12 12:52:35 -08:00
parent 444989ad35
commit fde63fc351
13 changed files with 700 additions and 65 deletions
--- a/src/com/android/settings/fuelgauge/batterytip/tips/BatteryTip.java
+++ b/src/com/android/settings/fuelgauge/batterytip/tips/BatteryTip.java
@@ -0,0 +1,117 @@
+/*
+ * Copyright (C) 2017 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.android.settings.fuelgauge.batterytip.tips;
+
+import android.app.Dialog;
+import android.content.Context;
+import android.support.annotation.IdRes;
+import android.support.annotation.IntDef;
+import android.support.v7.preference.Preference;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+
+/**
+ * Base model for a battery tip(e.g. suggest user to turn on battery saver)
+ *
+ * Each {@link BatteryTip} contains basic data(e.g. title, summary, icon) as well as the
+ * pre-defined action(e.g. turn on battery saver)
+ */
+public abstract class BatteryTip {
+    @Retention(RetentionPolicy.SOURCE)
+    @IntDef({StateType.NEW,
+            StateType.HANDLED,
+            StateType.INVISIBLE})
+    public @interface StateType {
+        int NEW = 0;
+        int HANDLED = 1;
+        int INVISIBLE = 2;
+    }
+
+    @Retention(RetentionPolicy.SOURCE)
+    @IntDef({TipType.SUMMARY,
+            TipType.BATTERY_SAVER,
+            TipType.HIGH_DEVICE_USAGE,
+            TipType.SMART_BATTERY_MANAGER,
+            TipType.APP_RESTRICTION,
+            TipType.REDUCED_BATTERY,
+            TipType.LOW_BATTERY})
+    public @interface TipType {
+        int SUMMARY = 0;
+        int BATTERY_SAVER = 1;
+        int HIGH_DEVICE_USAGE = 2;
+        int SMART_BATTERY_MANAGER = 3;
+        int APP_RESTRICTION = 4;
+        int REDUCED_BATTERY = 5;
+        int LOW_BATTERY = 6;
+    }
+
+    private static final String KEY_PREFIX = "key_battery_tip";
+
+    @TipType
+    protected int mType;
+    @StateType
+    protected int mState;
+    protected boolean mShowDialog;
+
+    public abstract CharSequence getTitle(Context context);
+
+    public abstract CharSequence getSummary(Context context);
+
+    @IdRes
+    public abstract int getIconId();
+
+    /**
+     * Update the current {@link #mState} using the new {@code tip}.
+     * @param tip used to update
+     */
+    public abstract void updateState(BatteryTip tip);
+
+    /**
+     * Execute the action for this {@link BatteryTip}
+     */
+    public abstract void action();
+
+    /**
+     * Build the dialog to display either the info about {@link BatteryTip} or confirmation
+     * about the action.
+     */
+    public abstract Dialog buildDialog();
+
+    public Preference buildPreference(Context context) {
+        Preference preference = new Preference(context);
+
+        preference.setKey(getKey());
+        preference.setTitle(getTitle(context));
+        preference.setSummary(getSummary(context));
+        preference.setIcon(getIconId());
+        return preference;
+    }
+
+    public boolean shouldShowDialog() {
+        return mShowDialog;
+    }
+
+    public String getKey() {
+        return KEY_PREFIX + mType;
+    }
+
+    @StateType
+    public int getState() {
+        return mState;
+    }
+}