1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
/*
* Copyright (C) 2009 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 android.provider;
import android.content.ComponentName;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import java.util.List;
/**
* The Applications provider gives information about installed applications.
*
* @hide Only used by ApplicationsProvider and Launchers so far.
*/
public class Applications {
private static final String TAG = "ApplicationsProvider";
/**
* The content authority for this provider.
*/
public static final String AUTHORITY = "applications";
/**
* The content:// style URL for this provider
*/
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY);
/**
* The content path for application component URIs.
*/
public static final String APPLICATION_PATH = "applications";
/**
* The content path for application search.
*/
public static final String SEARCH_PATH = "search";
private static final String APPLICATION_SUB_TYPE = "vnd.android.application";
/**
* The MIME type for a single application item.
*/
public static final String APPLICATION_ITEM_TYPE =
ContentResolver.CURSOR_ITEM_BASE_TYPE + "/" + APPLICATION_SUB_TYPE;
/**
* The MIME type for a list of application items.
*/
public static final String APPLICATION_DIR_TYPE =
ContentResolver.CURSOR_DIR_BASE_TYPE + "/" + APPLICATION_SUB_TYPE;
/**
* The path that should be used when an application is launched. The aim is
* to help ApplicationsProvider keep track of which applications the user
* uses the most, and improve app ranking based on this.
*/
public static final String INCREASE_LAUNCH_COUNT_PATH = "increase_launch_count";
public static final Uri INCREASE_LAUNCH_COUNT_URI = CONTENT_URI.buildUpon()
.appendPath(INCREASE_LAUNCH_COUNT_PATH).build();
/**
* The package name parameter for the "increase launch count" call.
*/
public static final String INCREASE_LAUNCH_COUNT_PACKAGE = "packageName";
/**
* The classname parameter for the "increase launch count" call.
*/
public static final String INCREASE_LAUNCH_COUNT_CLASS = "className";
/**
* no public constructor since this is a utility class
*/
private Applications() {}
/**
* Gets a cursor with application search results.
* See {@link ApplicationColumns} for the columns available in the returned cursor.
*/
public static Cursor search(ContentResolver resolver, String query) {
Uri searchUri = CONTENT_URI.buildUpon().appendPath(SEARCH_PATH).appendPath(query).build();
return resolver.query(searchUri, null, null, null, null);
}
/**
* Increases the launch count of an application. Launch counts are used
* by the ApplicationsProvider to improve ranking.
*/
public static void increaseLaunchCount(
final ContentResolver resolver, final ComponentName componentName) {
ContentValues parameters = new ContentValues();
parameters.put(INCREASE_LAUNCH_COUNT_PACKAGE, componentName.getPackageName());
parameters.put(INCREASE_LAUNCH_COUNT_CLASS, componentName.getClassName());
resolver.insert(INCREASE_LAUNCH_COUNT_URI, parameters);
}
/**
* Gets the application component name from an application URI.
*
* @param appUri A URI of the form
* "content://applications/applications/<packageName>/<className>".
* @return The component name for the application, or
* <code>null</code> if the given URI was <code>null</code>
* or malformed.
*/
public static ComponentName uriToComponentName(Uri appUri) {
if (appUri == null) return null;
if (!ContentResolver.SCHEME_CONTENT.equals(appUri.getScheme())) return null;
if (!AUTHORITY.equals(appUri.getAuthority())) return null;
List<String> pathSegments = appUri.getPathSegments();
if (pathSegments.size() != 3) return null;
if (!APPLICATION_PATH.equals(pathSegments.get(0))) return null;
String packageName = pathSegments.get(1);
String name = pathSegments.get(2);
return new ComponentName(packageName, name);
}
/**
* Gets the URI for an application component.
*
* @param packageName The name of the application's package.
* @param className The class name of the application.
* @return A URI of the form
* "content://applications/applications/<packageName>/<className>".
*/
public static Uri componentNameToUri(String packageName, String className) {
return Applications.CONTENT_URI.buildUpon()
.appendEncodedPath(APPLICATION_PATH)
.appendPath(packageName)
.appendPath(className)
.build();
}
/**
* The columns in application cursors, like those returned by
* {@link Applications#search(ContentResolver, String)}.
*/
public interface ApplicationColumns extends BaseColumns {
public static final String NAME = "name";
public static final String ICON = "icon";
public static final String URI = "uri";
}
}
|
