From 794c7e29043da4f5efeeb803a6095fefb8294ff1 Mon Sep 17 00:00:00 2001 From: Arc Wang Date: Thu, 31 Dec 2020 13:58:52 +0800 Subject: [PATCH] Add UsageProgressBarPreference This preference contains an usage summary and a total summary and a horizontal progress bar. The number of usage summary will show with enlarged font size. Bug: 174964885 Test: atest UsageProgressBarPreferenceTest Change-Id: I97fc27ac2b8d08202e776713bc035bd9b80bbbbc --- packages/SettingsLib/Android.bp | 1 + .../UsageProgressBarPreference/Android.bp | 13 ++ .../AndroidManifest.xml | 23 +++ .../layout/preference_usage_progress_bar.xml | 61 +++++++ .../widget/UsageProgressBarPreference.java | 160 ++++++++++++++++++ packages/SettingsLib/tests/integ/Android.bp | 2 + .../UsageProgressBarPreferenceTest.java | 100 +++++++++++ 7 files changed, 360 insertions(+) create mode 100644 packages/SettingsLib/UsageProgressBarPreference/Android.bp create mode 100644 packages/SettingsLib/UsageProgressBarPreference/AndroidManifest.xml create mode 100644 packages/SettingsLib/UsageProgressBarPreference/res/layout/preference_usage_progress_bar.xml create mode 100644 packages/SettingsLib/UsageProgressBarPreference/src/com/android/settingslib/widget/UsageProgressBarPreference.java create mode 100644 packages/SettingsLib/tests/integ/src/com/android/settingslib/widget/UsageProgressBarPreferenceTest.java diff --git a/packages/SettingsLib/Android.bp b/packages/SettingsLib/Android.bp index 3834162219011..0d4e7460c21ff 100644 --- a/packages/SettingsLib/Android.bp +++ b/packages/SettingsLib/Android.bp @@ -56,6 +56,7 @@ java_defaults { "SettingsLibTopIntroPreference", "SettingsLibBannerMessagePreference", "SettingsLibFooterPreference", + "SettingsLibUsageProgressBarPreference", ], } diff --git a/packages/SettingsLib/UsageProgressBarPreference/Android.bp b/packages/SettingsLib/UsageProgressBarPreference/Android.bp new file mode 100644 index 0000000000000..f346a5962d1c5 --- /dev/null +++ b/packages/SettingsLib/UsageProgressBarPreference/Android.bp @@ -0,0 +1,13 @@ +android_library { + name: "SettingsLibUsageProgressBarPreference", + + srcs: ["src/**/*.java"], + resource_dirs: ["res"], + + static_libs: [ + "androidx.preference_preference", + ], + + sdk_version: "system_current", + min_sdk_version: "21", +} diff --git a/packages/SettingsLib/UsageProgressBarPreference/AndroidManifest.xml b/packages/SettingsLib/UsageProgressBarPreference/AndroidManifest.xml new file mode 100644 index 0000000000000..51fc7ed646602 --- /dev/null +++ b/packages/SettingsLib/UsageProgressBarPreference/AndroidManifest.xml @@ -0,0 +1,23 @@ + + + + + + + + diff --git a/packages/SettingsLib/UsageProgressBarPreference/res/layout/preference_usage_progress_bar.xml b/packages/SettingsLib/UsageProgressBarPreference/res/layout/preference_usage_progress_bar.xml new file mode 100644 index 0000000000000..9dbd5fa4b2d2b --- /dev/null +++ b/packages/SettingsLib/UsageProgressBarPreference/res/layout/preference_usage_progress_bar.xml @@ -0,0 +1,61 @@ + + + + + + + + + + + + diff --git a/packages/SettingsLib/UsageProgressBarPreference/src/com/android/settingslib/widget/UsageProgressBarPreference.java b/packages/SettingsLib/UsageProgressBarPreference/src/com/android/settingslib/widget/UsageProgressBarPreference.java new file mode 100644 index 0000000000000..950a8b4ad7cc4 --- /dev/null +++ b/packages/SettingsLib/UsageProgressBarPreference/src/com/android/settingslib/widget/UsageProgressBarPreference.java @@ -0,0 +1,160 @@ +/* + * Copyright (C) 2021 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.settingslib.widget; + +import android.content.Context; +import android.text.SpannableString; +import android.text.Spanned; +import android.text.TextUtils; +import android.text.style.RelativeSizeSpan; +import android.util.AttributeSet; +import android.widget.ProgressBar; +import android.widget.TextView; + +import androidx.preference.Preference; +import androidx.preference.PreferenceViewHolder; + +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +/** + * Progres bar preference with a usage summary and a total summary. + * This preference shows number in usage summary with enlarged font size. + */ +public class UsageProgressBarPreference extends Preference { + + private final Pattern mNumberPattern = Pattern.compile("[\\d]*\\.?[\\d]+"); + + private CharSequence mUsageSummary; + private CharSequence mTotalSummary; + private int mPercent = -1; + + /** + * Perform inflation from XML and apply a class-specific base style. + * + * @param context The {@link Context} this is associated with, through which it can + * access the current theme, resources, {@link SharedPreferences}, etc. + * @param attrs The attributes of the XML tag that is inflating the preference + * @param defStyle An attribute in the current theme that contains a reference to a style + * resource that supplies default values for the view. Can be 0 to not + * look for defaults. + */ + public UsageProgressBarPreference(Context context, AttributeSet attrs, int defStyle) { + super(context, attrs, defStyle); + setLayoutResource(R.layout.preference_usage_progress_bar); + } + + /** + * Perform inflation from XML and apply a class-specific base style. + * + * @param context The {@link Context} this is associated with, through which it can + * access the current theme, resources, {@link SharedPreferences}, etc. + * @param attrs The attributes of the XML tag that is inflating the preference + */ + public UsageProgressBarPreference(Context context, AttributeSet attrs) { + super(context, attrs); + setLayoutResource(R.layout.preference_usage_progress_bar); + } + + /** + * Constructor to create a preference. + * + * @param context The Context this is associated with. + */ + public UsageProgressBarPreference(Context context) { + this(context, null); + } + + /** Set usage summary, number in the summary will show with enlarged font size. */ + public void setUsageSummary(CharSequence usageSummary) { + if (TextUtils.equals(mUsageSummary, usageSummary)) { + return; + } + mUsageSummary = usageSummary; + notifyChanged(); + } + + /** Set total summary. */ + public void setTotalSummary(CharSequence totalSummary) { + if (TextUtils.equals(mTotalSummary, totalSummary)) { + return; + } + mTotalSummary = totalSummary; + notifyChanged(); + } + + /** Set percentage of the progress bar. */ + public void setPercent(long usage, long total) { + if (total == 0L || usage > total) { + return; + } + final int percent = (int) (usage / (double) total * 100); + if (mPercent == percent) { + return; + } + mPercent = percent; + notifyChanged(); + } + + /** + * Binds the created View to the data for this preference. + * + *

This is a good place to grab references to custom Views in the layout and set + * properties on them. + * + *

Make sure to call through to the superclass's implementation. + * + * @param holder The ViewHolder that provides references to the views to fill in. These views + * will be recycled, so you should not hold a reference to them after this method + * returns. + */ + @Override + public void onBindViewHolder(PreferenceViewHolder holder) { + super.onBindViewHolder(holder); + + final TextView usageSummary = (TextView) holder.findViewById(R.id.usage_summary); + usageSummary.setText(enlargeFontOfNumber(mUsageSummary)); + + final TextView totalSummary = (TextView) holder.findViewById(R.id.total_summary); + if (mTotalSummary != null) { + totalSummary.setText(mTotalSummary); + } + + final ProgressBar progressBar = (ProgressBar) holder.findViewById(android.R.id.progress); + if (mPercent < 0) { + progressBar.setIndeterminate(true); + } else { + progressBar.setIndeterminate(false); + progressBar.setProgress(mPercent); + } + } + + private CharSequence enlargeFontOfNumber(CharSequence summary) { + if (TextUtils.isEmpty(summary)) { + return ""; + } + + final Matcher matcher = mNumberPattern.matcher(summary); + if (matcher.find()) { + final SpannableString spannableSummary = new SpannableString(summary); + spannableSummary.setSpan(new RelativeSizeSpan(2.4f), matcher.start(), + matcher.end(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE); + return spannableSummary; + } + return summary; + } +} diff --git a/packages/SettingsLib/tests/integ/Android.bp b/packages/SettingsLib/tests/integ/Android.bp index 2ccff1ecaf6cd..f6f9dba784a04 100644 --- a/packages/SettingsLib/tests/integ/Android.bp +++ b/packages/SettingsLib/tests/integ/Android.bp @@ -33,10 +33,12 @@ android_test { test_suites: ["device-tests"], static_libs: [ + "androidx.test.core", "androidx.test.rules", "androidx.test.espresso.core", "mockito-target-minus-junit4", "truth-prebuilt", + "SettingsLibUsageProgressBarPreference", ], dxflags: ["--multi-dex"], diff --git a/packages/SettingsLib/tests/integ/src/com/android/settingslib/widget/UsageProgressBarPreferenceTest.java b/packages/SettingsLib/tests/integ/src/com/android/settingslib/widget/UsageProgressBarPreferenceTest.java new file mode 100644 index 0000000000000..85e2174bf87ad --- /dev/null +++ b/packages/SettingsLib/tests/integ/src/com/android/settingslib/widget/UsageProgressBarPreferenceTest.java @@ -0,0 +1,100 @@ +/* + * Copyright (C) 2021 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.settingslib.widget; + +import static com.google.common.truth.Truth.assertThat; + +import android.content.Context; +import android.text.SpannedString; +import android.text.style.RelativeSizeSpan; +import android.view.LayoutInflater; +import android.view.View; +import android.widget.LinearLayout; +import android.widget.ProgressBar; +import android.widget.TextView; + +import androidx.preference.PreferenceViewHolder; +import androidx.test.core.app.ApplicationProvider; +import androidx.test.runner.AndroidJUnit4; + +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; + +@RunWith(AndroidJUnit4.class) +public class UsageProgressBarPreferenceTest { + + private UsageProgressBarPreference mUsageProgressBarPreference; + private PreferenceViewHolder mViewHolder; + + @Before + public void setUp() { + final Context context = ApplicationProvider.getApplicationContext(); + mUsageProgressBarPreference = new UsageProgressBarPreference(context); + final LayoutInflater inflater = LayoutInflater.from(context); + final View rootView = inflater.inflate(mUsageProgressBarPreference.getLayoutResource(), + new LinearLayout(context), false /* attachToRoot */); + mViewHolder = PreferenceViewHolder.createInstanceForTests(rootView); + } + + @Test + public void setUsageSummary_noNumber_noRelativeSizeSpan() { + mUsageProgressBarPreference.setUsageSummary("test"); + + mUsageProgressBarPreference.onBindViewHolder(mViewHolder); + + final TextView usageSummary = (TextView) mViewHolder.findViewById(R.id.usage_summary); + final SpannedString summary = new SpannedString(usageSummary.getText()); + assertThat(summary.getSpans(0, summary.length(), RelativeSizeSpan.class).length) + .isEqualTo(0); + } + + @Test + public void setUsageSummary_integerNumber_findRelativeSizeSpan() { + mUsageProgressBarPreference.setUsageSummary("10Test"); + + mUsageProgressBarPreference.onBindViewHolder(mViewHolder); + + final TextView usageSummary = (TextView) mViewHolder.findViewById(R.id.usage_summary); + final SpannedString summary = new SpannedString(usageSummary.getText()); + assertThat(summary.getSpans(0, summary.length(), RelativeSizeSpan.class).length) + .isEqualTo(1); + } + + @Test + public void setUsageSummary_floatNumber_findRelativeSizeSpan() { + mUsageProgressBarPreference.setUsageSummary("3.14Test"); + + mUsageProgressBarPreference.onBindViewHolder(mViewHolder); + + final TextView usageSummary = (TextView) mViewHolder.findViewById(R.id.usage_summary); + final SpannedString summary = new SpannedString(usageSummary.getText()); + assertThat(summary.getSpans(0, summary.length(), RelativeSizeSpan.class).length) + .isEqualTo(1); + } + + @Test + public void setPercent_getCorrectProgress() { + mUsageProgressBarPreference.setPercent(31, 80); + + mUsageProgressBarPreference.onBindViewHolder(mViewHolder); + + final ProgressBar progressBar = (ProgressBar) mViewHolder + .findViewById(android.R.id.progress); + assertThat(progressBar.getProgress()).isEqualTo((int) (31.0f / 80 * 100)); + } +}