| /* |
| * 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; |
| |
| import android.content.ContentResolver; |
| import android.database.sqlite.SQLiteDatabase; |
| import android.net.Uri; |
| import android.os.Bundle; |
| import android.provider.BaseColumns; |
| |
| import com.android.launcher3.model.data.ItemInfo; |
| |
| /** |
| * Settings related utilities. |
| */ |
| public class LauncherSettings { |
| |
| /** |
| * Favorites. |
| */ |
| public static final class Favorites implements BaseColumns { |
| /** |
| * The time of the last update to this row. |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String MODIFIED = "modified"; |
| |
| /** |
| * Descriptive name of the gesture that can be displayed to the user. |
| * <P>Type: TEXT</P> |
| */ |
| public static final String TITLE = "title"; |
| |
| /** |
| * The Intent URL of the gesture, describing what it points to. This |
| * value is given to {@link android.content.Intent#parseUri(String, int)} to create |
| * an Intent that can be launched. |
| * <P>Type: TEXT</P> |
| */ |
| public static final String INTENT = "intent"; |
| |
| /** |
| * The type of the gesture |
| * |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String ITEM_TYPE = "itemType"; |
| |
| /** |
| * The gesture is a package |
| */ |
| public static final int ITEM_TYPE_NON_ACTIONABLE = -1; |
| /** |
| * The gesture is an application |
| */ |
| public static final int ITEM_TYPE_APPLICATION = 0; |
| |
| /** |
| * The gesture is an application created shortcut |
| */ |
| public static final int ITEM_TYPE_SHORTCUT = 1; |
| |
| /** |
| * The favorite is a user created folder |
| */ |
| public static final int ITEM_TYPE_FOLDER = 2; |
| |
| /** |
| * The favorite is a widget |
| */ |
| public static final int ITEM_TYPE_APPWIDGET = 4; |
| |
| /** |
| * The favorite is a custom widget provided by the launcher |
| */ |
| public static final int ITEM_TYPE_CUSTOM_APPWIDGET = 5; |
| |
| /** |
| * The gesture is an application created deep shortcut |
| */ |
| public static final int ITEM_TYPE_DEEP_SHORTCUT = 6; |
| |
| /** |
| * The favroite is a search action |
| */ |
| public static final int ITEM_TYPE_SEARCH_ACTION = 7; |
| |
| |
| /** |
| * Type of the item is recents task. |
| * TODO(hyunyoungs): move constants not related to Favorites DB to a better location. |
| */ |
| public static final int ITEM_TYPE_TASK = 7; |
| |
| /** |
| * The item is QSB |
| */ |
| public static final int ITEM_TYPE_QSB = 8; |
| |
| /** |
| * The icon package name in Intent.ShortcutIconResource |
| * <P>Type: TEXT</P> |
| */ |
| public static final String ICON_PACKAGE = "iconPackage"; |
| |
| /** |
| * The icon resource name in Intent.ShortcutIconResource |
| * <P>Type: TEXT</P> |
| */ |
| public static final String ICON_RESOURCE = "iconResource"; |
| |
| /** |
| * The custom icon bitmap. |
| * <P>Type: BLOB</P> |
| */ |
| public static final String ICON = "icon"; |
| |
| public static final String TABLE_NAME = "favorites"; |
| |
| /** |
| * Backup table created when the favorites table is modified during grid migration |
| */ |
| public static final String BACKUP_TABLE_NAME = "favorites_bakup"; |
| |
| /** |
| * Backup table created when user hotseat is moved to workspace for hybrid hotseat |
| */ |
| public static final String HYBRID_HOTSEAT_BACKUP_TABLE = "hotseat_restore_backup"; |
| |
| /** |
| * Temporary table used specifically for grid migrations during wallpaper preview |
| */ |
| public static final String PREVIEW_TABLE_NAME = "favorites_preview"; |
| |
| /** |
| * Temporary table used specifically for multi-db grid migrations |
| */ |
| public static final String TMP_TABLE = "favorites_tmp"; |
| |
| /** |
| * The content:// style URL for "favorites" table |
| */ |
| public static final Uri CONTENT_URI = Uri.parse("content://" |
| + LauncherProvider.AUTHORITY + "/" + TABLE_NAME); |
| |
| /** |
| * The content:// style URL for "favorites_bakup" table |
| */ |
| public static final Uri BACKUP_CONTENT_URI = Uri.parse("content://" |
| + LauncherProvider.AUTHORITY + "/" + BACKUP_TABLE_NAME); |
| |
| /** |
| * The content:// style URL for "favorites_preview" table |
| */ |
| public static final Uri PREVIEW_CONTENT_URI = Uri.parse("content://" |
| + LauncherProvider.AUTHORITY + "/" + PREVIEW_TABLE_NAME); |
| |
| /** |
| * The content:// style URL for "favorites_tmp" table |
| */ |
| public static final Uri TMP_CONTENT_URI = Uri.parse("content://" |
| + LauncherProvider.AUTHORITY + "/" + TMP_TABLE); |
| |
| /** |
| * The content:// style URL for a given row, identified by its id. |
| * |
| * @param id The row id. |
| * |
| * @return The unique content URL for the specified row. |
| */ |
| public static Uri getContentUri(int id) { |
| return Uri.parse("content://" + LauncherProvider.AUTHORITY |
| + "/" + TABLE_NAME + "/" + id); |
| } |
| |
| /** |
| * The container holding the favorite |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String CONTAINER = "container"; |
| |
| /** |
| * The icon is a resource identified by a package name and an integer id. |
| */ |
| public static final int CONTAINER_DESKTOP = -100; |
| public static final int CONTAINER_HOTSEAT = -101; |
| public static final int CONTAINER_PREDICTION = -102; |
| public static final int CONTAINER_WIDGETS_PREDICTION = -111; |
| public static final int CONTAINER_HOTSEAT_PREDICTION = -103; |
| public static final int CONTAINER_ALL_APPS = -104; |
| public static final int CONTAINER_WIDGETS_TRAY = -105; |
| public static final int CONTAINER_BOTTOM_WIDGETS_TRAY = -112; |
| public static final int CONTAINER_PIN_WIDGETS = -113; |
| public static final int CONTAINER_WALLPAPERS = -114; |
| // Represents search results view. |
| public static final int CONTAINER_SEARCH_RESULTS = -106; |
| public static final int CONTAINER_SHORTCUTS = -107; |
| public static final int CONTAINER_SETTINGS = -108; |
| public static final int CONTAINER_TASKSWITCHER = -109; |
| public static final int CONTAINER_QSB = -110; |
| |
| // Represents any of the extended containers implemented in non-AOSP variants. |
| public static final int EXTENDED_CONTAINERS = -200; |
| |
| public static final int CONTAINER_UNKNOWN = -1; |
| |
| public static final String containerToString(int container) { |
| switch (container) { |
| case CONTAINER_DESKTOP: return "desktop"; |
| case CONTAINER_HOTSEAT: return "hotseat"; |
| case CONTAINER_PREDICTION: return "prediction"; |
| case CONTAINER_ALL_APPS: return "all_apps"; |
| case CONTAINER_WIDGETS_TRAY: return "widgets_tray"; |
| case CONTAINER_SEARCH_RESULTS: return "search_result"; |
| case CONTAINER_SHORTCUTS: return "shortcuts"; |
| default: return String.valueOf(container); |
| } |
| } |
| |
| public static final String itemTypeToString(int type) { |
| switch(type) { |
| case ITEM_TYPE_APPLICATION: return "APP"; |
| case ITEM_TYPE_SHORTCUT: return "SHORTCUT"; |
| case ITEM_TYPE_FOLDER: return "FOLDER"; |
| case ITEM_TYPE_APPWIDGET: return "WIDGET"; |
| case ITEM_TYPE_CUSTOM_APPWIDGET: return "CUSTOMWIDGET"; |
| case ITEM_TYPE_DEEP_SHORTCUT: return "DEEPSHORTCUT"; |
| case ITEM_TYPE_TASK: return "TASK"; |
| case ITEM_TYPE_QSB: return "QSB"; |
| default: return String.valueOf(type); |
| } |
| } |
| |
| /** |
| * The screen holding the favorite (if container is CONTAINER_DESKTOP) |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String SCREEN = "screen"; |
| |
| /** |
| * The X coordinate of the cell holding the favorite |
| * (if container is CONTAINER_HOTSEAT or CONTAINER_HOTSEAT) |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String CELLX = "cellX"; |
| |
| /** |
| * The Y coordinate of the cell holding the favorite |
| * (if container is CONTAINER_DESKTOP) |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String CELLY = "cellY"; |
| |
| /** |
| * The X span of the cell holding the favorite |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String SPANX = "spanX"; |
| |
| /** |
| * The Y span of the cell holding the favorite |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String SPANY = "spanY"; |
| |
| /** |
| * The profile id of the item in the cell. |
| * <P> |
| * Type: INTEGER |
| * </P> |
| */ |
| public static final String PROFILE_ID = "profileId"; |
| |
| /** |
| * The appWidgetId of the widget |
| * |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String APPWIDGET_ID = "appWidgetId"; |
| |
| /** |
| * The ComponentName of the widget provider |
| * |
| * <P>Type: STRING</P> |
| */ |
| public static final String APPWIDGET_PROVIDER = "appWidgetProvider"; |
| |
| /** |
| * Boolean indicating that his item was restored and not yet successfully bound. |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String RESTORED = "restored"; |
| |
| /** |
| * Indicates the position of the item inside an auto-arranged view like folder or hotseat. |
| * <p>Type: INTEGER</p> |
| */ |
| public static final String RANK = "rank"; |
| |
| /** |
| * Stores general flag based options for {@link ItemInfo}s. |
| * <p>Type: INTEGER</p> |
| */ |
| public static final String OPTIONS = "options"; |
| |
| /** |
| * Stores the source container that the widget was added from. |
| * <p>Type: INTEGER</p> |
| */ |
| public static final String APPWIDGET_SOURCE = "appWidgetSource"; |
| |
| public static void addTableToDb(SQLiteDatabase db, long myProfileId, boolean optional) { |
| addTableToDb(db, myProfileId, optional, TABLE_NAME); |
| } |
| |
| public static void addTableToDb(SQLiteDatabase db, long myProfileId, boolean optional, |
| String tableName) { |
| String ifNotExists = optional ? " IF NOT EXISTS " : ""; |
| db.execSQL("CREATE TABLE " + ifNotExists + tableName + " (" + |
| "_id INTEGER PRIMARY KEY," + |
| "title TEXT," + |
| "intent TEXT," + |
| "container INTEGER," + |
| "screen INTEGER," + |
| "cellX INTEGER," + |
| "cellY INTEGER," + |
| "spanX INTEGER," + |
| "spanY INTEGER," + |
| "itemType INTEGER," + |
| "appWidgetId INTEGER NOT NULL DEFAULT -1," + |
| "iconPackage TEXT," + |
| "iconResource TEXT," + |
| "icon BLOB," + |
| "appWidgetProvider TEXT," + |
| "modified INTEGER NOT NULL DEFAULT 0," + |
| "restored INTEGER NOT NULL DEFAULT 0," + |
| "profileId INTEGER DEFAULT " + myProfileId + "," + |
| "rank INTEGER NOT NULL DEFAULT 0," + |
| "options INTEGER NOT NULL DEFAULT 0," + |
| APPWIDGET_SOURCE + " INTEGER NOT NULL DEFAULT " + CONTAINER_UNKNOWN + |
| ");"); |
| } |
| } |
| |
| /** |
| * Launcher settings |
| */ |
| public static final class Settings { |
| |
| public static final Uri CONTENT_URI = Uri.parse("content://" + |
| LauncherProvider.AUTHORITY + "/settings"); |
| |
| public static final String METHOD_CLEAR_EMPTY_DB_FLAG = "clear_empty_db_flag"; |
| public static final String METHOD_WAS_EMPTY_DB_CREATED = "get_empty_db_flag"; |
| |
| public static final String METHOD_DELETE_EMPTY_FOLDERS = "delete_empty_folders"; |
| |
| public static final String METHOD_NEW_ITEM_ID = "generate_new_item_id"; |
| public static final String METHOD_NEW_SCREEN_ID = "generate_new_screen_id"; |
| |
| public static final String METHOD_CREATE_EMPTY_DB = "create_empty_db"; |
| |
| public static final String METHOD_SET_USE_TEST_WORKSPACE_LAYOUT_FLAG = |
| "set_use_test_workspace_layout_flag"; |
| |
| public static final String METHOD_CLEAR_USE_TEST_WORKSPACE_LAYOUT_FLAG = |
| "clear_use_test_workspace_layout_flag"; |
| |
| public static final String METHOD_LOAD_DEFAULT_FAVORITES = "load_default_favorites"; |
| |
| public static final String METHOD_REMOVE_GHOST_WIDGETS = "remove_ghost_widgets"; |
| |
| public static final String METHOD_NEW_TRANSACTION = "new_db_transaction"; |
| |
| public static final String METHOD_REFRESH_BACKUP_TABLE = "refresh_backup_table"; |
| |
| public static final String METHOD_REFRESH_HOTSEAT_RESTORE_TABLE = "restore_hotseat_table"; |
| |
| public static final String METHOD_RESTORE_BACKUP_TABLE = "restore_backup_table"; |
| |
| public static final String METHOD_UPDATE_CURRENT_OPEN_HELPER = "update_current_open_helper"; |
| |
| public static final String METHOD_PREP_FOR_PREVIEW = "prep_for_preview"; |
| |
| public static final String METHOD_SWITCH_DATABASE = "switch_database"; |
| |
| public static final String EXTRA_VALUE = "value"; |
| |
| public static final String EXTRA_DB_NAME = "db_name"; |
| |
| public static Bundle call(ContentResolver cr, String method) { |
| return call(cr, method, null /* arg */); |
| } |
| |
| public static Bundle call(ContentResolver cr, String method, String arg) { |
| return call(cr, method, arg, null /* extras */); |
| } |
| |
| public static Bundle call(ContentResolver cr, String method, String arg, Bundle extras) { |
| return cr.call(CONTENT_URI, method, arg, extras); |
| } |
| } |
| } |