/* * 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; /** * 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. *

Type: INTEGER

*/ public static final String MODIFIED = "modified"; } static public interface BaseLauncherColumns extends ChangeLogColumns { /** * Descriptive name of the gesture that can be displayed to the user. *

Type: TEXT

*/ 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. *

Type: TEXT

*/ public static final String INTENT = "intent"; /** * The type of the gesture * *

Type: INTEGER

*/ 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 *

Type: TEXT

*/ public static final String ICON_PACKAGE = "iconPackage"; /** * The icon resource name in Intent.ShortcutIconResource *

Type: TEXT

*/ public static final String ICON_RESOURCE = "iconResource"; /** * The custom icon bitmap. *

Type: BLOB

*/ 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://" + LauncherProvider.AUTHORITY + "/" + TABLE_NAME); /** * The rank of this screen -- ie. how it is ordered relative to the other screens. *

Type: INTEGER

*/ 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://" + LauncherProvider.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://" + LauncherProvider.AUTHORITY + "/" + TABLE_NAME + "/" + id); } /** * The container holding the favorite *

Type: INTEGER

*/ 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); } } 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"; default: return String.valueOf(type); } } /** * The screen holding the favorite (if container is CONTAINER_DESKTOP) *

Type: INTEGER

*/ public static final String SCREEN = "screen"; /** * The X coordinate of the cell holding the favorite * (if container is CONTAINER_HOTSEAT or CONTAINER_HOTSEAT) *

Type: INTEGER

*/ public static final String CELLX = "cellX"; /** * The Y coordinate of the cell holding the favorite * (if container is CONTAINER_DESKTOP) *

Type: INTEGER

*/ public static final String CELLY = "cellY"; /** * The X span of the cell holding the favorite *

Type: INTEGER

*/ public static final String SPANX = "spanX"; /** * The Y span of the cell holding the favorite *

Type: INTEGER

*/ public static final String SPANY = "spanY"; /** * The profile id of the item in the cell. *

* Type: INTEGER *

*/ 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 * *

Type: INTEGER

*/ public static final String APPWIDGET_ID = "appWidgetId"; /** * The ComponentName of the widget provider * *

Type: STRING

*/ public static final String APPWIDGET_PROVIDER = "appWidgetProvider"; /** * Boolean indicating that his item was restored and not yet successfully bound. *

Type: INTEGER

*/ public static final String RESTORED = "restored"; /** * Indicates the position of the item inside an auto-arranged view like folder or hotseat. *

Type: INTEGER

*/ public static final String RANK = "rank"; /** * Stores general flag based options for {@link ItemInfo}s. *

Type: INTEGER

*/ 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://" + 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_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 METHOD_REMOVE_GHOST_WIDGETS = "remove_ghost_widgets"; public static final String EXTRA_VALUE = "value"; public static Bundle call(ContentResolver cr, String method) { return cr.call(CONTENT_URI, method, null, null); } } }