/* * Copyright (C) 2008 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.launcher3.model.data; import static android.text.TextUtils.isEmpty; import static androidx.core.util.Preconditions.checkNotNull; import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APPLICATION; import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_APP_PAIR; import static com.android.launcher3.LauncherSettings.Favorites.ITEM_TYPE_DEEP_SHORTCUT; import static com.android.launcher3.logger.LauncherAtom.Attribute.EMPTY_LABEL; import static com.android.launcher3.logger.LauncherAtom.Attribute.MANUAL_LABEL; import static com.android.launcher3.logger.LauncherAtom.Attribute.SUGGESTED_LABEL; import android.content.Context; import androidx.annotation.NonNull; import androidx.annotation.Nullable; import com.android.launcher3.LauncherSettings; import com.android.launcher3.folder.FolderNameInfos; import com.android.launcher3.logger.LauncherAtom; import com.android.launcher3.logger.LauncherAtom.Attribute; import com.android.launcher3.logger.LauncherAtom.FolderIcon; import com.android.launcher3.logger.LauncherAtom.FromState; import com.android.launcher3.logger.LauncherAtom.ToState; import com.android.launcher3.model.ModelWriter; import com.android.launcher3.util.ContentWriter; import java.util.ArrayList; import java.util.OptionalInt; import java.util.stream.IntStream; /** * Represents a folder containing shortcuts or apps. */ public class FolderInfo extends CollectionInfo { /** * The multi-page animation has run for this folder */ public static final int FLAG_MULTI_PAGE_ANIMATION = 0x00000004; public static final int FLAG_MANUAL_FOLDER_NAME = 0x00000008; /** * Different states of folder label. */ public enum LabelState { // Folder's label is not yet assigned( i.e., title == null). Eligible for auto-labeling. UNLABELED(Attribute.UNLABELED), // Folder's label is empty(i.e., title == ""). Not eligible for auto-labeling. EMPTY(EMPTY_LABEL), // Folder's label is one of the non-empty suggested values. SUGGESTED(SUGGESTED_LABEL), // Folder's label is non-empty, manually entered by the user // and different from any of suggested values. MANUAL(MANUAL_LABEL); private final LauncherAtom.Attribute mLogAttribute; LabelState(Attribute logAttribute) { this.mLogAttribute = logAttribute; } } public int options; public FolderNameInfos suggestedFolderNames; /** * The apps and shortcuts */ private final ArrayList contents = new ArrayList<>(); public FolderInfo() { itemType = LauncherSettings.Favorites.ITEM_TYPE_FOLDER; } @Override public void add(@NonNull ItemInfo item) { if (!willAcceptItemType(item.itemType)) { throw new RuntimeException("tried to add an illegal type into a folder"); } getContents().add(item); } /** * Returns the folder's contents as an unsorted ArrayList of {@link ItemInfo}. Includes * {@link WorkspaceItemInfo} and {@link AppPairInfo}s. */ @NonNull @Override public ArrayList getContents() { return contents; } /** * Returns the folder's contents as an ArrayList of {@link WorkspaceItemInfo}. Note: Does not * return any {@link AppPairInfo}s contained in the folder, instead collects *their* contents * and adds them to the ArrayList. */ @Override public ArrayList getAppContents() { ArrayList workspaceItemInfos = new ArrayList<>(); for (ItemInfo item : contents) { if (item instanceof WorkspaceItemInfo wii) { workspaceItemInfos.add(wii); } else if (item instanceof AppPairInfo api) { workspaceItemInfos.addAll(api.getAppContents()); } } return workspaceItemInfos; } @Override public void onAddToDatabase(@NonNull ContentWriter writer) { super.onAddToDatabase(writer); writer.put(LauncherSettings.Favorites.OPTIONS, options); } public boolean hasOption(int optionFlag) { return (options & optionFlag) != 0; } /** * @param option flag to set or clear * @param isEnabled whether to set or clear the flag * @param writer if not null, save changes to the db. */ public void setOption(int option, boolean isEnabled, ModelWriter writer) { int oldOptions = options; if (isEnabled) { options |= option; } else { options &= ~option; } if (writer != null && oldOptions != options) { writer.updateItemInDatabase(this); } } @Override protected String dumpProperties() { return String.format("%s; labelState=%s", super.dumpProperties(), getLabelState()); } @NonNull @Override public LauncherAtom.ItemInfo buildProto(@Nullable CollectionInfo cInfo, Context context) { FolderIcon.Builder folderIcon = FolderIcon.newBuilder() .setCardinality(getContents().size()); if (LabelState.SUGGESTED.equals(getLabelState())) { folderIcon.setLabelInfo(title.toString()); } return getDefaultItemInfoBuilder(context) .setFolderIcon(folderIcon) .setRank(rank) .addItemAttributes(getLabelState().mLogAttribute) .setContainerInfo(getContainerInfo()) .build(); } public void setTitle(@Nullable CharSequence title, ModelWriter modelWriter) { // Updating label from null to empty is considered as false touch. // Retaining null title(ie., UNLABELED state) allows auto-labeling when new items added. if (isEmpty(title) && this.title == null) { return; } // Updating title to same value does not change any states. if (title != null && title.equals(this.title)) { return; } this.title = title; LabelState newLabelState = title == null ? LabelState.UNLABELED : title.length() == 0 ? LabelState.EMPTY : getAcceptedSuggestionIndex().isPresent() ? LabelState.SUGGESTED : LabelState.MANUAL; if (newLabelState.equals(LabelState.MANUAL)) { options |= FLAG_MANUAL_FOLDER_NAME; } else { options &= ~FLAG_MANUAL_FOLDER_NAME; } if (modelWriter != null) { modelWriter.updateItemInDatabase(this); } } /** * Returns current state of the current folder label. */ public LabelState getLabelState() { return title == null ? LabelState.UNLABELED : title.length() == 0 ? LabelState.EMPTY : hasOption(FLAG_MANUAL_FOLDER_NAME) ? LabelState.MANUAL : LabelState.SUGGESTED; } @NonNull @Override public ItemInfo makeShallowCopy() { FolderInfo folderInfo = new FolderInfo(); folderInfo.copyFrom(this); return folderInfo; } @Override public void copyFrom(@NonNull ItemInfo info) { super.copyFrom(info); if (info instanceof FolderInfo fi) { contents.addAll(fi.getContents()); } } /** * Returns index of the accepted suggestion. */ public OptionalInt getAcceptedSuggestionIndex() { String newLabel = checkNotNull(title, "Expected valid folder label, but found null").toString(); if (suggestedFolderNames == null || !suggestedFolderNames.hasSuggestions()) { return OptionalInt.empty(); } CharSequence[] labels = suggestedFolderNames.getLabels(); return IntStream.range(0, labels.length) .filter(index -> !isEmpty(labels[index]) && newLabel.equalsIgnoreCase( labels[index].toString())) .sequential() .findFirst(); } /** * Returns {@link FromState} based on current {@link #title}. */ public LauncherAtom.FromState getFromLabelState() { switch (getLabelState()){ case EMPTY: return LauncherAtom.FromState.FROM_EMPTY; case MANUAL: return LauncherAtom.FromState.FROM_CUSTOM; case SUGGESTED: return LauncherAtom.FromState.FROM_SUGGESTED; case UNLABELED: default: return LauncherAtom.FromState.FROM_STATE_UNSPECIFIED; } } /** * Returns {@link ToState} based on current {@link #title}. */ public LauncherAtom.ToState getToLabelState() { if (title == null) { return LauncherAtom.ToState.TO_STATE_UNSPECIFIED; } // TODO: if suggestedFolderNames is null then it infrastructure issue, not // ranking issue. We should log these appropriately. if (suggestedFolderNames == null || !suggestedFolderNames.hasSuggestions()) { return title.length() > 0 ? LauncherAtom.ToState.TO_CUSTOM_WITH_EMPTY_SUGGESTIONS : LauncherAtom.ToState.TO_EMPTY_WITH_EMPTY_SUGGESTIONS; } boolean hasValidPrimary = suggestedFolderNames != null && suggestedFolderNames.hasPrimary(); if (title.length() == 0) { return hasValidPrimary ? LauncherAtom.ToState.TO_EMPTY_WITH_VALID_PRIMARY : LauncherAtom.ToState.TO_EMPTY_WITH_VALID_SUGGESTIONS_AND_EMPTY_PRIMARY; } OptionalInt accepted_suggestion_index = getAcceptedSuggestionIndex(); if (!accepted_suggestion_index.isPresent()) { return hasValidPrimary ? LauncherAtom.ToState.TO_CUSTOM_WITH_VALID_PRIMARY : LauncherAtom.ToState.TO_CUSTOM_WITH_VALID_SUGGESTIONS_AND_EMPTY_PRIMARY; } switch (accepted_suggestion_index.getAsInt()) { case 0: return LauncherAtom.ToState.TO_SUGGESTION0; case 1: return hasValidPrimary ? LauncherAtom.ToState.TO_SUGGESTION1_WITH_VALID_PRIMARY : LauncherAtom.ToState.TO_SUGGESTION1_WITH_EMPTY_PRIMARY; case 2: return hasValidPrimary ? LauncherAtom.ToState.TO_SUGGESTION2_WITH_VALID_PRIMARY : LauncherAtom.ToState.TO_SUGGESTION2_WITH_EMPTY_PRIMARY; case 3: return hasValidPrimary ? LauncherAtom.ToState.TO_SUGGESTION3_WITH_VALID_PRIMARY : LauncherAtom.ToState.TO_SUGGESTION3_WITH_EMPTY_PRIMARY; default: // fall through } return LauncherAtom.ToState.TO_STATE_UNSPECIFIED; } /** * Checks if {@code itemType} is a type that can be placed in folders. */ public static boolean willAcceptItemType(int itemType) { return itemType == ITEM_TYPE_APPLICATION || itemType == ITEM_TYPE_DEEP_SHORTCUT || itemType == ITEM_TYPE_APP_PAIR; } }