src/com/android/settings/dashboard/suggestions/SuggestionAdapterV2.java

   1 /*
   2  * Copyright (C) 2018 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 package com.android.settings.dashboard.suggestions;
  17
  18 import android.app.PendingIntent;
  19 import android.content.Context;
  20 import android.content.res.Resources;
  21 import android.graphics.drawable.Drawable;
  22 import android.graphics.drawable.Icon;
  23 import android.os.Bundle;
  24 import android.service.settings.suggestions.Suggestion;
  25 import android.support.v7.widget.RecyclerView;
  26 import android.text.TextUtils;
  27 import android.util.Log;
  28 import android.view.LayoutInflater;
  29 import android.view.View;
  30 import android.view.ViewGroup;
  31 import android.widget.ImageView;
  32 import android.widget.LinearLayout;
  33
  34 import com.android.internal.logging.nano.MetricsProto.MetricsEvent;
  35 import com.android.settings.R;
  36 import com.android.settings.dashboard.DashboardAdapterV2.DashboardItemHolder;
  37 import com.android.settings.dashboard.DashboardAdapterV2.IconCache;
  38 import com.android.settings.overlay.FeatureFactory;
  39 import com.android.settingslib.Utils;
  40 import com.android.settingslib.core.instrumentation.MetricsFeatureProvider;
  41 import com.android.settingslib.core.lifecycle.Lifecycle;
  42 import com.android.settingslib.core.lifecycle.LifecycleObserver;
  43 import com.android.settingslib.core.lifecycle.events.OnSaveInstanceState;
  44 import com.android.settingslib.suggestions.SuggestionControllerMixin;
  45
  46 import java.util.ArrayList;
  47 import java.util.List;
  48 import java.util.Objects;
  49
  50 public class SuggestionAdapterV2 extends RecyclerView.Adapter<DashboardItemHolder> implements
  51         LifecycleObserver, OnSaveInstanceState {
  52     public static final String TAG = "SuggestionAdapterV2";
  53
  54     private static final String STATE_SUGGESTIONS_SHOWN_LOGGED = "suggestions_shown_logged";
  55     private static final String STATE_SUGGESTION_LIST = "suggestion_list";
  56
  57     private final Context mContext;
  58     private final MetricsFeatureProvider mMetricsFeatureProvider;
  59     private final IconCache mCache;
  60     private final ArrayList<String> mSuggestionsShownLogged;
  61     private final SuggestionFeatureProvider mSuggestionFeatureProvider;
  62     private final SuggestionControllerMixin mSuggestionControllerMixin;
  63     private final Callback mCallback;
  64     private final CardConfig mConfig;
  65
  66     private List<Suggestion> mSuggestions;
  67
  68     public interface Callback {
  69         /**
  70          * Called when the close button of the suggestion card is clicked.
  71          */
  72         void onSuggestionClosed(Suggestion suggestion);
  73     }
  74
  75     public SuggestionAdapterV2(Context context, SuggestionControllerMixin suggestionControllerMixin,
  76             Bundle savedInstanceState, Callback callback, Lifecycle lifecycle) {
  77         mContext = context;
  78         mSuggestionControllerMixin = suggestionControllerMixin;
  79         mCache = new IconCache(context);
  80         final FeatureFactory factory = FeatureFactory.getFactory(context);
  81         mMetricsFeatureProvider = factory.getMetricsFeatureProvider();
  82         mSuggestionFeatureProvider = factory.getSuggestionFeatureProvider(context);
  83         mCallback = callback;
  84         if (savedInstanceState != null) {
  85             mSuggestions = savedInstanceState.getParcelableArrayList(STATE_SUGGESTION_LIST);
  86             mSuggestionsShownLogged = savedInstanceState.getStringArrayList(
  87                 STATE_SUGGESTIONS_SHOWN_LOGGED);
  88         } else {
  89             mSuggestionsShownLogged = new ArrayList<>();
  90         }
  91
  92         if (lifecycle != null) {
  93             lifecycle.addObserver(this);
  94         }
  95         mConfig = CardConfig.get(context);
  96
  97         setHasStableIds(true);
  98     }
  99
 100     @Override
 101     public DashboardItemHolder onCreateViewHolder(ViewGroup parent, int viewType) {
 102         return new DashboardItemHolder(LayoutInflater.from(parent.getContext()).inflate(
 103                 viewType, parent, false));
 104     }
 105
 106     @Override
 107     public void onBindViewHolder(DashboardItemHolder holder, int position) {
 108         final Suggestion suggestion = mSuggestions.get(position);
 109         final String id = suggestion.getId();
 110         final int suggestionCount = mSuggestions.size();
 111         if (!mSuggestionsShownLogged.contains(id)) {
 112             mMetricsFeatureProvider.action(
 113                     mContext, MetricsEvent.ACTION_SHOW_SETTINGS_SUGGESTION, id);
 114             mSuggestionsShownLogged.add(id);
 115         }
 116         mConfig.setCardLayout(holder, suggestionCount, position);
 117         final Icon icon = suggestion.getIcon();
 118         final Drawable drawable = mCache.getIcon(icon);
 119         if (drawable != null && TextUtils.equals(icon.getResPackage(), mContext.getPackageName())) {
 120             drawable.setTint(Utils.getColorAccent(mContext));
 121         }
 122         holder.icon.setImageDrawable(drawable);
 123         holder.title.setText(suggestion.getTitle());
 124         holder.title.setSingleLine(suggestionCount == 1);
 125
 126         if (suggestionCount == 1) {
 127             final CharSequence summary = suggestion.getSummary();
 128             if (!TextUtils.isEmpty(summary)) {
 129                 holder.summary.setText(summary);
 130                 holder.summary.setVisibility(View.VISIBLE);
 131             } else {
 132                 holder.summary.setVisibility(View.GONE);
 133             }
 134         } else {
 135             // Do not show summary if there are more than 1 suggestions
 136             holder.summary.setVisibility(View.GONE);
 137             holder.title.setMaxLines(3);
 138         }
 139
 140         final ImageView closeButton = holder.itemView.findViewById(R.id.close_button);
 141         if (closeButton != null) {
 142             closeButton.setOnClickListener(v -> {
 143                 mSuggestionFeatureProvider.dismissSuggestion(
 144                     mContext, mSuggestionControllerMixin, suggestion);
 145                 if (mCallback != null) {
 146                     mCallback.onSuggestionClosed(suggestion);
 147                 }
 148             });
 149         }
 150
 151         View clickHandler = holder.itemView;
 152         // If a view with @android:id/primary is defined, use that as the click handler
 153         // instead.
 154         final View primaryAction = holder.itemView.findViewById(android.R.id.primary);
 155         if (primaryAction != null) {
 156             clickHandler = primaryAction;
 157         }
 158         clickHandler.setOnClickListener(v -> {
 159             mMetricsFeatureProvider.action(mContext, MetricsEvent.ACTION_SETTINGS_SUGGESTION, id);
 160             try {
 161                 suggestion.getPendingIntent().send();
 162                 mSuggestionControllerMixin.launchSuggestion(suggestion);
 163             } catch (PendingIntent.CanceledException e) {
 164                 Log.w(TAG, "Failed to start suggestion " + suggestion.getTitle());
 165             }
 166         });
 167     }
 168
 169     @Override
 170     public long getItemId(int position) {
 171         return Objects.hash(mSuggestions.get(position).getId());
 172     }
 173
 174     @Override
 175     public int getItemViewType(int position) {
 176         final Suggestion suggestion = getSuggestion(position);
 177         if ((suggestion.getFlags() & Suggestion.FLAG_HAS_BUTTON) != 0) {
 178             return R.layout.suggestion_tile_with_button_v2;
 179         } else {
 180             return R.layout.suggestion_tile_v2;
 181         }
 182     }
 183
 184     @Override
 185     public int getItemCount() {
 186         return mSuggestions.size();
 187     }
 188
 189     public Suggestion getSuggestion(int position) {
 190         final long itemId = getItemId(position);
 191         if (mSuggestions == null) {
 192             return null;
 193         }
 194         for (Suggestion suggestion : mSuggestions) {
 195             if (Objects.hash(suggestion.getId()) == itemId) {
 196                 return suggestion;
 197             }
 198         }
 199         return null;
 200     }
 201
 202     public void removeSuggestion(Suggestion suggestion) {
 203         final int position = mSuggestions.indexOf(suggestion);
 204         mSuggestions.remove(suggestion);
 205         notifyItemRemoved(position);
 206     }
 207
 208     @Override
 209     public void onSaveInstanceState(Bundle outState) {
 210         if (mSuggestions != null) {
 211             outState.putParcelableArrayList(STATE_SUGGESTION_LIST,
 212                 new ArrayList<>(mSuggestions));
 213         }
 214         outState.putStringArrayList(STATE_SUGGESTIONS_SHOWN_LOGGED, mSuggestionsShownLogged);
 215     }
 216
 217     public void setSuggestions(List<Suggestion> suggestions) {
 218         mSuggestions = suggestions;
 219     }
 220
 221     public List<Suggestion> getSuggestions() {
 222         return mSuggestions;
 223     }
 224
 225     private static class CardConfig {
 226         // Card start/end margin
 227         private final int mMarginInner;
 228         private final int mMarginOuter;
 229         // Card width for different numbers of cards
 230         private final int mWidthSingleCard;
 231         private final int mWidthTwoCards;
 232         private final int mWidthMultipleCards;
 233         // padding between icon and title
 234         private final int mPaddingTitleTopSingleCard;
 235         private final int mPaddingTitleTopMultipleCards;
 236
 237         private static CardConfig sConfig;
 238
 239         private CardConfig(Context context) {
 240             final Resources res = context.getResources();
 241             mMarginInner =
 242                 res.getDimensionPixelOffset(R.dimen.suggestion_card_inner_margin);
 243             mMarginOuter =
 244                 res.getDimensionPixelOffset(R.dimen.suggestion_card_outer_margin);
 245             mWidthSingleCard = res.getDimensionPixelOffset(R.dimen.suggestion_card_width_one_card);
 246             mWidthTwoCards = res.getDimensionPixelOffset(R.dimen.suggestion_card_width_two_cards);
 247             mWidthMultipleCards =
 248                 res.getDimensionPixelOffset(R.dimen.suggestion_card_width_multiple_cards);
 249             mPaddingTitleTopSingleCard =
 250                 res.getDimensionPixelOffset(R.dimen.suggestion_card_title_padding_bottom_one_card);
 251             mPaddingTitleTopMultipleCards = res.getDimensionPixelOffset(
 252                 R.dimen.suggestion_card_title_padding_bottom_multiple_cards);
 253         }
 254
 255         public static CardConfig get(Context context) {
 256             if (sConfig == null) {
 257                 sConfig = new CardConfig(context);
 258             }
 259             return sConfig;
 260         }
 261
 262         private void setCardLayout(DashboardItemHolder holder, int suggestionCount,
 263             int position) {
 264             final LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
 265                 suggestionCount == 1
 266                     ? mWidthSingleCard : suggestionCount == 2
 267                     ? mWidthTwoCards : mWidthMultipleCards,
 268                 LinearLayout.LayoutParams.WRAP_CONTENT);
 269             if (suggestionCount == 1) {
 270                 params.setMarginStart(mMarginOuter);
 271                 params.setMarginEnd(mMarginOuter);
 272             } else {
 273                 params.setMarginStart(
 274                     position == 0 ? mMarginOuter : mMarginInner);
 275                 params.setMarginEnd(position == suggestionCount - 1 ? mMarginOuter : 0);
 276             }
 277             holder.itemView.setLayoutParams(params);
 278         }
 279
 280     }
 281
 282 }