| /* |
| * 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.config.ProviderConfig; |
| |
| /** |
| * Settings related utilities. |
| */ |
| public class LauncherSettings { |
| /** Columns required on table staht will be subject to backup and restore. */ |
| static interface ChangeLogColumns extends BaseColumns { |
| /** |
| * The time of the last update to this row. |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String MODIFIED = "modified"; |
| } |
| |
| static interface BaseLauncherColumns extends ChangeLogColumns { |
| /** |
| * 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 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 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"; |
| } |
| |
| /** |
| * Workspace Screens. |
| * |
| * Tracks the order of workspace screens. |
| */ |
| public static final class WorkspaceScreens implements ChangeLogColumns { |
| |
| public static final String TABLE_NAME = "workspaceScreens"; |
| |
| /** |
| * The content:// style URL for this table |
| */ |
| public static final Uri CONTENT_URI = Uri.parse("content://" + |
| ProviderConfig.AUTHORITY + "/" + TABLE_NAME); |
| |
| /** |
| * The rank of this screen -- ie. how it is ordered relative to the other screens. |
| * <P>Type: INTEGER</P> |
| */ |
| public static final String SCREEN_RANK = "screenRank"; |
| } |
| |
| /** |
| * Favorites. |
| */ |
| public static final class Favorites implements BaseLauncherColumns { |
| |
| public static final String TABLE_NAME = "favorites"; |
| |
| /** |
| * The content:// style URL for this table |
| */ |
| public static final Uri CONTENT_URI = Uri.parse("content://" + |
| ProviderConfig.AUTHORITY + "/" + TABLE_NAME); |
| |
| /** |
| * 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(long id) { |
| return Uri.parse("content://" + ProviderConfig.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; |
| |
| static final String containerToString(int container) { |
| switch (container) { |
| case CONTAINER_DESKTOP: return "desktop"; |
| case CONTAINER_HOTSEAT: return "hotseat"; |
| default: return String.valueOf(container); |
| } |
| } |
| |
| /** |
| * 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 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 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"; |
| |
| public static void addTableToDb(SQLiteDatabase db, long myProfileId, boolean optional) { |
| String ifNotExists = optional ? " IF NOT EXISTS " : ""; |
| db.execSQL("CREATE TABLE " + ifNotExists + TABLE_NAME + " (" + |
| "_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" + |
| ");"); |
| } |
| } |
| |
| /** |
| * Launcher settings |
| */ |
| public static final class Settings { |
| |
| public static final Uri CONTENT_URI = Uri.parse("content://" + |
| ProviderConfig.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_DELETE_DB = "delete_db"; |
| |
| public static final String METHOD_LOAD_DEFAULT_FAVORITES = "load_default_favorites"; |
| |
| public static final String METHOD_SET_EXTRACTED_COLORS_AND_WALLPAPER_ID = |
| "set_extracted_colors_and_wallpaper_id_setting"; |
| public static final String EXTRA_EXTRACTED_COLORS = "extra_extractedColors"; |
| public static final String EXTRA_WALLPAPER_ID = "extra_wallpaperId"; |
| |
| public static final String EXTRA_VALUE = "value"; |
| |
| public static Bundle call(ContentResolver cr, String method) { |
| return cr.call(CONTENT_URI, method, null, null); |
| } |
| } |
| } |