This is a no-op refactor. This change makes the Catalyst migration of battery level bar easy. Bug: 372774754 Test: manual Flag: EXEMPT bug fix Change-Id: I6e64e6d9b34aeca584f4d4e951c58c3e1b361f9d
492 lines
20 KiB
Java
492 lines
20 KiB
Java
/*
|
|
* Copyright (C) 2024 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;
|
|
|
|
import static com.google.common.truth.Truth.assertThat;
|
|
|
|
import static org.mockito.ArgumentMatchers.any;
|
|
import static org.mockito.ArgumentMatchers.eq;
|
|
import static org.mockito.Mockito.doReturn;
|
|
import static org.mockito.Mockito.never;
|
|
import static org.mockito.Mockito.spy;
|
|
import static org.mockito.Mockito.verify;
|
|
import static org.mockito.Mockito.verifyNoInteractions;
|
|
import static org.mockito.Mockito.when;
|
|
|
|
import android.content.Context;
|
|
import android.content.Intent;
|
|
import android.hardware.usb.UsbManager;
|
|
import android.hardware.usb.UsbPort;
|
|
import android.hardware.usb.UsbPortStatus;
|
|
import android.os.BatteryManager;
|
|
import android.os.PowerManager;
|
|
import android.os.SystemProperties;
|
|
|
|
import androidx.preference.PreferenceScreen;
|
|
|
|
import com.android.settings.core.BasePreferenceController;
|
|
import com.android.settings.fuelgauge.batterytip.tips.BatteryTip;
|
|
import com.android.settings.fuelgauge.batterytip.tips.LowBatteryTip;
|
|
import com.android.settings.fuelgauge.batterytip.tips.SmartBatteryTip;
|
|
import com.android.settings.testutils.BatteryTestUtils;
|
|
import com.android.settings.testutils.FakeFeatureFactory;
|
|
import com.android.settings.testutils.shadow.ShadowEntityHeaderController;
|
|
import com.android.settings.testutils.shadow.ShadowUtils;
|
|
import com.android.settings.widget.EntityHeaderController;
|
|
import com.android.settingslib.fuelgauge.BatteryUtils;
|
|
|
|
import org.junit.After;
|
|
import org.junit.Before;
|
|
import org.junit.Test;
|
|
import org.junit.runner.RunWith;
|
|
import org.mockito.Mock;
|
|
import org.mockito.MockitoAnnotations;
|
|
import org.robolectric.RobolectricTestRunner;
|
|
import org.robolectric.RuntimeEnvironment;
|
|
import org.robolectric.Shadows;
|
|
import org.robolectric.annotation.Config;
|
|
import org.robolectric.shadows.ShadowPowerManager;
|
|
|
|
@RunWith(RobolectricTestRunner.class)
|
|
@Config(shadows = {ShadowEntityHeaderController.class, ShadowUtils.class})
|
|
public class BatteryHeaderTextPreferenceControllerTest {
|
|
|
|
private static final String PREF_KEY = "battery_header_text";
|
|
private static final int BATTERY_LEVEL = 60;
|
|
private static final String TIME_LEFT = "2h30min";
|
|
private static final String BATTERY_STATUS = "Charging";
|
|
|
|
@Mock private PreferenceScreen mPreferenceScreen;
|
|
@Mock private BatteryInfo mBatteryInfo;
|
|
@Mock private EntityHeaderController mEntityHeaderController;
|
|
@Mock private BatteryHeaderTextPreference mBatteryHeaderTextPreference;
|
|
@Mock private BatteryStatusFeatureProvider mBatteryStatusFeatureProvider;
|
|
@Mock private UsbPort mUsbPort;
|
|
@Mock private UsbManager mUsbManager;
|
|
@Mock private UsbPortStatus mUsbPortStatus;
|
|
|
|
private BatteryHeaderTextPreferenceController mController;
|
|
private Context mContext;
|
|
private ShadowPowerManager mShadowPowerManager;
|
|
private Intent mBatteryIntent;
|
|
private FakeFeatureFactory mFactory;
|
|
|
|
@Before
|
|
public void setUp() {
|
|
MockitoAnnotations.initMocks(this);
|
|
|
|
mContext = spy(RuntimeEnvironment.application);
|
|
when(mContext.getSystemService(UsbManager.class)).thenReturn(mUsbManager);
|
|
ShadowEntityHeaderController.setUseMock(mEntityHeaderController);
|
|
|
|
mBatteryIntent = new Intent();
|
|
mBatteryIntent.putExtra(BatteryManager.EXTRA_LEVEL, BATTERY_LEVEL);
|
|
mBatteryIntent.putExtra(BatteryManager.EXTRA_SCALE, 100);
|
|
mBatteryIntent.putExtra(BatteryManager.EXTRA_PLUGGED, 1);
|
|
doReturn(mBatteryIntent).when(mContext).registerReceiver(any(), any());
|
|
|
|
doReturn(mBatteryHeaderTextPreference)
|
|
.when(mPreferenceScreen)
|
|
.findPreference(PREF_KEY);
|
|
|
|
mBatteryInfo.batteryLevel = BATTERY_LEVEL;
|
|
|
|
mShadowPowerManager = Shadows.shadowOf(mContext.getSystemService(PowerManager.class));
|
|
mFactory = FakeFeatureFactory.setupForTest();
|
|
|
|
mController = spy(new BatteryHeaderTextPreferenceController(mContext, PREF_KEY));
|
|
mController.mBatteryHeaderTextPreference = mBatteryHeaderTextPreference;
|
|
mController.mBatteryStatusFeatureProvider = mBatteryStatusFeatureProvider;
|
|
|
|
BatteryUtils.setChargingStringV2Enabled(null);
|
|
}
|
|
|
|
@After
|
|
public void tearDown() {
|
|
ShadowEntityHeaderController.reset();
|
|
ShadowUtils.reset();
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_hasRemainingTime_showRemainingLabel() {
|
|
mBatteryInfo.remainingLabel = TIME_LEFT;
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mBatteryInfo.remainingLabel);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_updateBatteryInfo() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mBatteryInfo.remainingLabel);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_noRemainingTime_showStatusLabel() {
|
|
mBatteryInfo.remainingLabel = null;
|
|
mBatteryInfo.statusLabel = BATTERY_STATUS;
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(BATTERY_STATUS);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_statusAnomalous_showStatusLabel() {
|
|
mBatteryInfo.remainingLabel = TIME_LEFT;
|
|
mBatteryInfo.statusLabel = BATTERY_STATUS;
|
|
mBatteryInfo.batteryStatus = BatteryManager.BATTERY_STATUS_NOT_CHARGING;
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(BATTERY_STATUS);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_charging_showFullText() {
|
|
setChargingState(/* isDischarging */ false, /* updatedByStatusFeature */ false);
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
final String expectedResult = BATTERY_STATUS + " • " + TIME_LEFT;
|
|
verify(mBatteryHeaderTextPreference).setText(expectedResult);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_powerSaverOn_showPowerSaverOn() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
mShadowPowerManager.setIsPowerSaveMode(true);
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
final String expectedResult = "Battery Saver on • " + TIME_LEFT;
|
|
verify(mBatteryHeaderTextPreference).setText(expectedResult);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_triggerBatteryStatusUpdateFalse_updateBatteryInfo() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mBatteryInfo.remainingLabel);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_nullLabel_updateSummaryOnly() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
|
|
mController.updateBatteryStatus(null, mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mBatteryInfo.remainingLabel);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_withLabel_showLabelText() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
|
|
final String label = "Update by battery status • " + TIME_LEFT;
|
|
mController.updateBatteryStatus(label, mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(label);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_chargingString_statusWithRemainingLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "1 hr, 40 min left until full",
|
|
/* statusLabel= */ "Charging rapidly",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ false);
|
|
var expectedChargingString = batteryInfo.statusLabel + " • " + batteryInfo.remainingLabel;
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_chargingStringV2FastCharging_statusWithRemainingLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Full by 1:30 PM",
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
var expectedChargingString = batteryInfo.statusLabel + " • " + batteryInfo.remainingLabel;
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_chargingStringV2NonFastCharging_remainingLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Fully charged by 11:10 PM",
|
|
/* statusLabel= */ "Charging",
|
|
/* isFastCharging= */ false,
|
|
/* isChargingStringV2= */ true);
|
|
var expectedChargingString = batteryInfo.remainingLabel;
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_customizedWirelessChargingLabel_customizedLabel() {
|
|
var label = "Customized Wireless Charging Label";
|
|
var contentDescription = "Customized Wireless Charging description";
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Full by 1:30 PM",
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
batteryInfo.pluggedStatus = BatteryManager.BATTERY_PLUGGED_WIRELESS;
|
|
when(mFactory.batterySettingsFeatureProvider.getWirelessChargingLabel(
|
|
eq(mContext), any(BatteryInfo.class)))
|
|
.thenReturn(label);
|
|
when(mFactory.batterySettingsFeatureProvider.getWirelessChargingContentDescription(
|
|
eq(mContext), any(BatteryInfo.class)))
|
|
.thenReturn(contentDescription);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(label);
|
|
verify(mBatteryHeaderTextPreference).setContentDescription(contentDescription);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_noCustomizedWirelessChargingLabel_statusWithRemainingLabel() {
|
|
var contentDescription = "Customized Wireless Charging description";
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Full by 1:30 PM",
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
batteryInfo.pluggedStatus = BatteryManager.BATTERY_PLUGGED_WIRELESS;
|
|
var expectedChargingString = batteryInfo.statusLabel + " • " + batteryInfo.remainingLabel;
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
verify(mBatteryHeaderTextPreference, never()).setContentDescription(contentDescription);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_noCustomizedWirelessChargingLabel_v1StatusWithRemainingLabel() {
|
|
var contentDescription = "Customized Wireless Charging description";
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "1 hr, 40 min left until full",
|
|
/* statusLabel= */ "Charging wirelessly",
|
|
/* isFastCharging= */ false,
|
|
/* isChargingStringV2= */ false);
|
|
batteryInfo.pluggedStatus = BatteryManager.BATTERY_PLUGGED_WIRELESS;
|
|
var expectedChargingString = batteryInfo.statusLabel + " • " + batteryInfo.remainingLabel;
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
verify(mBatteryHeaderTextPreference, never()).setContentDescription(contentDescription);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_chargingOptimizationMode_remainingLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Expected remaining label",
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
var expectedChargingString = batteryInfo.remainingLabel;
|
|
when(mFactory.batterySettingsFeatureProvider.isChargingOptimizationMode(mContext))
|
|
.thenReturn(true);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_chargingOptimizationModeNoRemainingLabel_statusLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ null,
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
var expectedChargingString = batteryInfo.statusLabel;
|
|
when(mFactory.batterySettingsFeatureProvider.isChargingOptimizationMode(mContext))
|
|
.thenReturn(true);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_notChargingOptimizationMode_statusWithRemainingLabel() {
|
|
var batteryInfo =
|
|
arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
/* remainingLabel= */ "Full by 1:30 PM",
|
|
/* statusLabel= */ "Fast Charging",
|
|
/* isFastCharging= */ true,
|
|
/* isChargingStringV2= */ true);
|
|
var expectedChargingString = batteryInfo.statusLabel + " • " + batteryInfo.remainingLabel;
|
|
when(mFactory.batterySettingsFeatureProvider.isChargingOptimizationMode(mContext))
|
|
.thenReturn(false);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, batteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expectedChargingString);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_dockDefend_chargingOnHold() {
|
|
var expected = "Charging on hold";
|
|
mBatteryInfo.isBatteryDefender = false;
|
|
when(mFactory.powerUsageFeatureProvider.isExtraDefend()).thenReturn(true);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expected);
|
|
}
|
|
|
|
@Test
|
|
public void updateBatteryStatus_batteryDefender_chargingOnHold() {
|
|
var expected = "Charging on hold";
|
|
mBatteryInfo.isBatteryDefender = true;
|
|
when(mFactory.powerUsageFeatureProvider.isExtraDefend()).thenReturn(false);
|
|
|
|
mController.updateBatteryStatus(/* label= */ null, mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(expected);
|
|
}
|
|
|
|
private BatteryInfo arrangeUpdateBatteryStatusTestWithRemainingLabel(
|
|
String remainingLabel,
|
|
String statusLabel,
|
|
boolean isFastCharging,
|
|
boolean isChargingStringV2) {
|
|
SystemProperties.set(
|
|
BatteryUtils.PROPERTY_CHARGING_STRING_V2_KEY, String.valueOf(isChargingStringV2));
|
|
mBatteryInfo.isBatteryDefender = false;
|
|
mBatteryInfo.remainingLabel = remainingLabel;
|
|
mBatteryInfo.statusLabel = statusLabel;
|
|
mBatteryInfo.discharging = false;
|
|
mBatteryInfo.isFastCharging = isFastCharging;
|
|
return mBatteryInfo;
|
|
}
|
|
|
|
@Test
|
|
public void updateHeaderByBatteryTips_lowBatteryTip_showLowBattery() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
BatteryTip lowBatteryTip =
|
|
new LowBatteryTip(BatteryTip.StateType.NEW, /* powerSaveModeOn */ false);
|
|
|
|
mController.updateHeaderByBatteryTips(lowBatteryTip, mBatteryInfo);
|
|
|
|
final String expectedResult = "Low battery • " + TIME_LEFT;
|
|
verify(mBatteryHeaderTextPreference).setText(expectedResult);
|
|
}
|
|
|
|
@Test
|
|
public void updateHeaderByBatteryTips_notLowBatteryTip_showRemainingLabel() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
BatteryTip lowBatteryTip = new SmartBatteryTip(BatteryTip.StateType.NEW);
|
|
|
|
mController.updateHeaderByBatteryTips(lowBatteryTip, mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mBatteryInfo.remainingLabel);
|
|
}
|
|
|
|
@Test
|
|
public void updateHeaderByBatteryTips_noTip_noAction() {
|
|
setChargingState(/* isDischarging */ true, /* updatedByStatusFeature */ false);
|
|
|
|
mController.updateHeaderByBatteryTips(null, mBatteryInfo);
|
|
|
|
verifyNoInteractions(mBatteryHeaderTextPreference);
|
|
}
|
|
|
|
@Test
|
|
public void updateHeaderByBatteryTips_noBatteryInfo_noAction() {
|
|
BatteryTip lowBatteryTip =
|
|
new LowBatteryTip(BatteryTip.StateType.NEW, /* powerSaveModeOn */ false);
|
|
|
|
mController.updateHeaderByBatteryTips(lowBatteryTip, null);
|
|
|
|
verifyNoInteractions(mBatteryHeaderTextPreference);
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_isBatteryDefender_showEmptyText() {
|
|
mBatteryInfo.isBatteryDefender = true;
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference).setText(mContext.getString(
|
|
com.android.settingslib.R.string
|
|
.battery_info_status_charging_on_hold));
|
|
}
|
|
|
|
@Test
|
|
public void updatePreference_incompatibleCharger_showNotChargingState() {
|
|
BatteryTestUtils.setupIncompatibleEvent(mUsbPort, mUsbManager, mUsbPortStatus);
|
|
|
|
mController.updateHeaderPreference(mBatteryInfo);
|
|
|
|
verify(mBatteryHeaderTextPreference)
|
|
.setText(
|
|
mContext.getString(
|
|
com.android.settingslib.R.string.battery_info_status_not_charging));
|
|
}
|
|
|
|
@Test
|
|
public void getAvailabilityStatus_returnAvailableUnsearchable() {
|
|
assertThat(mController.getAvailabilityStatus())
|
|
.isEqualTo(BasePreferenceController.AVAILABLE_UNSEARCHABLE);
|
|
}
|
|
|
|
@Test
|
|
public void displayPreference_batteryNotPresent_isInvisible() {
|
|
ShadowUtils.setIsBatteryPresent(false);
|
|
|
|
mController.displayPreference(mPreferenceScreen);
|
|
|
|
assertThat(mBatteryHeaderTextPreference.isVisible()).isFalse();
|
|
}
|
|
|
|
private void setChargingState(boolean isDischarging, boolean updatedByStatusFeature) {
|
|
mBatteryInfo.remainingLabel = TIME_LEFT;
|
|
mBatteryInfo.statusLabel = BATTERY_STATUS;
|
|
mBatteryInfo.discharging = isDischarging;
|
|
|
|
when(mBatteryStatusFeatureProvider.triggerBatteryStatusUpdate(mController, mBatteryInfo))
|
|
.thenReturn(updatedByStatusFeature);
|
|
}
|
|
}
|