Fix the logic used that determines whether the automatic time
zone detection toggle is available in the Settings UI Date & Time
screen. Also, ensure that the TimeZonePreferenceController uses correct
logic for whether the user can manually enter a time zone.
This change migrates the controllers to use a existing high-level
TimeManager API rather than (incorrectly) duplicating in Settings UI the
logic for whether time zone detection is supported / enabled.
Without this change, WiFi-only devices _with_ location-based time zone
detection enabled would incorrectly hide the "auto time zone" toggle,
which would have the knock-on of making it look like the user is allowed
to enter a time zone manually when they aren't (because it is
enabled/disabled based on the presence of the toggle).
That toggle still needs to be present while there is a possible time
zone detection mechanism. All the (quite complex) logic around this is
already considered by the TimeManager API.
Possible side effects:
This change decouples the "does the toggle show true or false?"
(isEnabled()) from the "should the toggle be shown at all?"
(isAvailable()) logic by removing a call to isAvailable() inside of
isEnabled(). This is to avoid making multiple (probably more expensive
than what it was doing before) calls to the time_zone_detector service,
and avoid the extra complexity of caching / cache invalidation that
would be needed to mitigate it. Previously, as a result of the call to
isAvailable(), isEnabled() would always return false when mIsFromSUW is
true, but now it will return the underlying value of the device's
auto_time_zone setting. This means that if the UI is changed in future
to render a visible-but-can't-be-changed-by-the-user toggle for auto
time zone, it will display the current setting value, which is perfectly
reasonable. It is assumed it will have no other side effects.
The AutoTimeZonePreferenceControllerTest.isFromSUW_notEnable test has
been changed to reflect the change in behavior. Various name changes
made to tests to reflect the new behavior.
Bug: 228247623
Bug: 186625820
Bug: 172891783
Test: treehugger
Test: Manual test on a device with telephony
Test: m ROBOTEST_FILTER=AutoTimeZonePreferenceControllerTest RunSettingsRoboTests -j40
Test: m ROBOTEST_FILTER=TimeZonePreferenceControllerTest RunSettingsRoboTests -j40
Change-Id: I4c7608e8645eee5994c8ecf85a14a27d3278ac04
(cherry picked from commit 7a8ac683d4
)
235 lines
9.8 KiB
Java
235 lines
9.8 KiB
Java
/*
|
|
* Copyright (C) 2016 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.datetime;
|
|
|
|
import static com.google.common.truth.Truth.assertThat;
|
|
|
|
import static org.mockito.Mockito.spy;
|
|
import static org.mockito.Mockito.verify;
|
|
import static org.mockito.Mockito.when;
|
|
|
|
import android.app.time.Capabilities;
|
|
import android.app.time.TimeManager;
|
|
import android.app.time.TimeZoneCapabilities;
|
|
import android.app.time.TimeZoneCapabilitiesAndConfig;
|
|
import android.app.time.TimeZoneConfiguration;
|
|
import android.content.Context;
|
|
import android.os.UserHandle;
|
|
|
|
import androidx.preference.Preference;
|
|
|
|
import org.junit.Before;
|
|
import org.junit.Test;
|
|
import org.junit.runner.RunWith;
|
|
import org.mockito.Mock;
|
|
import org.mockito.Mockito;
|
|
import org.mockito.MockitoAnnotations;
|
|
import org.robolectric.RobolectricTestRunner;
|
|
import org.robolectric.RuntimeEnvironment;
|
|
|
|
@RunWith(RobolectricTestRunner.class)
|
|
public class AutoTimeZonePreferenceControllerTest {
|
|
|
|
@Mock
|
|
private UpdateTimeAndDateCallback mCallback;
|
|
@Mock
|
|
private Context mContext;
|
|
private AutoTimeZonePreferenceController mController;
|
|
private Preference mPreference;
|
|
@Mock
|
|
private TimeManager mTimeManager;
|
|
|
|
@Before
|
|
public void setUp() {
|
|
MockitoAnnotations.initMocks(this);
|
|
mContext = spy(RuntimeEnvironment.application);
|
|
|
|
mPreference = new Preference(mContext);
|
|
|
|
when(mContext.getSystemService(TimeManager.class)).thenReturn(mTimeManager);
|
|
}
|
|
|
|
@Test
|
|
public void isFromSUW_notAvailable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, true /* isFromSUW */);
|
|
|
|
assertThat(mController.isAvailable()).isFalse();
|
|
}
|
|
|
|
@Test
|
|
public void notFromSUW_isAvailable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, false /* isFromSUW */);
|
|
|
|
assertThat(mController.isAvailable()).isTrue();
|
|
}
|
|
|
|
@Test
|
|
public void autoTimeZoneNotSupported_notAvailable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */false, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, false /* fromSUW */);
|
|
|
|
assertThat(mController.isAvailable()).isFalse();
|
|
}
|
|
|
|
@Test
|
|
public void isFromSUW_notEnable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */false, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, true /* fromSUW */);
|
|
|
|
assertThat(mController.isEnabled()).isFalse();
|
|
}
|
|
|
|
@Test
|
|
public void isFromSUW_isEnable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */false, /* autoEnabled= */true);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, true /* fromSUW */);
|
|
|
|
assertThat(mController.isEnabled()).isTrue();
|
|
}
|
|
|
|
@Test
|
|
public void autoTimeZoneNotSupported_notEnable() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */false, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, false /* fromSUW */);
|
|
|
|
assertThat(mController.isEnabled()).isFalse();
|
|
}
|
|
|
|
@Test
|
|
public void testIsEnabled_shouldReadFromTimeManagerConfig() {
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, null /* callback */, false /* fromSUW */);
|
|
|
|
{
|
|
// Disabled
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
assertThat(mController.isEnabled()).isFalse();
|
|
}
|
|
|
|
{
|
|
// Enabled
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */true);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
|
|
assertThat(mController.isEnabled()).isTrue();
|
|
}
|
|
}
|
|
|
|
@Test
|
|
public void updatePreferenceChange_prefIsChecked_shouldUpdatePreferenceAndNotifyCallback() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
when(mTimeManager.updateTimeZoneConfiguration(Mockito.any())).thenReturn(true);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, mCallback, false /* fromSUW */);
|
|
|
|
assertThat(mController.onPreferenceChange(mPreference, true)).isTrue();
|
|
verify(mCallback).updateTimeAndDateDisplay(mContext);
|
|
|
|
// Check the service was asked to change the configuration correctly.
|
|
TimeZoneConfiguration timeZoneConfiguration = new TimeZoneConfiguration.Builder()
|
|
.setAutoDetectionEnabled(true)
|
|
.build();
|
|
verify(mTimeManager).updateTimeZoneConfiguration(timeZoneConfiguration);
|
|
|
|
// Update the mTimeManager mock so that it now returns the expected updated config.
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfigAfterUpdate =
|
|
createCapabilitiesAndConfig(/* autoSupported= */true, /* autoEnabled= */true);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig())
|
|
.thenReturn(capabilitiesAndConfigAfterUpdate);
|
|
|
|
assertThat(mController.isEnabled()).isTrue();
|
|
}
|
|
|
|
@Test
|
|
public void updatePreferenceChange_prefIsUnchecked_shouldUpdatePreferenceAndNotifyCallback() {
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfig = createCapabilitiesAndConfig(
|
|
/* autoSupported= */true, /* autoEnabled= */true);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig()).thenReturn(capabilitiesAndConfig);
|
|
when(mTimeManager.updateTimeZoneConfiguration(Mockito.any())).thenReturn(true);
|
|
|
|
mController = new AutoTimeZonePreferenceController(
|
|
mContext, mCallback, false /* fromSUW */);
|
|
|
|
assertThat(mController.onPreferenceChange(mPreference, false)).isTrue();
|
|
verify(mCallback).updateTimeAndDateDisplay(mContext);
|
|
|
|
// Check the service was asked to change the configuration correctly.
|
|
TimeZoneConfiguration timeZoneConfiguration = new TimeZoneConfiguration.Builder()
|
|
.setAutoDetectionEnabled(false)
|
|
.build();
|
|
verify(mTimeManager).updateTimeZoneConfiguration(timeZoneConfiguration);
|
|
|
|
// Update the mTimeManager mock so that it now returns the expected updated config.
|
|
TimeZoneCapabilitiesAndConfig capabilitiesAndConfigAfterUpdate =
|
|
createCapabilitiesAndConfig(/* autoSupported= */true, /* autoEnabled= */false);
|
|
when(mTimeManager.getTimeZoneCapabilitiesAndConfig())
|
|
.thenReturn(capabilitiesAndConfigAfterUpdate);
|
|
|
|
assertThat(mController.isEnabled()).isFalse();
|
|
}
|
|
|
|
private static TimeZoneCapabilitiesAndConfig createCapabilitiesAndConfig(
|
|
boolean autoSupported, boolean autoEnabled) {
|
|
int configureAutoDetectionEnabledCapability =
|
|
autoSupported ? Capabilities.CAPABILITY_POSSESSED
|
|
: Capabilities.CAPABILITY_NOT_SUPPORTED;
|
|
TimeZoneCapabilities capabilities = new TimeZoneCapabilities.Builder(UserHandle.SYSTEM)
|
|
.setConfigureAutoDetectionEnabledCapability(configureAutoDetectionEnabledCapability)
|
|
.setConfigureGeoDetectionEnabledCapability(Capabilities.CAPABILITY_NOT_SUPPORTED)
|
|
.setSuggestManualTimeZoneCapability(Capabilities.CAPABILITY_POSSESSED)
|
|
.build();
|
|
TimeZoneConfiguration config = new TimeZoneConfiguration.Builder()
|
|
.setAutoDetectionEnabled(autoEnabled)
|
|
.setGeoDetectionEnabled(false)
|
|
.build();
|
|
return new TimeZoneCapabilitiesAndConfig(capabilities, config);
|
|
}
|
|
}
|