Intent.java revision 318abc932467485e191578a923baba2ed40834f0
1/*
2 * Copyright (C) 2006 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.content;
18
19import static android.content.ContentProvider.maybeAddUserId;
20
21import android.annotation.AnyRes;
22import android.annotation.BroadcastBehavior;
23import android.annotation.IntDef;
24import android.annotation.NonNull;
25import android.annotation.Nullable;
26import android.annotation.SdkConstant;
27import android.annotation.SdkConstant.SdkConstantType;
28import android.annotation.SystemApi;
29import android.content.pm.ActivityInfo;
30import android.content.pm.ApplicationInfo;
31import android.content.pm.ComponentInfo;
32import android.content.pm.PackageManager;
33import android.content.pm.ResolveInfo;
34import android.content.res.Resources;
35import android.content.res.TypedArray;
36import android.graphics.Rect;
37import android.net.Uri;
38import android.os.Build;
39import android.os.Bundle;
40import android.os.IBinder;
41import android.os.Parcel;
42import android.os.Parcelable;
43import android.os.PersistableBundle;
44import android.os.Process;
45import android.os.ResultReceiver;
46import android.os.ShellCommand;
47import android.os.StrictMode;
48import android.os.UserHandle;
49import android.provider.ContactsContract.QuickContact;
50import android.provider.DocumentsContract;
51import android.provider.DocumentsProvider;
52import android.provider.MediaStore;
53import android.provider.OpenableColumns;
54import android.text.TextUtils;
55import android.util.ArraySet;
56import android.util.AttributeSet;
57import android.util.Log;
58import android.util.proto.ProtoOutputStream;
59
60import com.android.internal.util.XmlUtils;
61
62import org.xmlpull.v1.XmlPullParser;
63import org.xmlpull.v1.XmlPullParserException;
64import org.xmlpull.v1.XmlSerializer;
65
66import java.io.IOException;
67import java.io.PrintWriter;
68import java.io.Serializable;
69import java.lang.annotation.Retention;
70import java.lang.annotation.RetentionPolicy;
71import java.net.URISyntaxException;
72import java.util.ArrayList;
73import java.util.HashSet;
74import java.util.List;
75import java.util.Locale;
76import java.util.Objects;
77import java.util.Set;
78
79/**
80 * An intent is an abstract description of an operation to be performed.  It
81 * can be used with {@link Context#startActivity(Intent) startActivity} to
82 * launch an {@link android.app.Activity},
83 * {@link android.content.Context#sendBroadcast(Intent) broadcastIntent} to
84 * send it to any interested {@link BroadcastReceiver BroadcastReceiver} components,
85 * and {@link android.content.Context#startService} or
86 * {@link android.content.Context#bindService} to communicate with a
87 * background {@link android.app.Service}.
88 *
89 * <p>An Intent provides a facility for performing late runtime binding between the code in
90 * different applications. Its most significant use is in the launching of activities, where it
91 * can be thought of as the glue between activities. It is basically a passive data structure
92 * holding an abstract description of an action to be performed.</p>
93 *
94 * <div class="special reference">
95 * <h3>Developer Guides</h3>
96 * <p>For information about how to create and resolve intents, read the
97 * <a href="{@docRoot}guide/topics/intents/intents-filters.html">Intents and Intent Filters</a>
98 * developer guide.</p>
99 * </div>
100 *
101 * <a name="IntentStructure"></a>
102 * <h3>Intent Structure</h3>
103 * <p>The primary pieces of information in an intent are:</p>
104 *
105 * <ul>
106 *   <li> <p><b>action</b> -- The general action to be performed, such as
107 *     {@link #ACTION_VIEW}, {@link #ACTION_EDIT}, {@link #ACTION_MAIN},
108 *     etc.</p>
109 *   </li>
110 *   <li> <p><b>data</b> -- The data to operate on, such as a person record
111 *     in the contacts database, expressed as a {@link android.net.Uri}.</p>
112 *   </li>
113 * </ul>
114 *
115 *
116 * <p>Some examples of action/data pairs are:</p>
117 *
118 * <ul>
119 *   <li> <p><b>{@link #ACTION_VIEW} <i>content://contacts/people/1</i></b> -- Display
120 *     information about the person whose identifier is "1".</p>
121 *   </li>
122 *   <li> <p><b>{@link #ACTION_DIAL} <i>content://contacts/people/1</i></b> -- Display
123 *     the phone dialer with the person filled in.</p>
124 *   </li>
125 *   <li> <p><b>{@link #ACTION_VIEW} <i>tel:123</i></b> -- Display
126 *     the phone dialer with the given number filled in.  Note how the
127 *     VIEW action does what is considered the most reasonable thing for
128 *     a particular URI.</p>
129 *   </li>
130 *   <li> <p><b>{@link #ACTION_DIAL} <i>tel:123</i></b> -- Display
131 *     the phone dialer with the given number filled in.</p>
132 *   </li>
133 *   <li> <p><b>{@link #ACTION_EDIT} <i>content://contacts/people/1</i></b> -- Edit
134 *     information about the person whose identifier is "1".</p>
135 *   </li>
136 *   <li> <p><b>{@link #ACTION_VIEW} <i>content://contacts/people/</i></b> -- Display
137 *     a list of people, which the user can browse through.  This example is a
138 *     typical top-level entry into the Contacts application, showing you the
139 *     list of people. Selecting a particular person to view would result in a
140 *     new intent { <b>{@link #ACTION_VIEW} <i>content://contacts/people/N</i></b> }
141 *     being used to start an activity to display that person.</p>
142 *   </li>
143 * </ul>
144 *
145 * <p>In addition to these primary attributes, there are a number of secondary
146 * attributes that you can also include with an intent:</p>
147 *
148 * <ul>
149 *     <li> <p><b>category</b> -- Gives additional information about the action
150 *         to execute.  For example, {@link #CATEGORY_LAUNCHER} means it should
151 *         appear in the Launcher as a top-level application, while
152 *         {@link #CATEGORY_ALTERNATIVE} means it should be included in a list
153 *         of alternative actions the user can perform on a piece of data.</p>
154 *     <li> <p><b>type</b> -- Specifies an explicit type (a MIME type) of the
155 *         intent data.  Normally the type is inferred from the data itself.
156 *         By setting this attribute, you disable that evaluation and force
157 *         an explicit type.</p>
158 *     <li> <p><b>component</b> -- Specifies an explicit name of a component
159 *         class to use for the intent.  Normally this is determined by looking
160 *         at the other information in the intent (the action, data/type, and
161 *         categories) and matching that with a component that can handle it.
162 *         If this attribute is set then none of the evaluation is performed,
163 *         and this component is used exactly as is.  By specifying this attribute,
164 *         all of the other Intent attributes become optional.</p>
165 *     <li> <p><b>extras</b> -- This is a {@link Bundle} of any additional information.
166 *         This can be used to provide extended information to the component.
167 *         For example, if we have a action to send an e-mail message, we could
168 *         also include extra pieces of data here to supply a subject, body,
169 *         etc.</p>
170 * </ul>
171 *
172 * <p>Here are some examples of other operations you can specify as intents
173 * using these additional parameters:</p>
174 *
175 * <ul>
176 *   <li> <p><b>{@link #ACTION_MAIN} with category {@link #CATEGORY_HOME}</b> --
177 *     Launch the home screen.</p>
178 *   </li>
179 *   <li> <p><b>{@link #ACTION_GET_CONTENT} with MIME type
180 *     <i>{@link android.provider.Contacts.Phones#CONTENT_URI
181 *     vnd.android.cursor.item/phone}</i></b>
182 *     -- Display the list of people's phone numbers, allowing the user to
183 *     browse through them and pick one and return it to the parent activity.</p>
184 *   </li>
185 *   <li> <p><b>{@link #ACTION_GET_CONTENT} with MIME type
186 *     <i>*{@literal /}*</i> and category {@link #CATEGORY_OPENABLE}</b>
187 *     -- Display all pickers for data that can be opened with
188 *     {@link ContentResolver#openInputStream(Uri) ContentResolver.openInputStream()},
189 *     allowing the user to pick one of them and then some data inside of it
190 *     and returning the resulting URI to the caller.  This can be used,
191 *     for example, in an e-mail application to allow the user to pick some
192 *     data to include as an attachment.</p>
193 *   </li>
194 * </ul>
195 *
196 * <p>There are a variety of standard Intent action and category constants
197 * defined in the Intent class, but applications can also define their own.
198 * These strings use Java-style scoping, to ensure they are unique -- for
199 * example, the standard {@link #ACTION_VIEW} is called
200 * "android.intent.action.VIEW".</p>
201 *
202 * <p>Put together, the set of actions, data types, categories, and extra data
203 * defines a language for the system allowing for the expression of phrases
204 * such as "call john smith's cell".  As applications are added to the system,
205 * they can extend this language by adding new actions, types, and categories, or
206 * they can modify the behavior of existing phrases by supplying their own
207 * activities that handle them.</p>
208 *
209 * <a name="IntentResolution"></a>
210 * <h3>Intent Resolution</h3>
211 *
212 * <p>There are two primary forms of intents you will use.
213 *
214 * <ul>
215 *     <li> <p><b>Explicit Intents</b> have specified a component (via
216 *     {@link #setComponent} or {@link #setClass}), which provides the exact
217 *     class to be run.  Often these will not include any other information,
218 *     simply being a way for an application to launch various internal
219 *     activities it has as the user interacts with the application.
220 *
221 *     <li> <p><b>Implicit Intents</b> have not specified a component;
222 *     instead, they must include enough information for the system to
223 *     determine which of the available components is best to run for that
224 *     intent.
225 * </ul>
226 *
227 * <p>When using implicit intents, given such an arbitrary intent we need to
228 * know what to do with it. This is handled by the process of <em>Intent
229 * resolution</em>, which maps an Intent to an {@link android.app.Activity},
230 * {@link BroadcastReceiver}, or {@link android.app.Service} (or sometimes two or
231 * more activities/receivers) that can handle it.</p>
232 *
233 * <p>The intent resolution mechanism basically revolves around matching an
234 * Intent against all of the &lt;intent-filter&gt; descriptions in the
235 * installed application packages.  (Plus, in the case of broadcasts, any {@link BroadcastReceiver}
236 * objects explicitly registered with {@link Context#registerReceiver}.)  More
237 * details on this can be found in the documentation on the {@link
238 * IntentFilter} class.</p>
239 *
240 * <p>There are three pieces of information in the Intent that are used for
241 * resolution: the action, type, and category.  Using this information, a query
242 * is done on the {@link PackageManager} for a component that can handle the
243 * intent. The appropriate component is determined based on the intent
244 * information supplied in the <code>AndroidManifest.xml</code> file as
245 * follows:</p>
246 *
247 * <ul>
248 *     <li> <p>The <b>action</b>, if given, must be listed by the component as
249 *         one it handles.</p>
250 *     <li> <p>The <b>type</b> is retrieved from the Intent's data, if not
251 *         already supplied in the Intent.  Like the action, if a type is
252 *         included in the intent (either explicitly or implicitly in its
253 *         data), then this must be listed by the component as one it handles.</p>
254 *     <li> For data that is not a <code>content:</code> URI and where no explicit
255 *         type is included in the Intent, instead the <b>scheme</b> of the
256 *         intent data (such as <code>http:</code> or <code>mailto:</code>) is
257 *         considered. Again like the action, if we are matching a scheme it
258 *         must be listed by the component as one it can handle.
259 *     <li> <p>The <b>categories</b>, if supplied, must <em>all</em> be listed
260 *         by the activity as categories it handles.  That is, if you include
261 *         the categories {@link #CATEGORY_LAUNCHER} and
262 *         {@link #CATEGORY_ALTERNATIVE}, then you will only resolve to components
263 *         with an intent that lists <em>both</em> of those categories.
264 *         Activities will very often need to support the
265 *         {@link #CATEGORY_DEFAULT} so that they can be found by
266 *         {@link Context#startActivity Context.startActivity()}.</p>
267 * </ul>
268 *
269 * <p>For example, consider the Note Pad sample application that
270 * allows a user to browse through a list of notes data and view details about
271 * individual items.  Text in italics indicates places where you would replace a
272 * name with one specific to your own package.</p>
273 *
274 * <pre> &lt;manifest xmlns:android="http://schemas.android.com/apk/res/android"
275 *       package="<i>com.android.notepad</i>"&gt;
276 *     &lt;application android:icon="@drawable/app_notes"
277 *             android:label="@string/app_name"&gt;
278 *
279 *         &lt;provider class=".NotePadProvider"
280 *                 android:authorities="<i>com.google.provider.NotePad</i>" /&gt;
281 *
282 *         &lt;activity class=".NotesList" android:label="@string/title_notes_list"&gt;
283 *             &lt;intent-filter&gt;
284 *                 &lt;action android:name="android.intent.action.MAIN" /&gt;
285 *                 &lt;category android:name="android.intent.category.LAUNCHER" /&gt;
286 *             &lt;/intent-filter&gt;
287 *             &lt;intent-filter&gt;
288 *                 &lt;action android:name="android.intent.action.VIEW" /&gt;
289 *                 &lt;action android:name="android.intent.action.EDIT" /&gt;
290 *                 &lt;action android:name="android.intent.action.PICK" /&gt;
291 *                 &lt;category android:name="android.intent.category.DEFAULT" /&gt;
292 *                 &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
293 *             &lt;/intent-filter&gt;
294 *             &lt;intent-filter&gt;
295 *                 &lt;action android:name="android.intent.action.GET_CONTENT" /&gt;
296 *                 &lt;category android:name="android.intent.category.DEFAULT" /&gt;
297 *                 &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
298 *             &lt;/intent-filter&gt;
299 *         &lt;/activity&gt;
300 *
301 *         &lt;activity class=".NoteEditor" android:label="@string/title_note"&gt;
302 *             &lt;intent-filter android:label="@string/resolve_edit"&gt;
303 *                 &lt;action android:name="android.intent.action.VIEW" /&gt;
304 *                 &lt;action android:name="android.intent.action.EDIT" /&gt;
305 *                 &lt;category android:name="android.intent.category.DEFAULT" /&gt;
306 *                 &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
307 *             &lt;/intent-filter&gt;
308 *
309 *             &lt;intent-filter&gt;
310 *                 &lt;action android:name="android.intent.action.INSERT" /&gt;
311 *                 &lt;category android:name="android.intent.category.DEFAULT" /&gt;
312 *                 &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
313 *             &lt;/intent-filter&gt;
314 *
315 *         &lt;/activity&gt;
316 *
317 *         &lt;activity class=".TitleEditor" android:label="@string/title_edit_title"
318 *                 android:theme="@android:style/Theme.Dialog"&gt;
319 *             &lt;intent-filter android:label="@string/resolve_title"&gt;
320 *                 &lt;action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" /&gt;
321 *                 &lt;category android:name="android.intent.category.DEFAULT" /&gt;
322 *                 &lt;category android:name="android.intent.category.ALTERNATIVE" /&gt;
323 *                 &lt;category android:name="android.intent.category.SELECTED_ALTERNATIVE" /&gt;
324 *                 &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
325 *             &lt;/intent-filter&gt;
326 *         &lt;/activity&gt;
327 *
328 *     &lt;/application&gt;
329 * &lt;/manifest&gt;</pre>
330 *
331 * <p>The first activity,
332 * <code>com.android.notepad.NotesList</code>, serves as our main
333 * entry into the app.  It can do three things as described by its three intent
334 * templates:
335 * <ol>
336 * <li><pre>
337 * &lt;intent-filter&gt;
338 *     &lt;action android:name="{@link #ACTION_MAIN android.intent.action.MAIN}" /&gt;
339 *     &lt;category android:name="{@link #CATEGORY_LAUNCHER android.intent.category.LAUNCHER}" /&gt;
340 * &lt;/intent-filter&gt;</pre>
341 * <p>This provides a top-level entry into the NotePad application: the standard
342 * MAIN action is a main entry point (not requiring any other information in
343 * the Intent), and the LAUNCHER category says that this entry point should be
344 * listed in the application launcher.</p>
345 * <li><pre>
346 * &lt;intent-filter&gt;
347 *     &lt;action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" /&gt;
348 *     &lt;action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" /&gt;
349 *     &lt;action android:name="{@link #ACTION_PICK android.intent.action.PICK}" /&gt;
350 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
351 *     &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
352 * &lt;/intent-filter&gt;</pre>
353 * <p>This declares the things that the activity can do on a directory of
354 * notes.  The type being supported is given with the &lt;type&gt; tag, where
355 * <code>vnd.android.cursor.dir/vnd.google.note</code> is a URI from which
356 * a Cursor of zero or more items (<code>vnd.android.cursor.dir</code>) can
357 * be retrieved which holds our note pad data (<code>vnd.google.note</code>).
358 * The activity allows the user to view or edit the directory of data (via
359 * the VIEW and EDIT actions), or to pick a particular note and return it
360 * to the caller (via the PICK action).  Note also the DEFAULT category
361 * supplied here: this is <em>required</em> for the
362 * {@link Context#startActivity Context.startActivity} method to resolve your
363 * activity when its component name is not explicitly specified.</p>
364 * <li><pre>
365 * &lt;intent-filter&gt;
366 *     &lt;action android:name="{@link #ACTION_GET_CONTENT android.intent.action.GET_CONTENT}" /&gt;
367 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
368 *     &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
369 * &lt;/intent-filter&gt;</pre>
370 * <p>This filter describes the ability to return to the caller a note selected by
371 * the user without needing to know where it came from.  The data type
372 * <code>vnd.android.cursor.item/vnd.google.note</code> is a URI from which
373 * a Cursor of exactly one (<code>vnd.android.cursor.item</code>) item can
374 * be retrieved which contains our note pad data (<code>vnd.google.note</code>).
375 * The GET_CONTENT action is similar to the PICK action, where the activity
376 * will return to its caller a piece of data selected by the user.  Here,
377 * however, the caller specifies the type of data they desire instead of
378 * the type of data the user will be picking from.</p>
379 * </ol>
380 *
381 * <p>Given these capabilities, the following intents will resolve to the
382 * NotesList activity:</p>
383 *
384 * <ul>
385 *     <li> <p><b>{ action=android.app.action.MAIN }</b> matches all of the
386 *         activities that can be used as top-level entry points into an
387 *         application.</p>
388 *     <li> <p><b>{ action=android.app.action.MAIN,
389 *         category=android.app.category.LAUNCHER }</b> is the actual intent
390 *         used by the Launcher to populate its top-level list.</p>
391 *     <li> <p><b>{ action=android.intent.action.VIEW
392 *          data=content://com.google.provider.NotePad/notes }</b>
393 *         displays a list of all the notes under
394 *         "content://com.google.provider.NotePad/notes", which
395 *         the user can browse through and see the details on.</p>
396 *     <li> <p><b>{ action=android.app.action.PICK
397 *          data=content://com.google.provider.NotePad/notes }</b>
398 *         provides a list of the notes under
399 *         "content://com.google.provider.NotePad/notes", from which
400 *         the user can pick a note whose data URL is returned back to the caller.</p>
401 *     <li> <p><b>{ action=android.app.action.GET_CONTENT
402 *          type=vnd.android.cursor.item/vnd.google.note }</b>
403 *         is similar to the pick action, but allows the caller to specify the
404 *         kind of data they want back so that the system can find the appropriate
405 *         activity to pick something of that data type.</p>
406 * </ul>
407 *
408 * <p>The second activity,
409 * <code>com.android.notepad.NoteEditor</code>, shows the user a single
410 * note entry and allows them to edit it.  It can do two things as described
411 * by its two intent templates:
412 * <ol>
413 * <li><pre>
414 * &lt;intent-filter android:label="@string/resolve_edit"&gt;
415 *     &lt;action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" /&gt;
416 *     &lt;action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" /&gt;
417 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
418 *     &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
419 * &lt;/intent-filter&gt;</pre>
420 * <p>The first, primary, purpose of this activity is to let the user interact
421 * with a single note, as decribed by the MIME type
422 * <code>vnd.android.cursor.item/vnd.google.note</code>.  The activity can
423 * either VIEW a note or allow the user to EDIT it.  Again we support the
424 * DEFAULT category to allow the activity to be launched without explicitly
425 * specifying its component.</p>
426 * <li><pre>
427 * &lt;intent-filter&gt;
428 *     &lt;action android:name="{@link #ACTION_INSERT android.intent.action.INSERT}" /&gt;
429 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
430 *     &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;
431 * &lt;/intent-filter&gt;</pre>
432 * <p>The secondary use of this activity is to insert a new note entry into
433 * an existing directory of notes.  This is used when the user creates a new
434 * note: the INSERT action is executed on the directory of notes, causing
435 * this activity to run and have the user create the new note data which
436 * it then adds to the content provider.</p>
437 * </ol>
438 *
439 * <p>Given these capabilities, the following intents will resolve to the
440 * NoteEditor activity:</p>
441 *
442 * <ul>
443 *     <li> <p><b>{ action=android.intent.action.VIEW
444 *          data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
445 *         shows the user the content of note <var>{ID}</var>.</p>
446 *     <li> <p><b>{ action=android.app.action.EDIT
447 *          data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
448 *         allows the user to edit the content of note <var>{ID}</var>.</p>
449 *     <li> <p><b>{ action=android.app.action.INSERT
450 *          data=content://com.google.provider.NotePad/notes }</b>
451 *         creates a new, empty note in the notes list at
452 *         "content://com.google.provider.NotePad/notes"
453 *         and allows the user to edit it.  If they keep their changes, the URI
454 *         of the newly created note is returned to the caller.</p>
455 * </ul>
456 *
457 * <p>The last activity,
458 * <code>com.android.notepad.TitleEditor</code>, allows the user to
459 * edit the title of a note.  This could be implemented as a class that the
460 * application directly invokes (by explicitly setting its component in
461 * the Intent), but here we show a way you can publish alternative
462 * operations on existing data:</p>
463 *
464 * <pre>
465 * &lt;intent-filter android:label="@string/resolve_title"&gt;
466 *     &lt;action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" /&gt;
467 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;
468 *     &lt;category android:name="{@link #CATEGORY_ALTERNATIVE android.intent.category.ALTERNATIVE}" /&gt;
469 *     &lt;category android:name="{@link #CATEGORY_SELECTED_ALTERNATIVE android.intent.category.SELECTED_ALTERNATIVE}" /&gt;
470 *     &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;
471 * &lt;/intent-filter&gt;</pre>
472 *
473 * <p>In the single intent template here, we
474 * have created our own private action called
475 * <code>com.android.notepad.action.EDIT_TITLE</code> which means to
476 * edit the title of a note.  It must be invoked on a specific note
477 * (data type <code>vnd.android.cursor.item/vnd.google.note</code>) like the previous
478 * view and edit actions, but here displays and edits the title contained
479 * in the note data.
480 *
481 * <p>In addition to supporting the default category as usual, our title editor
482 * also supports two other standard categories: ALTERNATIVE and
483 * SELECTED_ALTERNATIVE.  Implementing
484 * these categories allows others to find the special action it provides
485 * without directly knowing about it, through the
486 * {@link android.content.pm.PackageManager#queryIntentActivityOptions} method, or
487 * more often to build dynamic menu items with
488 * {@link android.view.Menu#addIntentOptions}.  Note that in the intent
489 * template here was also supply an explicit name for the template
490 * (via <code>android:label="@string/resolve_title"</code>) to better control
491 * what the user sees when presented with this activity as an alternative
492 * action to the data they are viewing.
493 *
494 * <p>Given these capabilities, the following intent will resolve to the
495 * TitleEditor activity:</p>
496 *
497 * <ul>
498 *     <li> <p><b>{ action=com.android.notepad.action.EDIT_TITLE
499 *          data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
500 *         displays and allows the user to edit the title associated
501 *         with note <var>{ID}</var>.</p>
502 * </ul>
503 *
504 * <h3>Standard Activity Actions</h3>
505 *
506 * <p>These are the current standard actions that Intent defines for launching
507 * activities (usually through {@link Context#startActivity}.  The most
508 * important, and by far most frequently used, are {@link #ACTION_MAIN} and
509 * {@link #ACTION_EDIT}.
510 *
511 * <ul>
512 *     <li> {@link #ACTION_MAIN}
513 *     <li> {@link #ACTION_VIEW}
514 *     <li> {@link #ACTION_ATTACH_DATA}
515 *     <li> {@link #ACTION_EDIT}
516 *     <li> {@link #ACTION_PICK}
517 *     <li> {@link #ACTION_CHOOSER}
518 *     <li> {@link #ACTION_GET_CONTENT}
519 *     <li> {@link #ACTION_DIAL}
520 *     <li> {@link #ACTION_CALL}
521 *     <li> {@link #ACTION_SEND}
522 *     <li> {@link #ACTION_SENDTO}
523 *     <li> {@link #ACTION_ANSWER}
524 *     <li> {@link #ACTION_INSERT}
525 *     <li> {@link #ACTION_DELETE}
526 *     <li> {@link #ACTION_RUN}
527 *     <li> {@link #ACTION_SYNC}
528 *     <li> {@link #ACTION_PICK_ACTIVITY}
529 *     <li> {@link #ACTION_SEARCH}
530 *     <li> {@link #ACTION_WEB_SEARCH}
531 *     <li> {@link #ACTION_FACTORY_TEST}
532 * </ul>
533 *
534 * <h3>Standard Broadcast Actions</h3>
535 *
536 * <p>These are the current standard actions that Intent defines for receiving
537 * broadcasts (usually through {@link Context#registerReceiver} or a
538 * &lt;receiver&gt; tag in a manifest).
539 *
540 * <ul>
541 *     <li> {@link #ACTION_TIME_TICK}
542 *     <li> {@link #ACTION_TIME_CHANGED}
543 *     <li> {@link #ACTION_TIMEZONE_CHANGED}
544 *     <li> {@link #ACTION_BOOT_COMPLETED}
545 *     <li> {@link #ACTION_PACKAGE_ADDED}
546 *     <li> {@link #ACTION_PACKAGE_CHANGED}
547 *     <li> {@link #ACTION_PACKAGE_REMOVED}
548 *     <li> {@link #ACTION_PACKAGE_RESTARTED}
549 *     <li> {@link #ACTION_PACKAGE_DATA_CLEARED}
550 *     <li> {@link #ACTION_PACKAGES_SUSPENDED}
551 *     <li> {@link #ACTION_PACKAGES_UNSUSPENDED}
552 *     <li> {@link #ACTION_UID_REMOVED}
553 *     <li> {@link #ACTION_BATTERY_CHANGED}
554 *     <li> {@link #ACTION_POWER_CONNECTED}
555 *     <li> {@link #ACTION_POWER_DISCONNECTED}
556 *     <li> {@link #ACTION_SHUTDOWN}
557 * </ul>
558 *
559 * <h3>Standard Categories</h3>
560 *
561 * <p>These are the current standard categories that can be used to further
562 * clarify an Intent via {@link #addCategory}.
563 *
564 * <ul>
565 *     <li> {@link #CATEGORY_DEFAULT}
566 *     <li> {@link #CATEGORY_BROWSABLE}
567 *     <li> {@link #CATEGORY_TAB}
568 *     <li> {@link #CATEGORY_ALTERNATIVE}
569 *     <li> {@link #CATEGORY_SELECTED_ALTERNATIVE}
570 *     <li> {@link #CATEGORY_LAUNCHER}
571 *     <li> {@link #CATEGORY_INFO}
572 *     <li> {@link #CATEGORY_HOME}
573 *     <li> {@link #CATEGORY_PREFERENCE}
574 *     <li> {@link #CATEGORY_TEST}
575 *     <li> {@link #CATEGORY_CAR_DOCK}
576 *     <li> {@link #CATEGORY_DESK_DOCK}
577 *     <li> {@link #CATEGORY_LE_DESK_DOCK}
578 *     <li> {@link #CATEGORY_HE_DESK_DOCK}
579 *     <li> {@link #CATEGORY_CAR_MODE}
580 *     <li> {@link #CATEGORY_APP_MARKET}
581 *     <li> {@link #CATEGORY_VR_HOME}
582 * </ul>
583 *
584 * <h3>Standard Extra Data</h3>
585 *
586 * <p>These are the current standard fields that can be used as extra data via
587 * {@link #putExtra}.
588 *
589 * <ul>
590 *     <li> {@link #EXTRA_ALARM_COUNT}
591 *     <li> {@link #EXTRA_BCC}
592 *     <li> {@link #EXTRA_CC}
593 *     <li> {@link #EXTRA_CHANGED_COMPONENT_NAME}
594 *     <li> {@link #EXTRA_DATA_REMOVED}
595 *     <li> {@link #EXTRA_DOCK_STATE}
596 *     <li> {@link #EXTRA_DOCK_STATE_HE_DESK}
597 *     <li> {@link #EXTRA_DOCK_STATE_LE_DESK}
598 *     <li> {@link #EXTRA_DOCK_STATE_CAR}
599 *     <li> {@link #EXTRA_DOCK_STATE_DESK}
600 *     <li> {@link #EXTRA_DOCK_STATE_UNDOCKED}
601 *     <li> {@link #EXTRA_DONT_KILL_APP}
602 *     <li> {@link #EXTRA_EMAIL}
603 *     <li> {@link #EXTRA_INITIAL_INTENTS}
604 *     <li> {@link #EXTRA_INTENT}
605 *     <li> {@link #EXTRA_KEY_EVENT}
606 *     <li> {@link #EXTRA_ORIGINATING_URI}
607 *     <li> {@link #EXTRA_PHONE_NUMBER}
608 *     <li> {@link #EXTRA_REFERRER}
609 *     <li> {@link #EXTRA_REMOTE_INTENT_TOKEN}
610 *     <li> {@link #EXTRA_REPLACING}
611 *     <li> {@link #EXTRA_SHORTCUT_ICON}
612 *     <li> {@link #EXTRA_SHORTCUT_ICON_RESOURCE}
613 *     <li> {@link #EXTRA_SHORTCUT_INTENT}
614 *     <li> {@link #EXTRA_STREAM}
615 *     <li> {@link #EXTRA_SHORTCUT_NAME}
616 *     <li> {@link #EXTRA_SUBJECT}
617 *     <li> {@link #EXTRA_TEMPLATE}
618 *     <li> {@link #EXTRA_TEXT}
619 *     <li> {@link #EXTRA_TITLE}
620 *     <li> {@link #EXTRA_UID}
621 * </ul>
622 *
623 * <h3>Flags</h3>
624 *
625 * <p>These are the possible flags that can be used in the Intent via
626 * {@link #setFlags} and {@link #addFlags}.  See {@link #setFlags} for a list
627 * of all possible flags.
628 */
629public class Intent implements Parcelable, Cloneable {
630    private static final String ATTR_ACTION = "action";
631    private static final String TAG_CATEGORIES = "categories";
632    private static final String ATTR_CATEGORY = "category";
633    private static final String TAG_EXTRA = "extra";
634    private static final String ATTR_TYPE = "type";
635    private static final String ATTR_COMPONENT = "component";
636    private static final String ATTR_DATA = "data";
637    private static final String ATTR_FLAGS = "flags";
638
639    // ---------------------------------------------------------------------
640    // ---------------------------------------------------------------------
641    // Standard intent activity actions (see action variable).
642
643    /**
644     *  Activity Action: Start as a main entry point, does not expect to
645     *  receive data.
646     *  <p>Input: nothing
647     *  <p>Output: nothing
648     */
649    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
650    public static final String ACTION_MAIN = "android.intent.action.MAIN";
651
652    /**
653     * Activity Action: Display the data to the user.  This is the most common
654     * action performed on data -- it is the generic action you can use on
655     * a piece of data to get the most reasonable thing to occur.  For example,
656     * when used on a contacts entry it will view the entry; when used on a
657     * mailto: URI it will bring up a compose window filled with the information
658     * supplied by the URI; when used with a tel: URI it will invoke the
659     * dialer.
660     * <p>Input: {@link #getData} is URI from which to retrieve data.
661     * <p>Output: nothing.
662     */
663    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
664    public static final String ACTION_VIEW = "android.intent.action.VIEW";
665
666    /**
667     * Extra that can be included on activity intents coming from the storage UI
668     * when it launches sub-activities to manage various types of storage.  For example,
669     * it may use {@link #ACTION_VIEW} with a "image/*" MIME type to have an app show
670     * the images on the device, and in that case also include this extra to tell the
671     * app it is coming from the storage UI so should help the user manage storage of
672     * this type.
673     */
674    public static final String EXTRA_FROM_STORAGE = "android.intent.extra.FROM_STORAGE";
675
676    /**
677     * A synonym for {@link #ACTION_VIEW}, the "standard" action that is
678     * performed on a piece of data.
679     */
680    public static final String ACTION_DEFAULT = ACTION_VIEW;
681
682    /**
683     * Activity Action: Quick view the data. Launches a quick viewer for
684     * a URI or a list of URIs.
685     * <p>Activities handling this intent action should handle the vast majority of
686     * MIME types rather than only specific ones.
687     * <p>Quick viewers must render the quick view image locally, and must not send
688     * file content outside current device.
689     * <p>Input: {@link #getData} is a mandatory content URI of the item to
690     * preview. {@link #getClipData} contains an optional list of content URIs
691     * if there is more than one item to preview. {@link #EXTRA_INDEX} is an
692     * optional index of the URI in the clip data to show first.
693     * {@link #EXTRA_QUICK_VIEW_FEATURES} is an optional extra indicating the features
694     * that can be shown in the quick view UI.
695     * <p>Output: nothing.
696     * @see #EXTRA_INDEX
697     * @see #EXTRA_QUICK_VIEW_FEATURES
698     */
699    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
700    public static final String ACTION_QUICK_VIEW = "android.intent.action.QUICK_VIEW";
701
702    /**
703     * Used to indicate that some piece of data should be attached to some other
704     * place.  For example, image data could be attached to a contact.  It is up
705     * to the recipient to decide where the data should be attached; the intent
706     * does not specify the ultimate destination.
707     * <p>Input: {@link #getData} is URI of data to be attached.
708     * <p>Output: nothing.
709     */
710    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
711    public static final String ACTION_ATTACH_DATA = "android.intent.action.ATTACH_DATA";
712
713    /**
714     * Activity Action: Provide explicit editable access to the given data.
715     * <p>Input: {@link #getData} is URI of data to be edited.
716     * <p>Output: nothing.
717     */
718    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
719    public static final String ACTION_EDIT = "android.intent.action.EDIT";
720
721    /**
722     * Activity Action: Pick an existing item, or insert a new item, and then edit it.
723     * <p>Input: {@link #getType} is the desired MIME type of the item to create or edit.
724     * The extras can contain type specific data to pass through to the editing/creating
725     * activity.
726     * <p>Output: The URI of the item that was picked.  This must be a content:
727     * URI so that any receiver can access it.
728     */
729    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
730    public static final String ACTION_INSERT_OR_EDIT = "android.intent.action.INSERT_OR_EDIT";
731
732    /**
733     * Activity Action: Pick an item from the data, returning what was selected.
734     * <p>Input: {@link #getData} is URI containing a directory of data
735     * (vnd.android.cursor.dir/*) from which to pick an item.
736     * <p>Output: The URI of the item that was picked.
737     */
738    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
739    public static final String ACTION_PICK = "android.intent.action.PICK";
740
741    /**
742     * Activity Action: Creates a shortcut.
743     * <p>Input: Nothing.</p>
744     * <p>Output: An Intent representing the {@link android.content.pm.ShortcutInfo} result.</p>
745     * <p>For compatibility with older versions of android the intent may also contain three
746     * extras: SHORTCUT_INTENT (value: Intent), SHORTCUT_NAME (value: String),
747     * and SHORTCUT_ICON (value: Bitmap) or SHORTCUT_ICON_RESOURCE
748     * (value: ShortcutIconResource).</p>
749     *
750     * @see android.content.pm.ShortcutManager#createShortcutResultIntent
751     * @see #EXTRA_SHORTCUT_INTENT
752     * @see #EXTRA_SHORTCUT_NAME
753     * @see #EXTRA_SHORTCUT_ICON
754     * @see #EXTRA_SHORTCUT_ICON_RESOURCE
755     * @see android.content.Intent.ShortcutIconResource
756     */
757    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
758    public static final String ACTION_CREATE_SHORTCUT = "android.intent.action.CREATE_SHORTCUT";
759
760    /**
761     * The name of the extra used to define the Intent of a shortcut.
762     *
763     * @see #ACTION_CREATE_SHORTCUT
764     * @deprecated Replaced with {@link android.content.pm.ShortcutManager#createShortcutResultIntent}
765     */
766    @Deprecated
767    public static final String EXTRA_SHORTCUT_INTENT = "android.intent.extra.shortcut.INTENT";
768    /**
769     * The name of the extra used to define the name of a shortcut.
770     *
771     * @see #ACTION_CREATE_SHORTCUT
772     * @deprecated Replaced with {@link android.content.pm.ShortcutManager#createShortcutResultIntent}
773     */
774    @Deprecated
775    public static final String EXTRA_SHORTCUT_NAME = "android.intent.extra.shortcut.NAME";
776    /**
777     * The name of the extra used to define the icon, as a Bitmap, of a shortcut.
778     *
779     * @see #ACTION_CREATE_SHORTCUT
780     * @deprecated Replaced with {@link android.content.pm.ShortcutManager#createShortcutResultIntent}
781     */
782    @Deprecated
783    public static final String EXTRA_SHORTCUT_ICON = "android.intent.extra.shortcut.ICON";
784    /**
785     * The name of the extra used to define the icon, as a ShortcutIconResource, of a shortcut.
786     *
787     * @see #ACTION_CREATE_SHORTCUT
788     * @see android.content.Intent.ShortcutIconResource
789     * @deprecated Replaced with {@link android.content.pm.ShortcutManager#createShortcutResultIntent}
790     */
791    @Deprecated
792    public static final String EXTRA_SHORTCUT_ICON_RESOURCE =
793            "android.intent.extra.shortcut.ICON_RESOURCE";
794
795    /**
796     * An activity that provides a user interface for adjusting application preferences.
797     * Optional but recommended settings for all applications which have settings.
798     */
799    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
800    public static final String ACTION_APPLICATION_PREFERENCES
801            = "android.intent.action.APPLICATION_PREFERENCES";
802
803    /**
804     * Activity Action: Launch an activity showing the app information.
805     * For applications which install other applications (such as app stores), it is recommended
806     * to handle this action for providing the app information to the user.
807     *
808     * <p>Input: {@link #EXTRA_PACKAGE_NAME} specifies the package whose information needs
809     * to be displayed.
810     * <p>Output: Nothing.
811     */
812    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
813    public static final String ACTION_SHOW_APP_INFO
814            = "android.intent.action.SHOW_APP_INFO";
815
816    /**
817     * Represents a shortcut/live folder icon resource.
818     *
819     * @see Intent#ACTION_CREATE_SHORTCUT
820     * @see Intent#EXTRA_SHORTCUT_ICON_RESOURCE
821     * @see android.provider.LiveFolders#ACTION_CREATE_LIVE_FOLDER
822     * @see android.provider.LiveFolders#EXTRA_LIVE_FOLDER_ICON
823     */
824    public static class ShortcutIconResource implements Parcelable {
825        /**
826         * The package name of the application containing the icon.
827         */
828        public String packageName;
829
830        /**
831         * The resource name of the icon, including package, name and type.
832         */
833        public String resourceName;
834
835        /**
836         * Creates a new ShortcutIconResource for the specified context and resource
837         * identifier.
838         *
839         * @param context The context of the application.
840         * @param resourceId The resource identifier for the icon.
841         * @return A new ShortcutIconResource with the specified's context package name
842         *         and icon resource identifier.``
843         */
844        public static ShortcutIconResource fromContext(Context context, @AnyRes int resourceId) {
845            ShortcutIconResource icon = new ShortcutIconResource();
846            icon.packageName = context.getPackageName();
847            icon.resourceName = context.getResources().getResourceName(resourceId);
848            return icon;
849        }
850
851        /**
852         * Used to read a ShortcutIconResource from a Parcel.
853         */
854        public static final Parcelable.Creator<ShortcutIconResource> CREATOR =
855            new Parcelable.Creator<ShortcutIconResource>() {
856
857                public ShortcutIconResource createFromParcel(Parcel source) {
858                    ShortcutIconResource icon = new ShortcutIconResource();
859                    icon.packageName = source.readString();
860                    icon.resourceName = source.readString();
861                    return icon;
862                }
863
864                public ShortcutIconResource[] newArray(int size) {
865                    return new ShortcutIconResource[size];
866                }
867            };
868
869        /**
870         * No special parcel contents.
871         */
872        public int describeContents() {
873            return 0;
874        }
875
876        public void writeToParcel(Parcel dest, int flags) {
877            dest.writeString(packageName);
878            dest.writeString(resourceName);
879        }
880
881        @Override
882        public String toString() {
883            return resourceName;
884        }
885    }
886
887    /**
888     * Activity Action: Display an activity chooser, allowing the user to pick
889     * what they want to before proceeding.  This can be used as an alternative
890     * to the standard activity picker that is displayed by the system when
891     * you try to start an activity with multiple possible matches, with these
892     * differences in behavior:
893     * <ul>
894     * <li>You can specify the title that will appear in the activity chooser.
895     * <li>The user does not have the option to make one of the matching
896     * activities a preferred activity, and all possible activities will
897     * always be shown even if one of them is currently marked as the
898     * preferred activity.
899     * </ul>
900     * <p>
901     * This action should be used when the user will naturally expect to
902     * select an activity in order to proceed.  An example if when not to use
903     * it is when the user clicks on a "mailto:" link.  They would naturally
904     * expect to go directly to their mail app, so startActivity() should be
905     * called directly: it will
906     * either launch the current preferred app, or put up a dialog allowing the
907     * user to pick an app to use and optionally marking that as preferred.
908     * <p>
909     * In contrast, if the user is selecting a menu item to send a picture
910     * they are viewing to someone else, there are many different things they
911     * may want to do at this point: send it through e-mail, upload it to a
912     * web service, etc.  In this case the CHOOSER action should be used, to
913     * always present to the user a list of the things they can do, with a
914     * nice title given by the caller such as "Send this photo with:".
915     * <p>
916     * If you need to grant URI permissions through a chooser, you must specify
917     * the permissions to be granted on the ACTION_CHOOSER Intent
918     * <em>in addition</em> to the EXTRA_INTENT inside.  This means using
919     * {@link #setClipData} to specify the URIs to be granted as well as
920     * {@link #FLAG_GRANT_READ_URI_PERMISSION} and/or
921     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION} as appropriate.
922     * <p>
923     * As a convenience, an Intent of this form can be created with the
924     * {@link #createChooser} function.
925     * <p>
926     * Input: No data should be specified.  get*Extra must have
927     * a {@link #EXTRA_INTENT} field containing the Intent being executed,
928     * and can optionally have a {@link #EXTRA_TITLE} field containing the
929     * title text to display in the chooser.
930     * <p>
931     * Output: Depends on the protocol of {@link #EXTRA_INTENT}.
932     */
933    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
934    public static final String ACTION_CHOOSER = "android.intent.action.CHOOSER";
935
936    /**
937     * Convenience function for creating a {@link #ACTION_CHOOSER} Intent.
938     *
939     * <p>Builds a new {@link #ACTION_CHOOSER} Intent that wraps the given
940     * target intent, also optionally supplying a title.  If the target
941     * intent has specified {@link #FLAG_GRANT_READ_URI_PERMISSION} or
942     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, then these flags will also be
943     * set in the returned chooser intent, with its ClipData set appropriately:
944     * either a direct reflection of {@link #getClipData()} if that is non-null,
945     * or a new ClipData built from {@link #getData()}.
946     *
947     * @param target The Intent that the user will be selecting an activity
948     * to perform.
949     * @param title Optional title that will be displayed in the chooser.
950     * @return Return a new Intent object that you can hand to
951     * {@link Context#startActivity(Intent) Context.startActivity()} and
952     * related methods.
953     */
954    public static Intent createChooser(Intent target, CharSequence title) {
955        return createChooser(target, title, null);
956    }
957
958    /**
959     * Convenience function for creating a {@link #ACTION_CHOOSER} Intent.
960     *
961     * <p>Builds a new {@link #ACTION_CHOOSER} Intent that wraps the given
962     * target intent, also optionally supplying a title.  If the target
963     * intent has specified {@link #FLAG_GRANT_READ_URI_PERMISSION} or
964     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, then these flags will also be
965     * set in the returned chooser intent, with its ClipData set appropriately:
966     * either a direct reflection of {@link #getClipData()} if that is non-null,
967     * or a new ClipData built from {@link #getData()}.</p>
968     *
969     * <p>The caller may optionally supply an {@link IntentSender} to receive a callback
970     * when the user makes a choice. This can be useful if the calling application wants
971     * to remember the last chosen target and surface it as a more prominent or one-touch
972     * affordance elsewhere in the UI for next time.</p>
973     *
974     * @param target The Intent that the user will be selecting an activity
975     * to perform.
976     * @param title Optional title that will be displayed in the chooser.
977     * @param sender Optional IntentSender to be called when a choice is made.
978     * @return Return a new Intent object that you can hand to
979     * {@link Context#startActivity(Intent) Context.startActivity()} and
980     * related methods.
981     */
982    public static Intent createChooser(Intent target, CharSequence title, IntentSender sender) {
983        Intent intent = new Intent(ACTION_CHOOSER);
984        intent.putExtra(EXTRA_INTENT, target);
985        if (title != null) {
986            intent.putExtra(EXTRA_TITLE, title);
987        }
988
989        if (sender != null) {
990            intent.putExtra(EXTRA_CHOSEN_COMPONENT_INTENT_SENDER, sender);
991        }
992
993        // Migrate any clip data and flags from target.
994        int permFlags = target.getFlags() & (FLAG_GRANT_READ_URI_PERMISSION
995                | FLAG_GRANT_WRITE_URI_PERMISSION | FLAG_GRANT_PERSISTABLE_URI_PERMISSION
996                | FLAG_GRANT_PREFIX_URI_PERMISSION);
997        if (permFlags != 0) {
998            ClipData targetClipData = target.getClipData();
999            if (targetClipData == null && target.getData() != null) {
1000                ClipData.Item item = new ClipData.Item(target.getData());
1001                String[] mimeTypes;
1002                if (target.getType() != null) {
1003                    mimeTypes = new String[] { target.getType() };
1004                } else {
1005                    mimeTypes = new String[] { };
1006                }
1007                targetClipData = new ClipData(null, mimeTypes, item);
1008            }
1009            if (targetClipData != null) {
1010                intent.setClipData(targetClipData);
1011                intent.addFlags(permFlags);
1012            }
1013        }
1014
1015        return intent;
1016    }
1017
1018    /**
1019     * Activity Action: Allow the user to select a particular kind of data and
1020     * return it.  This is different than {@link #ACTION_PICK} in that here we
1021     * just say what kind of data is desired, not a URI of existing data from
1022     * which the user can pick.  An ACTION_GET_CONTENT could allow the user to
1023     * create the data as it runs (for example taking a picture or recording a
1024     * sound), let them browse over the web and download the desired data,
1025     * etc.
1026     * <p>
1027     * There are two main ways to use this action: if you want a specific kind
1028     * of data, such as a person contact, you set the MIME type to the kind of
1029     * data you want and launch it with {@link Context#startActivity(Intent)}.
1030     * The system will then launch the best application to select that kind
1031     * of data for you.
1032     * <p>
1033     * You may also be interested in any of a set of types of content the user
1034     * can pick.  For example, an e-mail application that wants to allow the
1035     * user to add an attachment to an e-mail message can use this action to
1036     * bring up a list of all of the types of content the user can attach.
1037     * <p>
1038     * In this case, you should wrap the GET_CONTENT intent with a chooser
1039     * (through {@link #createChooser}), which will give the proper interface
1040     * for the user to pick how to send your data and allow you to specify
1041     * a prompt indicating what they are doing.  You will usually specify a
1042     * broad MIME type (such as image/* or {@literal *}/*), resulting in a
1043     * broad range of content types the user can select from.
1044     * <p>
1045     * When using such a broad GET_CONTENT action, it is often desirable to
1046     * only pick from data that can be represented as a stream.  This is
1047     * accomplished by requiring the {@link #CATEGORY_OPENABLE} in the Intent.
1048     * <p>
1049     * Callers can optionally specify {@link #EXTRA_LOCAL_ONLY} to request that
1050     * the launched content chooser only returns results representing data that
1051     * is locally available on the device.  For example, if this extra is set
1052     * to true then an image picker should not show any pictures that are available
1053     * from a remote server but not already on the local device (thus requiring
1054     * they be downloaded when opened).
1055     * <p>
1056     * If the caller can handle multiple returned items (the user performing
1057     * multiple selection), then it can specify {@link #EXTRA_ALLOW_MULTIPLE}
1058     * to indicate this.
1059     * <p>
1060     * Input: {@link #getType} is the desired MIME type to retrieve.  Note
1061     * that no URI is supplied in the intent, as there are no constraints on
1062     * where the returned data originally comes from.  You may also include the
1063     * {@link #CATEGORY_OPENABLE} if you can only accept data that can be
1064     * opened as a stream.  You may use {@link #EXTRA_LOCAL_ONLY} to limit content
1065     * selection to local data.  You may use {@link #EXTRA_ALLOW_MULTIPLE} to
1066     * allow the user to select multiple items.
1067     * <p>
1068     * Output: The URI of the item that was picked.  This must be a content:
1069     * URI so that any receiver can access it.
1070     */
1071    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1072    public static final String ACTION_GET_CONTENT = "android.intent.action.GET_CONTENT";
1073    /**
1074     * Activity Action: Dial a number as specified by the data.  This shows a
1075     * UI with the number being dialed, allowing the user to explicitly
1076     * initiate the call.
1077     * <p>Input: If nothing, an empty dialer is started; else {@link #getData}
1078     * is URI of a phone number to be dialed or a tel: URI of an explicit phone
1079     * number.
1080     * <p>Output: nothing.
1081     */
1082    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1083    public static final String ACTION_DIAL = "android.intent.action.DIAL";
1084    /**
1085     * Activity Action: Perform a call to someone specified by the data.
1086     * <p>Input: If nothing, an empty dialer is started; else {@link #getData}
1087     * is URI of a phone number to be dialed or a tel: URI of an explicit phone
1088     * number.
1089     * <p>Output: nothing.
1090     *
1091     * <p>Note: there will be restrictions on which applications can initiate a
1092     * call; most applications should use the {@link #ACTION_DIAL}.
1093     * <p>Note: this Intent <strong>cannot</strong> be used to call emergency
1094     * numbers.  Applications can <strong>dial</strong> emergency numbers using
1095     * {@link #ACTION_DIAL}, however.
1096     *
1097     * <p>Note: if you app targets {@link android.os.Build.VERSION_CODES#M M}
1098     * and above and declares as using the {@link android.Manifest.permission#CALL_PHONE}
1099     * permission which is not granted, then attempting to use this action will
1100     * result in a {@link java.lang.SecurityException}.
1101     */
1102    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1103    public static final String ACTION_CALL = "android.intent.action.CALL";
1104    /**
1105     * Activity Action: Perform a call to an emergency number specified by the
1106     * data.
1107     * <p>Input: {@link #getData} is URI of a phone number to be dialed or a
1108     * tel: URI of an explicit phone number.
1109     * <p>Output: nothing.
1110     * @hide
1111     */
1112    @SystemApi
1113    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1114    public static final String ACTION_CALL_EMERGENCY = "android.intent.action.CALL_EMERGENCY";
1115    /**
1116     * Activity action: Perform a call to any number (emergency or not)
1117     * specified by the data.
1118     * <p>Input: {@link #getData} is URI of a phone number to be dialed or a
1119     * tel: URI of an explicit phone number.
1120     * <p>Output: nothing.
1121     * @hide
1122     */
1123    @SystemApi
1124    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1125    public static final String ACTION_CALL_PRIVILEGED = "android.intent.action.CALL_PRIVILEGED";
1126
1127    /**
1128     * Activity Action: Main entry point for carrier setup apps.
1129     * <p>Carrier apps that provide an implementation for this action may be invoked to configure
1130     * carrier service and typically require
1131     * {@link android.telephony.TelephonyManager#hasCarrierPrivileges() carrier privileges} to
1132     * fulfill their duties.
1133     */
1134    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1135    public static final String ACTION_CARRIER_SETUP = "android.intent.action.CARRIER_SETUP";
1136    /**
1137     * Activity Action: Send a message to someone specified by the data.
1138     * <p>Input: {@link #getData} is URI describing the target.
1139     * <p>Output: nothing.
1140     */
1141    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1142    public static final String ACTION_SENDTO = "android.intent.action.SENDTO";
1143    /**
1144     * Activity Action: Deliver some data to someone else.  Who the data is
1145     * being delivered to is not specified; it is up to the receiver of this
1146     * action to ask the user where the data should be sent.
1147     * <p>
1148     * When launching a SEND intent, you should usually wrap it in a chooser
1149     * (through {@link #createChooser}), which will give the proper interface
1150     * for the user to pick how to send your data and allow you to specify
1151     * a prompt indicating what they are doing.
1152     * <p>
1153     * Input: {@link #getType} is the MIME type of the data being sent.
1154     * get*Extra can have either a {@link #EXTRA_TEXT}
1155     * or {@link #EXTRA_STREAM} field, containing the data to be sent.  If
1156     * using EXTRA_TEXT, the MIME type should be "text/plain"; otherwise it
1157     * should be the MIME type of the data in EXTRA_STREAM.  Use {@literal *}/*
1158     * if the MIME type is unknown (this will only allow senders that can
1159     * handle generic data streams).  If using {@link #EXTRA_TEXT}, you can
1160     * also optionally supply {@link #EXTRA_HTML_TEXT} for clients to retrieve
1161     * your text with HTML formatting.
1162     * <p>
1163     * As of {@link android.os.Build.VERSION_CODES#JELLY_BEAN}, the data
1164     * being sent can be supplied through {@link #setClipData(ClipData)}.  This
1165     * allows you to use {@link #FLAG_GRANT_READ_URI_PERMISSION} when sharing
1166     * content: URIs and other advanced features of {@link ClipData}.  If
1167     * using this approach, you still must supply the same data through the
1168     * {@link #EXTRA_TEXT} or {@link #EXTRA_STREAM} fields described below
1169     * for compatibility with old applications.  If you don't set a ClipData,
1170     * it will be copied there for you when calling {@link Context#startActivity(Intent)}.
1171     * <p>
1172     * Starting from {@link android.os.Build.VERSION_CODES#O}, if
1173     * {@link #CATEGORY_TYPED_OPENABLE} is passed, then the Uris passed in
1174     * either {@link #EXTRA_STREAM} or via {@link #setClipData(ClipData)} may
1175     * be openable only as asset typed files using
1176     * {@link ContentResolver#openTypedAssetFileDescriptor(Uri, String, Bundle)}.
1177     * <p>
1178     * Optional standard extras, which may be interpreted by some recipients as
1179     * appropriate, are: {@link #EXTRA_EMAIL}, {@link #EXTRA_CC},
1180     * {@link #EXTRA_BCC}, {@link #EXTRA_SUBJECT}.
1181     * <p>
1182     * Output: nothing.
1183     */
1184    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1185    public static final String ACTION_SEND = "android.intent.action.SEND";
1186    /**
1187     * Activity Action: Deliver multiple data to someone else.
1188     * <p>
1189     * Like {@link #ACTION_SEND}, except the data is multiple.
1190     * <p>
1191     * Input: {@link #getType} is the MIME type of the data being sent.
1192     * get*ArrayListExtra can have either a {@link #EXTRA_TEXT} or {@link
1193     * #EXTRA_STREAM} field, containing the data to be sent.  If using
1194     * {@link #EXTRA_TEXT}, you can also optionally supply {@link #EXTRA_HTML_TEXT}
1195     * for clients to retrieve your text with HTML formatting.
1196     * <p>
1197     * Multiple types are supported, and receivers should handle mixed types
1198     * whenever possible. The right way for the receiver to check them is to
1199     * use the content resolver on each URI. The intent sender should try to
1200     * put the most concrete mime type in the intent type, but it can fall
1201     * back to {@literal <type>/*} or {@literal *}/* as needed.
1202     * <p>
1203     * e.g. if you are sending image/jpg and image/jpg, the intent's type can
1204     * be image/jpg, but if you are sending image/jpg and image/png, then the
1205     * intent's type should be image/*.
1206     * <p>
1207     * As of {@link android.os.Build.VERSION_CODES#JELLY_BEAN}, the data
1208     * being sent can be supplied through {@link #setClipData(ClipData)}.  This
1209     * allows you to use {@link #FLAG_GRANT_READ_URI_PERMISSION} when sharing
1210     * content: URIs and other advanced features of {@link ClipData}.  If
1211     * using this approach, you still must supply the same data through the
1212     * {@link #EXTRA_TEXT} or {@link #EXTRA_STREAM} fields described below
1213     * for compatibility with old applications.  If you don't set a ClipData,
1214     * it will be copied there for you when calling {@link Context#startActivity(Intent)}.
1215     * <p>
1216     * Starting from {@link android.os.Build.VERSION_CODES#O}, if
1217     * {@link #CATEGORY_TYPED_OPENABLE} is passed, then the Uris passed in
1218     * either {@link #EXTRA_STREAM} or via {@link #setClipData(ClipData)} may
1219     * be openable only as asset typed files using
1220     * {@link ContentResolver#openTypedAssetFileDescriptor(Uri, String, Bundle)}.
1221     * <p>
1222     * Optional standard extras, which may be interpreted by some recipients as
1223     * appropriate, are: {@link #EXTRA_EMAIL}, {@link #EXTRA_CC},
1224     * {@link #EXTRA_BCC}, {@link #EXTRA_SUBJECT}.
1225     * <p>
1226     * Output: nothing.
1227     */
1228    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1229    public static final String ACTION_SEND_MULTIPLE = "android.intent.action.SEND_MULTIPLE";
1230    /**
1231     * Activity Action: Handle an incoming phone call.
1232     * <p>Input: nothing.
1233     * <p>Output: nothing.
1234     */
1235    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1236    public static final String ACTION_ANSWER = "android.intent.action.ANSWER";
1237    /**
1238     * Activity Action: Insert an empty item into the given container.
1239     * <p>Input: {@link #getData} is URI of the directory (vnd.android.cursor.dir/*)
1240     * in which to place the data.
1241     * <p>Output: URI of the new data that was created.
1242     */
1243    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1244    public static final String ACTION_INSERT = "android.intent.action.INSERT";
1245    /**
1246     * Activity Action: Create a new item in the given container, initializing it
1247     * from the current contents of the clipboard.
1248     * <p>Input: {@link #getData} is URI of the directory (vnd.android.cursor.dir/*)
1249     * in which to place the data.
1250     * <p>Output: URI of the new data that was created.
1251     */
1252    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1253    public static final String ACTION_PASTE = "android.intent.action.PASTE";
1254    /**
1255     * Activity Action: Delete the given data from its container.
1256     * <p>Input: {@link #getData} is URI of data to be deleted.
1257     * <p>Output: nothing.
1258     */
1259    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1260    public static final String ACTION_DELETE = "android.intent.action.DELETE";
1261    /**
1262     * Activity Action: Run the data, whatever that means.
1263     * <p>Input: ?  (Note: this is currently specific to the test harness.)
1264     * <p>Output: nothing.
1265     */
1266    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1267    public static final String ACTION_RUN = "android.intent.action.RUN";
1268    /**
1269     * Activity Action: Perform a data synchronization.
1270     * <p>Input: ?
1271     * <p>Output: ?
1272     */
1273    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1274    public static final String ACTION_SYNC = "android.intent.action.SYNC";
1275    /**
1276     * Activity Action: Pick an activity given an intent, returning the class
1277     * selected.
1278     * <p>Input: get*Extra field {@link #EXTRA_INTENT} is an Intent
1279     * used with {@link PackageManager#queryIntentActivities} to determine the
1280     * set of activities from which to pick.
1281     * <p>Output: Class name of the activity that was selected.
1282     */
1283    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1284    public static final String ACTION_PICK_ACTIVITY = "android.intent.action.PICK_ACTIVITY";
1285    /**
1286     * Activity Action: Perform a search.
1287     * <p>Input: {@link android.app.SearchManager#QUERY getStringExtra(SearchManager.QUERY)}
1288     * is the text to search for.  If empty, simply
1289     * enter your search results Activity with the search UI activated.
1290     * <p>Output: nothing.
1291     */
1292    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1293    public static final String ACTION_SEARCH = "android.intent.action.SEARCH";
1294    /**
1295     * Activity Action: Start the platform-defined tutorial
1296     * <p>Input: {@link android.app.SearchManager#QUERY getStringExtra(SearchManager.QUERY)}
1297     * is the text to search for.  If empty, simply
1298     * enter your search results Activity with the search UI activated.
1299     * <p>Output: nothing.
1300     */
1301    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1302    public static final String ACTION_SYSTEM_TUTORIAL = "android.intent.action.SYSTEM_TUTORIAL";
1303    /**
1304     * Activity Action: Perform a web search.
1305     * <p>
1306     * Input: {@link android.app.SearchManager#QUERY
1307     * getStringExtra(SearchManager.QUERY)} is the text to search for. If it is
1308     * a url starts with http or https, the site will be opened. If it is plain
1309     * text, Google search will be applied.
1310     * <p>
1311     * Output: nothing.
1312     */
1313    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1314    public static final String ACTION_WEB_SEARCH = "android.intent.action.WEB_SEARCH";
1315
1316    /**
1317     * Activity Action: Perform assist action.
1318     * <p>
1319     * Input: {@link #EXTRA_ASSIST_PACKAGE}, {@link #EXTRA_ASSIST_CONTEXT}, can provide
1320     * additional optional contextual information about where the user was when they
1321     * requested the assist; {@link #EXTRA_REFERRER} may be set with additional referrer
1322     * information.
1323     * Output: nothing.
1324     */
1325    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1326    public static final String ACTION_ASSIST = "android.intent.action.ASSIST";
1327
1328    /**
1329     * Activity Action: Perform voice assist action.
1330     * <p>
1331     * Input: {@link #EXTRA_ASSIST_PACKAGE}, {@link #EXTRA_ASSIST_CONTEXT}, can provide
1332     * additional optional contextual information about where the user was when they
1333     * requested the voice assist.
1334     * Output: nothing.
1335     * @hide
1336     */
1337    @SystemApi
1338    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1339    public static final String ACTION_VOICE_ASSIST = "android.intent.action.VOICE_ASSIST";
1340
1341    /**
1342     * An optional field on {@link #ACTION_ASSIST} containing the name of the current foreground
1343     * application package at the time the assist was invoked.
1344     */
1345    public static final String EXTRA_ASSIST_PACKAGE
1346            = "android.intent.extra.ASSIST_PACKAGE";
1347
1348    /**
1349     * An optional field on {@link #ACTION_ASSIST} containing the uid of the current foreground
1350     * application package at the time the assist was invoked.
1351     */
1352    public static final String EXTRA_ASSIST_UID
1353            = "android.intent.extra.ASSIST_UID";
1354
1355    /**
1356     * An optional field on {@link #ACTION_ASSIST} and containing additional contextual
1357     * information supplied by the current foreground app at the time of the assist request.
1358     * This is a {@link Bundle} of additional data.
1359     */
1360    public static final String EXTRA_ASSIST_CONTEXT
1361            = "android.intent.extra.ASSIST_CONTEXT";
1362
1363    /**
1364     * An optional field on {@link #ACTION_ASSIST} suggesting that the user will likely use a
1365     * keyboard as the primary input device for assistance.
1366     */
1367    public static final String EXTRA_ASSIST_INPUT_HINT_KEYBOARD =
1368            "android.intent.extra.ASSIST_INPUT_HINT_KEYBOARD";
1369
1370    /**
1371     * An optional field on {@link #ACTION_ASSIST} containing the InputDevice id
1372     * that was used to invoke the assist.
1373     */
1374    public static final String EXTRA_ASSIST_INPUT_DEVICE_ID =
1375            "android.intent.extra.ASSIST_INPUT_DEVICE_ID";
1376
1377    /**
1378     * Activity Action: List all available applications.
1379     * <p>Input: Nothing.
1380     * <p>Output: nothing.
1381     */
1382    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1383    public static final String ACTION_ALL_APPS = "android.intent.action.ALL_APPS";
1384    /**
1385     * Activity Action: Show settings for choosing wallpaper.
1386     * <p>Input: Nothing.
1387     * <p>Output: Nothing.
1388     */
1389    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1390    public static final String ACTION_SET_WALLPAPER = "android.intent.action.SET_WALLPAPER";
1391
1392    /**
1393     * Activity Action: Show activity for reporting a bug.
1394     * <p>Input: Nothing.
1395     * <p>Output: Nothing.
1396     */
1397    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1398    public static final String ACTION_BUG_REPORT = "android.intent.action.BUG_REPORT";
1399
1400    /**
1401     *  Activity Action: Main entry point for factory tests.  Only used when
1402     *  the device is booting in factory test node.  The implementing package
1403     *  must be installed in the system image.
1404     *  <p>Input: nothing
1405     *  <p>Output: nothing
1406     */
1407    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1408    public static final String ACTION_FACTORY_TEST = "android.intent.action.FACTORY_TEST";
1409
1410    /**
1411     * Activity Action: The user pressed the "call" button to go to the dialer
1412     * or other appropriate UI for placing a call.
1413     * <p>Input: Nothing.
1414     * <p>Output: Nothing.
1415     */
1416    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1417    public static final String ACTION_CALL_BUTTON = "android.intent.action.CALL_BUTTON";
1418
1419    /**
1420     * Activity Action: Start Voice Command.
1421     * <p>Input: Nothing.
1422     * <p>Output: Nothing.
1423     * <p class="note">
1424     * In some cases, a matching Activity may not exist, so ensure you
1425     * safeguard against this.
1426     */
1427    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1428    public static final String ACTION_VOICE_COMMAND = "android.intent.action.VOICE_COMMAND";
1429
1430    /**
1431     * Activity Action: Start action associated with long pressing on the
1432     * search key.
1433     * <p>Input: Nothing.
1434     * <p>Output: Nothing.
1435     */
1436    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1437    public static final String ACTION_SEARCH_LONG_PRESS = "android.intent.action.SEARCH_LONG_PRESS";
1438
1439    /**
1440     * Activity Action: The user pressed the "Report" button in the crash/ANR dialog.
1441     * This intent is delivered to the package which installed the application, usually
1442     * Google Play.
1443     * <p>Input: No data is specified. The bug report is passed in using
1444     * an {@link #EXTRA_BUG_REPORT} field.
1445     * <p>Output: Nothing.
1446     *
1447     * @see #EXTRA_BUG_REPORT
1448     */
1449    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1450    public static final String ACTION_APP_ERROR = "android.intent.action.APP_ERROR";
1451
1452    /**
1453     * Activity Action: Show power usage information to the user.
1454     * <p>Input: Nothing.
1455     * <p>Output: Nothing.
1456     */
1457    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1458    public static final String ACTION_POWER_USAGE_SUMMARY = "android.intent.action.POWER_USAGE_SUMMARY";
1459
1460    /**
1461     * Activity Action: Setup wizard action provided for OTA provisioning to determine if it needs
1462     * to run.
1463     * <p>Input: Nothing.
1464     * <p>Output: Nothing.
1465     * @deprecated As of {@link android.os.Build.VERSION_CODES#M}, setup wizard can be identified
1466     * using {@link #ACTION_MAIN} and {@link #CATEGORY_SETUP_WIZARD}
1467     * @hide
1468     * @removed
1469     */
1470    @Deprecated
1471    @SystemApi
1472    public static final String ACTION_DEVICE_INITIALIZATION_WIZARD =
1473            "android.intent.action.DEVICE_INITIALIZATION_WIZARD";
1474
1475    /**
1476     * Activity Action: Setup wizard to launch after a platform update.  This
1477     * activity should have a string meta-data field associated with it,
1478     * {@link #METADATA_SETUP_VERSION}, which defines the current version of
1479     * the platform for setup.  The activity will be launched only if
1480     * {@link android.provider.Settings.Secure#LAST_SETUP_SHOWN} is not the
1481     * same value.
1482     * <p>Input: Nothing.
1483     * <p>Output: Nothing.
1484     * @hide
1485     */
1486    @SystemApi
1487    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1488    public static final String ACTION_UPGRADE_SETUP = "android.intent.action.UPGRADE_SETUP";
1489
1490    /**
1491     * Activity Action: Start the Keyboard Shortcuts Helper screen.
1492     * <p>Input: Nothing.
1493     * <p>Output: Nothing.
1494     * @hide
1495     */
1496    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1497    public static final String ACTION_SHOW_KEYBOARD_SHORTCUTS =
1498            "com.android.intent.action.SHOW_KEYBOARD_SHORTCUTS";
1499
1500    /**
1501     * Activity Action: Dismiss the Keyboard Shortcuts Helper screen.
1502     * <p>Input: Nothing.
1503     * <p>Output: Nothing.
1504     * @hide
1505     */
1506    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1507    public static final String ACTION_DISMISS_KEYBOARD_SHORTCUTS =
1508            "com.android.intent.action.DISMISS_KEYBOARD_SHORTCUTS";
1509
1510    /**
1511     * Activity Action: Show settings for managing network data usage of a
1512     * specific application. Applications should define an activity that offers
1513     * options to control data usage.
1514     */
1515    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1516    public static final String ACTION_MANAGE_NETWORK_USAGE =
1517            "android.intent.action.MANAGE_NETWORK_USAGE";
1518
1519    /**
1520     * Activity Action: Launch application installer.
1521     * <p>
1522     * Input: The data must be a content: URI at which the application
1523     * can be retrieved.  As of {@link android.os.Build.VERSION_CODES#JELLY_BEAN_MR1},
1524     * you can also use "package:<package-name>" to install an application for the
1525     * current user that is already installed for another user. You can optionally supply
1526     * {@link #EXTRA_INSTALLER_PACKAGE_NAME}, {@link #EXTRA_NOT_UNKNOWN_SOURCE},
1527     * {@link #EXTRA_ALLOW_REPLACE}, and {@link #EXTRA_RETURN_RESULT}.
1528     * <p>
1529     * Output: If {@link #EXTRA_RETURN_RESULT}, returns whether the install
1530     * succeeded.
1531     * <p>
1532     * <strong>Note:</strong>If your app is targeting API level higher than 25 you
1533     * need to hold {@link android.Manifest.permission#REQUEST_INSTALL_PACKAGES}
1534     * in order to launch the application installer.
1535     * </p>
1536     *
1537     * @see #EXTRA_INSTALLER_PACKAGE_NAME
1538     * @see #EXTRA_NOT_UNKNOWN_SOURCE
1539     * @see #EXTRA_RETURN_RESULT
1540     */
1541    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1542    public static final String ACTION_INSTALL_PACKAGE = "android.intent.action.INSTALL_PACKAGE";
1543
1544    /**
1545     * Activity Action: Activity to handle split installation failures.
1546     * <p>Splits may be installed dynamically. This happens when an Activity is launched,
1547     * but the split that contains the application isn't installed. When a split is
1548     * installed in this manner, the containing package usually doesn't know this is
1549     * happening. However, if an error occurs during installation, the containing
1550     * package can define a single activity handling this action to deal with such
1551     * failures.
1552     * <p>The activity handling this action must be in the base package.
1553     * <p>
1554     * Input: {@link #EXTRA_INTENT} the original intent that started split installation.
1555     * {@link #EXTRA_SPLIT_NAME} the name of the split that failed to be installed.
1556     */
1557    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1558    public static final String ACTION_INSTALL_FAILURE = "android.intent.action.INSTALL_FAILURE";
1559
1560    /**
1561     * Activity Action: Launch instant application installer.
1562     * <p class="note">
1563     * This is a protected intent that can only be sent by the system.
1564     * </p>
1565     *
1566     * @hide
1567     */
1568    @SystemApi
1569    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1570    public static final String ACTION_INSTALL_INSTANT_APP_PACKAGE
1571            = "android.intent.action.INSTALL_INSTANT_APP_PACKAGE";
1572
1573    /**
1574     * Service Action: Resolve instant application.
1575     * <p>
1576     * The system will have a persistent connection to this service.
1577     * This is a protected intent that can only be sent by the system.
1578     * </p>
1579     *
1580     * @hide
1581     */
1582    @SystemApi
1583    @SdkConstant(SdkConstantType.SERVICE_ACTION)
1584    public static final String ACTION_RESOLVE_INSTANT_APP_PACKAGE
1585            = "android.intent.action.RESOLVE_INSTANT_APP_PACKAGE";
1586
1587    /**
1588     * Activity Action: Launch instant app settings.
1589     *
1590     * <p class="note">
1591     * This is a protected intent that can only be sent by the system.
1592     * </p>
1593     *
1594     * @hide
1595     */
1596    @SystemApi
1597    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1598    public static final String ACTION_INSTANT_APP_RESOLVER_SETTINGS
1599            = "android.intent.action.INSTANT_APP_RESOLVER_SETTINGS";
1600
1601    /**
1602     * Used as a string extra field with {@link #ACTION_INSTALL_PACKAGE} to install a
1603     * package.  Specifies the installer package name; this package will receive the
1604     * {@link #ACTION_APP_ERROR} intent.
1605     */
1606    public static final String EXTRA_INSTALLER_PACKAGE_NAME
1607            = "android.intent.extra.INSTALLER_PACKAGE_NAME";
1608
1609    /**
1610     * Used as a boolean extra field with {@link #ACTION_INSTALL_PACKAGE} to install a
1611     * package.  Specifies that the application being installed should not be
1612     * treated as coming from an unknown source, but as coming from the app
1613     * invoking the Intent.  For this to work you must start the installer with
1614     * startActivityForResult().
1615     */
1616    public static final String EXTRA_NOT_UNKNOWN_SOURCE
1617            = "android.intent.extra.NOT_UNKNOWN_SOURCE";
1618
1619    /**
1620     * Used as a URI extra field with {@link #ACTION_INSTALL_PACKAGE} and
1621     * {@link #ACTION_VIEW} to indicate the URI from which the local APK in the Intent
1622     * data field originated from.
1623     */
1624    public static final String EXTRA_ORIGINATING_URI
1625            = "android.intent.extra.ORIGINATING_URI";
1626
1627    /**
1628     * This extra can be used with any Intent used to launch an activity, supplying information
1629     * about who is launching that activity.  This field contains a {@link android.net.Uri}
1630     * object, typically an http: or https: URI of the web site that the referral came from;
1631     * it can also use the {@link #URI_ANDROID_APP_SCHEME android-app:} scheme to identify
1632     * a native application that it came from.
1633     *
1634     * <p>To retrieve this value in a client, use {@link android.app.Activity#getReferrer}
1635     * instead of directly retrieving the extra.  It is also valid for applications to
1636     * instead supply {@link #EXTRA_REFERRER_NAME} for cases where they can only create
1637     * a string, not a Uri; the field here, if supplied, will always take precedence,
1638     * however.</p>
1639     *
1640     * @see #EXTRA_REFERRER_NAME
1641     */
1642    public static final String EXTRA_REFERRER
1643            = "android.intent.extra.REFERRER";
1644
1645    /**
1646     * Alternate version of {@link #EXTRA_REFERRER} that supplies the URI as a String rather
1647     * than a {@link android.net.Uri} object.  Only for use in cases where Uri objects can
1648     * not be created, in particular when Intent extras are supplied through the
1649     * {@link #URI_INTENT_SCHEME intent:} or {@link #URI_ANDROID_APP_SCHEME android-app:}
1650     * schemes.
1651     *
1652     * @see #EXTRA_REFERRER
1653     */
1654    public static final String EXTRA_REFERRER_NAME
1655            = "android.intent.extra.REFERRER_NAME";
1656
1657    /**
1658     * Used as an int extra field with {@link #ACTION_INSTALL_PACKAGE} and
1659     * {@link #ACTION_VIEW} to indicate the uid of the package that initiated the install
1660     * Currently only a system app that hosts the provider authority "downloads" or holds the
1661     * permission {@link android.Manifest.permission.MANAGE_DOCUMENTS} can use this.
1662     * @hide
1663     */
1664    @SystemApi
1665    public static final String EXTRA_ORIGINATING_UID
1666            = "android.intent.extra.ORIGINATING_UID";
1667
1668    /**
1669     * Used as a boolean extra field with {@link #ACTION_INSTALL_PACKAGE} to install a
1670     * package.  Tells the installer UI to skip the confirmation with the user
1671     * if the .apk is replacing an existing one.
1672     * @deprecated As of {@link android.os.Build.VERSION_CODES#JELLY_BEAN}, Android
1673     * will no longer show an interstitial message about updating existing
1674     * applications so this is no longer needed.
1675     */
1676    @Deprecated
1677    public static final String EXTRA_ALLOW_REPLACE
1678            = "android.intent.extra.ALLOW_REPLACE";
1679
1680    /**
1681     * Used as a boolean extra field with {@link #ACTION_INSTALL_PACKAGE} or
1682     * {@link #ACTION_UNINSTALL_PACKAGE}.  Specifies that the installer UI should
1683     * return to the application the result code of the install/uninstall.  The returned result
1684     * code will be {@link android.app.Activity#RESULT_OK} on success or
1685     * {@link android.app.Activity#RESULT_FIRST_USER} on failure.
1686     */
1687    public static final String EXTRA_RETURN_RESULT
1688            = "android.intent.extra.RETURN_RESULT";
1689
1690    /**
1691     * Package manager install result code.  @hide because result codes are not
1692     * yet ready to be exposed.
1693     */
1694    public static final String EXTRA_INSTALL_RESULT
1695            = "android.intent.extra.INSTALL_RESULT";
1696
1697    /**
1698     * Activity Action: Launch application uninstaller.
1699     * <p>
1700     * Input: The data must be a package: URI whose scheme specific part is
1701     * the package name of the current installed package to be uninstalled.
1702     * You can optionally supply {@link #EXTRA_RETURN_RESULT}.
1703     * <p>
1704     * Output: If {@link #EXTRA_RETURN_RESULT}, returns whether the install
1705     * succeeded.
1706     * <p>
1707     * Requires {@link android.Manifest.permission#REQUEST_DELETE_PACKAGES}
1708     * since {@link Build.VERSION_CODES#P}.
1709     */
1710    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1711    public static final String ACTION_UNINSTALL_PACKAGE = "android.intent.action.UNINSTALL_PACKAGE";
1712
1713    /**
1714     * Specify whether the package should be uninstalled for all users.
1715     * @hide because these should not be part of normal application flow.
1716     */
1717    public static final String EXTRA_UNINSTALL_ALL_USERS
1718            = "android.intent.extra.UNINSTALL_ALL_USERS";
1719
1720    /**
1721     * A string associated with a {@link #ACTION_UPGRADE_SETUP} activity
1722     * describing the last run version of the platform that was setup.
1723     * @hide
1724     */
1725    public static final String METADATA_SETUP_VERSION = "android.SETUP_VERSION";
1726
1727    /**
1728     * Activity action: Launch UI to manage the permissions of an app.
1729     * <p>
1730     * Input: {@link #EXTRA_PACKAGE_NAME} specifies the package whose permissions
1731     * will be managed by the launched UI.
1732     * </p>
1733     * <p>
1734     * Output: Nothing.
1735     * </p>
1736     *
1737     * @see #EXTRA_PACKAGE_NAME
1738     *
1739     * @hide
1740     */
1741    @SystemApi
1742    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1743    public static final String ACTION_MANAGE_APP_PERMISSIONS =
1744            "android.intent.action.MANAGE_APP_PERMISSIONS";
1745
1746    /**
1747     * Activity action: Launch UI to manage permissions.
1748     * <p>
1749     * Input: Nothing.
1750     * </p>
1751     * <p>
1752     * Output: Nothing.
1753     * </p>
1754     *
1755     * @hide
1756     */
1757    @SystemApi
1758    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1759    public static final String ACTION_MANAGE_PERMISSIONS =
1760            "android.intent.action.MANAGE_PERMISSIONS";
1761
1762    /**
1763     * Activity action: Launch UI to review permissions for an app.
1764     * The system uses this intent if permission review for apps not
1765     * supporting the new runtime permissions model is enabled. In
1766     * this mode a permission review is required before any of the
1767     * app components can run.
1768     * <p>
1769     * Input: {@link #EXTRA_PACKAGE_NAME} specifies the package whose
1770     * permissions will be reviewed (mandatory).
1771     * </p>
1772     * <p>
1773     * Input: {@link #EXTRA_INTENT} specifies a pending intent to
1774     * be fired after the permission review (optional).
1775     * </p>
1776     * <p>
1777     * Input: {@link #EXTRA_REMOTE_CALLBACK} specifies a callback to
1778     * be invoked after the permission review (optional).
1779     * </p>
1780     * <p>
1781     * Input: {@link #EXTRA_RESULT_NEEDED} specifies whether the intent
1782     * passed via {@link #EXTRA_INTENT} needs a result (optional).
1783     * </p>
1784     * <p>
1785     * Output: Nothing.
1786     * </p>
1787     *
1788     * @see #EXTRA_PACKAGE_NAME
1789     * @see #EXTRA_INTENT
1790     * @see #EXTRA_REMOTE_CALLBACK
1791     * @see #EXTRA_RESULT_NEEDED
1792     *
1793     * @hide
1794     */
1795    @SystemApi
1796    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1797    public static final String ACTION_REVIEW_PERMISSIONS =
1798            "android.intent.action.REVIEW_PERMISSIONS";
1799
1800    /**
1801     * Intent extra: A callback for reporting remote result as a bundle.
1802     * <p>
1803     * Type: IRemoteCallback
1804     * </p>
1805     *
1806     * @hide
1807     */
1808    @SystemApi
1809    public static final String EXTRA_REMOTE_CALLBACK = "android.intent.extra.REMOTE_CALLBACK";
1810
1811    /**
1812     * Intent extra: An app package name.
1813     * <p>
1814     * Type: String
1815     * </p>
1816     *
1817     */
1818    public static final String EXTRA_PACKAGE_NAME = "android.intent.extra.PACKAGE_NAME";
1819
1820    /**
1821     * Intent extra: A {@link Bundle} of extras for a package being suspended. Will be sent as an
1822     * extra with {@link #ACTION_MY_PACKAGE_SUSPENDED}.
1823     *
1824     * <p>The contents of this {@link Bundle} are a contract between the suspended app and the
1825     * suspending app, i.e. any app with the permission {@code android.permission.SUSPEND_APPS}.
1826     * This is meant to enable the suspended app to better handle the state of being suspended.
1827     *
1828     * @see #ACTION_MY_PACKAGE_SUSPENDED
1829     * @see #ACTION_MY_PACKAGE_UNSUSPENDED
1830     * @see PackageManager#isPackageSuspended()
1831     * @see PackageManager#getSuspendedPackageAppExtras()
1832     */
1833    public static final String EXTRA_SUSPENDED_PACKAGE_EXTRAS = "android.intent.extra.SUSPENDED_PACKAGE_EXTRAS";
1834
1835    /**
1836     * Intent extra: An app split name.
1837     * <p>
1838     * Type: String
1839     * </p>
1840     */
1841    public static final String EXTRA_SPLIT_NAME = "android.intent.extra.SPLIT_NAME";
1842
1843    /**
1844     * Intent extra: A {@link ComponentName} value.
1845     * <p>
1846     * Type: String
1847     * </p>
1848     */
1849    public static final String EXTRA_COMPONENT_NAME = "android.intent.extra.COMPONENT_NAME";
1850
1851    /**
1852     * Intent extra: An extra for specifying whether a result is needed.
1853     * <p>
1854     * Type: boolean
1855     * </p>
1856     *
1857     * @hide
1858     */
1859    @SystemApi
1860    public static final String EXTRA_RESULT_NEEDED = "android.intent.extra.RESULT_NEEDED";
1861
1862    /**
1863     * Intent extra: A {@link Bundle} of extras supplied for the launcher when any packages on
1864     * device are suspended. Will be sent with {@link #ACTION_PACKAGES_SUSPENDED}.
1865     *
1866     * @see PackageManager#isPackageSuspended()
1867     * @see #ACTION_PACKAGES_SUSPENDED
1868     *
1869     * @hide
1870     */
1871    public static final String EXTRA_LAUNCHER_EXTRAS = "android.intent.extra.LAUNCHER_EXTRAS";
1872
1873    /**
1874     * Activity action: Launch UI to manage which apps have a given permission.
1875     * <p>
1876     * Input: {@link #EXTRA_PERMISSION_NAME} specifies the permission access
1877     * to which will be managed by the launched UI.
1878     * </p>
1879     * <p>
1880     * Output: Nothing.
1881     * </p>
1882     *
1883     * @see #EXTRA_PERMISSION_NAME
1884     *
1885     * @hide
1886     */
1887    @SystemApi
1888    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
1889    public static final String ACTION_MANAGE_PERMISSION_APPS =
1890            "android.intent.action.MANAGE_PERMISSION_APPS";
1891
1892    /**
1893     * Intent extra: The name of a permission.
1894     * <p>
1895     * Type: String
1896     * </p>
1897     *
1898     * @hide
1899     */
1900    @SystemApi
1901    public static final String EXTRA_PERMISSION_NAME = "android.intent.extra.PERMISSION_NAME";
1902
1903    // ---------------------------------------------------------------------
1904    // ---------------------------------------------------------------------
1905    // Standard intent broadcast actions (see action variable).
1906
1907    /**
1908     * Broadcast Action: Sent when the device goes to sleep and becomes non-interactive.
1909     * <p>
1910     * For historical reasons, the name of this broadcast action refers to the power
1911     * state of the screen but it is actually sent in response to changes in the
1912     * overall interactive state of the device.
1913     * </p><p>
1914     * This broadcast is sent when the device becomes non-interactive which may have
1915     * nothing to do with the screen turning off.  To determine the
1916     * actual state of the screen, use {@link android.view.Display#getState}.
1917     * </p><p>
1918     * See {@link android.os.PowerManager#isInteractive} for details.
1919     * </p>
1920     * You <em>cannot</em> receive this through components declared in
1921     * manifests, only by explicitly registering for it with
1922     * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
1923     * Context.registerReceiver()}.
1924     *
1925     * <p class="note">This is a protected intent that can only be sent
1926     * by the system.
1927     */
1928    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1929    public static final String ACTION_SCREEN_OFF = "android.intent.action.SCREEN_OFF";
1930
1931    /**
1932     * Broadcast Action: Sent when the device wakes up and becomes interactive.
1933     * <p>
1934     * For historical reasons, the name of this broadcast action refers to the power
1935     * state of the screen but it is actually sent in response to changes in the
1936     * overall interactive state of the device.
1937     * </p><p>
1938     * This broadcast is sent when the device becomes interactive which may have
1939     * nothing to do with the screen turning on.  To determine the
1940     * actual state of the screen, use {@link android.view.Display#getState}.
1941     * </p><p>
1942     * See {@link android.os.PowerManager#isInteractive} for details.
1943     * </p>
1944     * You <em>cannot</em> receive this through components declared in
1945     * manifests, only by explicitly registering for it with
1946     * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
1947     * Context.registerReceiver()}.
1948     *
1949     * <p class="note">This is a protected intent that can only be sent
1950     * by the system.
1951     */
1952    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1953    public static final String ACTION_SCREEN_ON = "android.intent.action.SCREEN_ON";
1954
1955    /**
1956     * Broadcast Action: Sent after the system stops dreaming.
1957     *
1958     * <p class="note">This is a protected intent that can only be sent by the system.
1959     * It is only sent to registered receivers.</p>
1960     */
1961    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1962    public static final String ACTION_DREAMING_STOPPED = "android.intent.action.DREAMING_STOPPED";
1963
1964    /**
1965     * Broadcast Action: Sent after the system starts dreaming.
1966     *
1967     * <p class="note">This is a protected intent that can only be sent by the system.
1968     * It is only sent to registered receivers.</p>
1969     */
1970    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1971    public static final String ACTION_DREAMING_STARTED = "android.intent.action.DREAMING_STARTED";
1972
1973    /**
1974     * Broadcast Action: Sent when the user is present after device wakes up (e.g when the
1975     * keyguard is gone).
1976     *
1977     * <p class="note">This is a protected intent that can only be sent
1978     * by the system.
1979     */
1980    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1981    public static final String ACTION_USER_PRESENT = "android.intent.action.USER_PRESENT";
1982
1983    /**
1984     * Broadcast Action: The current time has changed.  Sent every
1985     * minute.  You <em>cannot</em> receive this through components declared
1986     * in manifests, only by explicitly registering for it with
1987     * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
1988     * Context.registerReceiver()}.
1989     *
1990     * <p class="note">This is a protected intent that can only be sent
1991     * by the system.
1992     */
1993    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1994    public static final String ACTION_TIME_TICK = "android.intent.action.TIME_TICK";
1995    /**
1996     * Broadcast Action: The time was set.
1997     */
1998    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
1999    public static final String ACTION_TIME_CHANGED = "android.intent.action.TIME_SET";
2000    /**
2001     * Broadcast Action: The date has changed.
2002     */
2003    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2004    public static final String ACTION_DATE_CHANGED = "android.intent.action.DATE_CHANGED";
2005    /**
2006     * Broadcast Action: The timezone has changed. The intent will have the following extra values:</p>
2007     * <ul>
2008     *   <li><em>time-zone</em> - The java.util.TimeZone.getID() value identifying the new time zone.</li>
2009     * </ul>
2010     *
2011     * <p class="note">This is a protected intent that can only be sent
2012     * by the system.
2013     */
2014    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2015    public static final String ACTION_TIMEZONE_CHANGED = "android.intent.action.TIMEZONE_CHANGED";
2016    /**
2017     * Clear DNS Cache Action: This is broadcast when networks have changed and old
2018     * DNS entries should be tossed.
2019     * @hide
2020     */
2021    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2022    public static final String ACTION_CLEAR_DNS_CACHE = "android.intent.action.CLEAR_DNS_CACHE";
2023    /**
2024     * Alarm Changed Action: This is broadcast when the AlarmClock
2025     * application's alarm is set or unset.  It is used by the
2026     * AlarmClock application and the StatusBar service.
2027     * @hide
2028     */
2029    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2030    public static final String ACTION_ALARM_CHANGED = "android.intent.action.ALARM_CHANGED";
2031
2032    /**
2033     * Broadcast Action: This is broadcast once, after the user has finished
2034     * booting, but while still in the "locked" state. It can be used to perform
2035     * application-specific initialization, such as installing alarms. You must
2036     * hold the {@link android.Manifest.permission#RECEIVE_BOOT_COMPLETED}
2037     * permission in order to receive this broadcast.
2038     * <p>
2039     * This broadcast is sent immediately at boot by all devices (regardless of
2040     * direct boot support) running {@link android.os.Build.VERSION_CODES#N} or
2041     * higher. Upon receipt of this broadcast, the user is still locked and only
2042     * device-protected storage can be accessed safely. If you want to access
2043     * credential-protected storage, you need to wait for the user to be
2044     * unlocked (typically by entering their lock pattern or PIN for the first
2045     * time), after which the {@link #ACTION_USER_UNLOCKED} and
2046     * {@link #ACTION_BOOT_COMPLETED} broadcasts are sent.
2047     * <p>
2048     * To receive this broadcast, your receiver component must be marked as
2049     * being {@link ComponentInfo#directBootAware}.
2050     * <p class="note">
2051     * This is a protected intent that can only be sent by the system.
2052     *
2053     * @see Context#createDeviceProtectedStorageContext()
2054     */
2055    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2056    public static final String ACTION_LOCKED_BOOT_COMPLETED = "android.intent.action.LOCKED_BOOT_COMPLETED";
2057
2058    /**
2059     * Broadcast Action: This is broadcast once, after the user has finished
2060     * booting. It can be used to perform application-specific initialization,
2061     * such as installing alarms. You must hold the
2062     * {@link android.Manifest.permission#RECEIVE_BOOT_COMPLETED} permission in
2063     * order to receive this broadcast.
2064     * <p>
2065     * This broadcast is sent at boot by all devices (both with and without
2066     * direct boot support). Upon receipt of this broadcast, the user is
2067     * unlocked and both device-protected and credential-protected storage can
2068     * accessed safely.
2069     * <p>
2070     * If you need to run while the user is still locked (before they've entered
2071     * their lock pattern or PIN for the first time), you can listen for the
2072     * {@link #ACTION_LOCKED_BOOT_COMPLETED} broadcast.
2073     * <p class="note">
2074     * This is a protected intent that can only be sent by the system.
2075     */
2076    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2077    @BroadcastBehavior(includeBackground = true)
2078    public static final String ACTION_BOOT_COMPLETED = "android.intent.action.BOOT_COMPLETED";
2079
2080    /**
2081     * Broadcast Action: This is broadcast when a user action should request a
2082     * temporary system dialog to dismiss.  Some examples of temporary system
2083     * dialogs are the notification window-shade and the recent tasks dialog.
2084     */
2085    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2086    public static final String ACTION_CLOSE_SYSTEM_DIALOGS = "android.intent.action.CLOSE_SYSTEM_DIALOGS";
2087    /**
2088     * Broadcast Action: Trigger the download and eventual installation
2089     * of a package.
2090     * <p>Input: {@link #getData} is the URI of the package file to download.
2091     *
2092     * <p class="note">This is a protected intent that can only be sent
2093     * by the system.
2094     *
2095     * @deprecated This constant has never been used.
2096     */
2097    @Deprecated
2098    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2099    public static final String ACTION_PACKAGE_INSTALL = "android.intent.action.PACKAGE_INSTALL";
2100    /**
2101     * Broadcast Action: A new application package has been installed on the
2102     * device. The data contains the name of the package.  Note that the
2103     * newly installed package does <em>not</em> receive this broadcast.
2104     * <p>May include the following extras:
2105     * <ul>
2106     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the new package.
2107     * <li> {@link #EXTRA_REPLACING} is set to true if this is following
2108     * an {@link #ACTION_PACKAGE_REMOVED} broadcast for the same package.
2109     * </ul>
2110     *
2111     * <p class="note">This is a protected intent that can only be sent
2112     * by the system.
2113     */
2114    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2115    public static final String ACTION_PACKAGE_ADDED = "android.intent.action.PACKAGE_ADDED";
2116    /**
2117     * Broadcast Action: A new version of an application package has been
2118     * installed, replacing an existing version that was previously installed.
2119     * The data contains the name of the package.
2120     * <p>May include the following extras:
2121     * <ul>
2122     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the new package.
2123     * </ul>
2124     *
2125     * <p class="note">This is a protected intent that can only be sent
2126     * by the system.
2127     */
2128    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2129    public static final String ACTION_PACKAGE_REPLACED = "android.intent.action.PACKAGE_REPLACED";
2130    /**
2131     * Broadcast Action: A new version of your application has been installed
2132     * over an existing one.  This is only sent to the application that was
2133     * replaced.  It does not contain any additional data; to receive it, just
2134     * use an intent filter for this action.
2135     *
2136     * <p class="note">This is a protected intent that can only be sent
2137     * by the system.
2138     */
2139    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2140    public static final String ACTION_MY_PACKAGE_REPLACED = "android.intent.action.MY_PACKAGE_REPLACED";
2141    /**
2142     * Broadcast Action: An existing application package has been removed from
2143     * the device.  The data contains the name of the package.  The package
2144     * that is being removed does <em>not</em> receive this Intent.
2145     * <ul>
2146     * <li> {@link #EXTRA_UID} containing the integer uid previously assigned
2147     * to the package.
2148     * <li> {@link #EXTRA_DATA_REMOVED} is set to true if the entire
2149     * application -- data and code -- is being removed.
2150     * <li> {@link #EXTRA_REPLACING} is set to true if this will be followed
2151     * by an {@link #ACTION_PACKAGE_ADDED} broadcast for the same package.
2152     * </ul>
2153     *
2154     * <p class="note">This is a protected intent that can only be sent
2155     * by the system.
2156     */
2157    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2158    public static final String ACTION_PACKAGE_REMOVED = "android.intent.action.PACKAGE_REMOVED";
2159    /**
2160     * Broadcast Action: An existing application package has been completely
2161     * removed from the device.  The data contains the name of the package.
2162     * This is like {@link #ACTION_PACKAGE_REMOVED}, but only set when
2163     * {@link #EXTRA_DATA_REMOVED} is true and
2164     * {@link #EXTRA_REPLACING} is false of that broadcast.
2165     *
2166     * <ul>
2167     * <li> {@link #EXTRA_UID} containing the integer uid previously assigned
2168     * to the package.
2169     * </ul>
2170     *
2171     * <p class="note">This is a protected intent that can only be sent
2172     * by the system.
2173     */
2174    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2175    public static final String ACTION_PACKAGE_FULLY_REMOVED
2176            = "android.intent.action.PACKAGE_FULLY_REMOVED";
2177    /**
2178     * Broadcast Action: An existing application package has been changed (for
2179     * example, a component has been enabled or disabled).  The data contains
2180     * the name of the package.
2181     * <ul>
2182     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package.
2183     * <li> {@link #EXTRA_CHANGED_COMPONENT_NAME_LIST} containing the class name
2184     * of the changed components (or the package name itself).
2185     * <li> {@link #EXTRA_DONT_KILL_APP} containing boolean field to override the
2186     * default action of restarting the application.
2187     * </ul>
2188     *
2189     * <p class="note">This is a protected intent that can only be sent
2190     * by the system.
2191     */
2192    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2193    public static final String ACTION_PACKAGE_CHANGED = "android.intent.action.PACKAGE_CHANGED";
2194    /**
2195     * @hide
2196     * Broadcast Action: Ask system services if there is any reason to
2197     * restart the given package.  The data contains the name of the
2198     * package.
2199     * <ul>
2200     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package.
2201     * <li> {@link #EXTRA_PACKAGES} String array of all packages to check.
2202     * </ul>
2203     *
2204     * <p class="note">This is a protected intent that can only be sent
2205     * by the system.
2206     */
2207    @SystemApi
2208    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2209    public static final String ACTION_QUERY_PACKAGE_RESTART = "android.intent.action.QUERY_PACKAGE_RESTART";
2210    /**
2211     * Broadcast Action: The user has restarted a package, and all of its
2212     * processes have been killed.  All runtime state
2213     * associated with it (processes, alarms, notifications, etc) should
2214     * be removed.  Note that the restarted package does <em>not</em>
2215     * receive this broadcast.
2216     * The data contains the name of the package.
2217     * <ul>
2218     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package.
2219     * </ul>
2220     *
2221     * <p class="note">This is a protected intent that can only be sent
2222     * by the system.
2223     */
2224    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2225    public static final String ACTION_PACKAGE_RESTARTED = "android.intent.action.PACKAGE_RESTARTED";
2226    /**
2227     * Broadcast Action: The user has cleared the data of a package.  This should
2228     * be preceded by {@link #ACTION_PACKAGE_RESTARTED}, after which all of
2229     * its persistent data is erased and this broadcast sent.
2230     * Note that the cleared package does <em>not</em>
2231     * receive this broadcast. The data contains the name of the package.
2232     * <ul>
2233     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package. If the
2234     *      package whose data was cleared is an uninstalled instant app, then the UID
2235     *      will be -1. The platform keeps some meta-data associated with instant apps
2236     *      after they are uninstalled.
2237     * <li> {@link #EXTRA_PACKAGE_NAME} containing the package name only if the cleared
2238     *      data was for an instant app.
2239     * </ul>
2240     *
2241     * <p class="note">This is a protected intent that can only be sent
2242     * by the system.
2243     */
2244    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2245    public static final String ACTION_PACKAGE_DATA_CLEARED = "android.intent.action.PACKAGE_DATA_CLEARED";
2246    /**
2247     * Broadcast Action: Packages have been suspended.
2248     * <p>Includes the following extras:
2249     * <ul>
2250     * <li> {@link #EXTRA_CHANGED_PACKAGE_LIST} is the set of packages which have been suspended
2251     * </ul>
2252     *
2253     * <p class="note">This is a protected intent that can only be sent
2254     * by the system. It is only sent to registered receivers.
2255     */
2256    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2257    public static final String ACTION_PACKAGES_SUSPENDED = "android.intent.action.PACKAGES_SUSPENDED";
2258    /**
2259     * Broadcast Action: Packages have been unsuspended.
2260     * <p>Includes the following extras:
2261     * <ul>
2262     * <li> {@link #EXTRA_CHANGED_PACKAGE_LIST} is the set of packages which have been unsuspended
2263     * </ul>
2264     *
2265     * <p class="note">This is a protected intent that can only be sent
2266     * by the system. It is only sent to registered receivers.
2267     */
2268    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2269    public static final String ACTION_PACKAGES_UNSUSPENDED = "android.intent.action.PACKAGES_UNSUSPENDED";
2270
2271    /**
2272     * Broadcast Action: Sent to a package that has been suspended by the system. This is sent
2273     * whenever a package is put into a suspended state or any of its app extras change while in the
2274     * suspended state.
2275     * <p> Optionally includes the following extras:
2276     * <ul>
2277     *     <li> {@link #EXTRA_SUSPENDED_PACKAGE_EXTRAS} which is a {@link Bundle} which will contain
2278     *     useful information for the app being suspended.
2279     * </ul>
2280     * <p class="note">This is a protected intent that can only be sent
2281     * by the system. <em>This will be delivered to {@link BroadcastReceiver} components declared in
2282     * the manifest.</em>
2283     *
2284     * @see #ACTION_MY_PACKAGE_UNSUSPENDED
2285     * @see #EXTRA_SUSPENDED_PACKAGE_EXTRAS
2286     * @see PackageManager#isPackageSuspended()
2287     * @see PackageManager#getSuspendedPackageAppExtras()
2288     */
2289    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2290    public static final String ACTION_MY_PACKAGE_SUSPENDED = "android.intent.action.MY_PACKAGE_SUSPENDED";
2291
2292    /**
2293     * Activity Action: Started to show more details about why an application was suspended.
2294     *
2295     * <p>Whenever the system detects an activity launch for a suspended app, this action can
2296     * be used to show more details about the reason for suspension.
2297     *
2298     * <p>Apps holding {@link android.Manifest.permission#SUSPEND_APPS} must declare an activity
2299     * handling this intent and protect it with
2300     * {@link android.Manifest.permission#SEND_SHOW_SUSPENDED_APP_DETAILS}.
2301     *
2302     * <p>Includes an extra {@link #EXTRA_PACKAGE_NAME} which is the name of the suspended package.
2303     *
2304     * <p class="note">This is a protected intent that can only be sent
2305     * by the system.
2306     *
2307     * @see PackageManager#setPackagesSuspended(String[], boolean, PersistableBundle,
2308     * PersistableBundle, String)
2309     * @see PackageManager#isPackageSuspended()
2310     * @see #ACTION_PACKAGES_SUSPENDED
2311     *
2312     * @hide
2313     */
2314    @SystemApi
2315    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
2316    public static final String ACTION_SHOW_SUSPENDED_APP_DETAILS =
2317            "android.intent.action.SHOW_SUSPENDED_APP_DETAILS";
2318
2319    /**
2320     * Broadcast Action: Sent to a package that has been unsuspended.
2321     *
2322     * <p class="note">This is a protected intent that can only be sent
2323     * by the system. <em>This will be delivered to {@link BroadcastReceiver} components declared in
2324     * the manifest.</em>
2325     *
2326     * @see #ACTION_MY_PACKAGE_SUSPENDED
2327     * @see #EXTRA_SUSPENDED_PACKAGE_EXTRAS
2328     * @see PackageManager#isPackageSuspended()
2329     * @see PackageManager#getSuspendedPackageAppExtras()
2330     */
2331    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2332    public static final String ACTION_MY_PACKAGE_UNSUSPENDED = "android.intent.action.MY_PACKAGE_UNSUSPENDED";
2333
2334    /**
2335     * Broadcast Action: A user ID has been removed from the system.  The user
2336     * ID number is stored in the extra data under {@link #EXTRA_UID}.
2337     *
2338     * <p class="note">This is a protected intent that can only be sent
2339     * by the system.
2340     */
2341    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2342    public static final String ACTION_UID_REMOVED = "android.intent.action.UID_REMOVED";
2343
2344    /**
2345     * Broadcast Action: Sent to the installer package of an application when
2346     * that application is first launched (that is the first time it is moved
2347     * out of the stopped state).  The data contains the name of the package.
2348     *
2349     * <p class="note">This is a protected intent that can only be sent
2350     * by the system.
2351     */
2352    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2353    public static final String ACTION_PACKAGE_FIRST_LAUNCH = "android.intent.action.PACKAGE_FIRST_LAUNCH";
2354
2355    /**
2356     * Broadcast Action: Sent to the system package verifier when a package
2357     * needs to be verified. The data contains the package URI.
2358     * <p class="note">
2359     * This is a protected intent that can only be sent by the system.
2360     * </p>
2361     */
2362    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2363    public static final String ACTION_PACKAGE_NEEDS_VERIFICATION = "android.intent.action.PACKAGE_NEEDS_VERIFICATION";
2364
2365    /**
2366     * Broadcast Action: Sent to the system package verifier when a package is
2367     * verified. The data contains the package URI.
2368     * <p class="note">
2369     * This is a protected intent that can only be sent by the system.
2370     */
2371    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2372    public static final String ACTION_PACKAGE_VERIFIED = "android.intent.action.PACKAGE_VERIFIED";
2373
2374    /**
2375     * Broadcast Action: Sent to the system intent filter verifier when an
2376     * intent filter needs to be verified. The data contains the filter data
2377     * hosts to be verified against.
2378     * <p class="note">
2379     * This is a protected intent that can only be sent by the system.
2380     * </p>
2381     *
2382     * @hide
2383     */
2384    @SystemApi
2385    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2386    public static final String ACTION_INTENT_FILTER_NEEDS_VERIFICATION = "android.intent.action.INTENT_FILTER_NEEDS_VERIFICATION";
2387
2388    /**
2389     * Broadcast Action: Resources for a set of packages (which were
2390     * previously unavailable) are currently
2391     * available since the media on which they exist is available.
2392     * The extra data {@link #EXTRA_CHANGED_PACKAGE_LIST} contains a
2393     * list of packages whose availability changed.
2394     * The extra data {@link #EXTRA_CHANGED_UID_LIST} contains a
2395     * list of uids of packages whose availability changed.
2396     * Note that the
2397     * packages in this list do <em>not</em> receive this broadcast.
2398     * The specified set of packages are now available on the system.
2399     * <p>Includes the following extras:
2400     * <ul>
2401     * <li> {@link #EXTRA_CHANGED_PACKAGE_LIST} is the set of packages
2402     * whose resources(were previously unavailable) are currently available.
2403     * {@link #EXTRA_CHANGED_UID_LIST} is the set of uids of the
2404     * packages whose resources(were previously unavailable)
2405     * are  currently available.
2406     * </ul>
2407     *
2408     * <p class="note">This is a protected intent that can only be sent
2409     * by the system.
2410     */
2411    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2412    public static final String ACTION_EXTERNAL_APPLICATIONS_AVAILABLE =
2413        "android.intent.action.EXTERNAL_APPLICATIONS_AVAILABLE";
2414
2415    /**
2416     * Broadcast Action: Resources for a set of packages are currently
2417     * unavailable since the media on which they exist is unavailable.
2418     * The extra data {@link #EXTRA_CHANGED_PACKAGE_LIST} contains a
2419     * list of packages whose availability changed.
2420     * The extra data {@link #EXTRA_CHANGED_UID_LIST} contains a
2421     * list of uids of packages whose availability changed.
2422     * The specified set of packages can no longer be
2423     * launched and are practically unavailable on the system.
2424     * <p>Inclues the following extras:
2425     * <ul>
2426     * <li> {@link #EXTRA_CHANGED_PACKAGE_LIST} is the set of packages
2427     * whose resources are no longer available.
2428     * {@link #EXTRA_CHANGED_UID_LIST} is the set of packages
2429     * whose resources are no longer available.
2430     * </ul>
2431     *
2432     * <p class="note">This is a protected intent that can only be sent
2433     * by the system.
2434     */
2435    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2436    public static final String ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE =
2437        "android.intent.action.EXTERNAL_APPLICATIONS_UNAVAILABLE";
2438
2439    /**
2440     * Broadcast Action: preferred activities have changed *explicitly*.
2441     *
2442     * <p>Note there are cases where a preferred activity is invalidated *implicitly*, e.g.
2443     * when an app is installed or uninstalled, but in such cases this broadcast will *not*
2444     * be sent.
2445     *
2446     * {@link #EXTRA_USER_HANDLE} contains the user ID in question.
2447     *
2448     * @hide
2449     */
2450    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2451    public static final String ACTION_PREFERRED_ACTIVITY_CHANGED =
2452            "android.intent.action.ACTION_PREFERRED_ACTIVITY_CHANGED";
2453
2454
2455    /**
2456     * Broadcast Action:  The current system wallpaper has changed.  See
2457     * {@link android.app.WallpaperManager} for retrieving the new wallpaper.
2458     * This should <em>only</em> be used to determine when the wallpaper
2459     * has changed to show the new wallpaper to the user.  You should certainly
2460     * never, in response to this, change the wallpaper or other attributes of
2461     * it such as the suggested size.  That would be crazy, right?  You'd cause
2462     * all kinds of loops, especially if other apps are doing similar things,
2463     * right?  Of course.  So please don't do this.
2464     *
2465     * @deprecated Modern applications should use
2466     * {@link android.view.WindowManager.LayoutParams#FLAG_SHOW_WALLPAPER
2467     * WindowManager.LayoutParams.FLAG_SHOW_WALLPAPER} to have the wallpaper
2468     * shown behind their UI, rather than watching for this broadcast and
2469     * rendering the wallpaper on their own.
2470     */
2471    @Deprecated @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2472    public static final String ACTION_WALLPAPER_CHANGED = "android.intent.action.WALLPAPER_CHANGED";
2473    /**
2474     * Broadcast Action: The current device {@link android.content.res.Configuration}
2475     * (orientation, locale, etc) has changed.  When such a change happens, the
2476     * UIs (view hierarchy) will need to be rebuilt based on this new
2477     * information; for the most part, applications don't need to worry about
2478     * this, because the system will take care of stopping and restarting the
2479     * application to make sure it sees the new changes.  Some system code that
2480     * can not be restarted will need to watch for this action and handle it
2481     * appropriately.
2482     *
2483     * <p class="note">
2484     * You <em>cannot</em> receive this through components declared
2485     * in manifests, only by explicitly registering for it with
2486     * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
2487     * Context.registerReceiver()}.
2488     *
2489     * <p class="note">This is a protected intent that can only be sent
2490     * by the system.
2491     *
2492     * @see android.content.res.Configuration
2493     */
2494    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2495    public static final String ACTION_CONFIGURATION_CHANGED = "android.intent.action.CONFIGURATION_CHANGED";
2496
2497    /**
2498     * Broadcast Action: The current device {@link android.content.res.Configuration} has changed
2499     * such that the device may be eligible for the installation of additional configuration splits.
2500     * Configuration properties that can trigger this broadcast include locale and display density.
2501     *
2502     * <p class="note">
2503     * Unlike {@link #ACTION_CONFIGURATION_CHANGED}, you <em>can</em> receive this through
2504     * components declared in manifests. However, the receiver <em>must</em> hold the
2505     * {@link android.Manifest.permission#INSTALL_PACKAGES} permission.
2506     *
2507     * <p class="note">
2508     * This is a protected intent that can only be sent by the system.
2509     *
2510     * @hide
2511     */
2512    @SystemApi
2513    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2514    public static final String ACTION_SPLIT_CONFIGURATION_CHANGED =
2515            "android.intent.action.SPLIT_CONFIGURATION_CHANGED";
2516    /**
2517     * Broadcast Action: The current device's locale has changed.
2518     *
2519     * <p class="note">This is a protected intent that can only be sent
2520     * by the system.
2521     */
2522    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2523    public static final String ACTION_LOCALE_CHANGED = "android.intent.action.LOCALE_CHANGED";
2524    /**
2525     * Broadcast Action:  This is a <em>sticky broadcast</em> containing the
2526     * charging state, level, and other information about the battery.
2527     * See {@link android.os.BatteryManager} for documentation on the
2528     * contents of the Intent.
2529     *
2530     * <p class="note">
2531     * You <em>cannot</em> receive this through components declared
2532     * in manifests, only by explicitly registering for it with
2533     * {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
2534     * Context.registerReceiver()}.  See {@link #ACTION_BATTERY_LOW},
2535     * {@link #ACTION_BATTERY_OKAY}, {@link #ACTION_POWER_CONNECTED},
2536     * and {@link #ACTION_POWER_DISCONNECTED} for distinct battery-related
2537     * broadcasts that are sent and can be received through manifest
2538     * receivers.
2539     *
2540     * <p class="note">This is a protected intent that can only be sent
2541     * by the system.
2542     */
2543    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2544    public static final String ACTION_BATTERY_CHANGED = "android.intent.action.BATTERY_CHANGED";
2545
2546
2547    /**
2548     * Broadcast Action: Sent when the current battery level changes.
2549     *
2550     * It has {@link android.os.BatteryManager#EXTRA_EVENTS} that carries a list of {@link Bundle}
2551     * instances representing individual battery level changes with associated
2552     * extras from {@link #ACTION_BATTERY_CHANGED}.
2553     *
2554     * <p class="note">
2555     * This broadcast requires {@link android.Manifest.permission#BATTERY_STATS} permission.
2556     *
2557     * @hide
2558     */
2559    @SystemApi
2560    public static final String ACTION_BATTERY_LEVEL_CHANGED =
2561            "android.intent.action.BATTERY_LEVEL_CHANGED";
2562    /**
2563     * Broadcast Action:  Indicates low battery condition on the device.
2564     * This broadcast corresponds to the "Low battery warning" system dialog.
2565     *
2566     * <p class="note">This is a protected intent that can only be sent
2567     * by the system.
2568     */
2569    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2570    public static final String ACTION_BATTERY_LOW = "android.intent.action.BATTERY_LOW";
2571    /**
2572     * Broadcast Action:  Indicates the battery is now okay after being low.
2573     * This will be sent after {@link #ACTION_BATTERY_LOW} once the battery has
2574     * gone back up to an okay state.
2575     *
2576     * <p class="note">This is a protected intent that can only be sent
2577     * by the system.
2578     */
2579    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2580    public static final String ACTION_BATTERY_OKAY = "android.intent.action.BATTERY_OKAY";
2581    /**
2582     * Broadcast Action:  External power has been connected to the device.
2583     * This is intended for applications that wish to register specifically to this notification.
2584     * Unlike ACTION_BATTERY_CHANGED, applications will be woken for this and so do not have to
2585     * stay active to receive this notification.  This action can be used to implement actions
2586     * that wait until power is available to trigger.
2587     *
2588     * <p class="note">This is a protected intent that can only be sent
2589     * by the system.
2590     */
2591    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2592    public static final String ACTION_POWER_CONNECTED = "android.intent.action.ACTION_POWER_CONNECTED";
2593    /**
2594     * Broadcast Action:  External power has been removed from the device.
2595     * This is intended for applications that wish to register specifically to this notification.
2596     * Unlike ACTION_BATTERY_CHANGED, applications will be woken for this and so do not have to
2597     * stay active to receive this notification.  This action can be used to implement actions
2598     * that wait until power is available to trigger.
2599     *
2600     * <p class="note">This is a protected intent that can only be sent
2601     * by the system.
2602     */
2603    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2604    public static final String ACTION_POWER_DISCONNECTED =
2605            "android.intent.action.ACTION_POWER_DISCONNECTED";
2606    /**
2607     * Broadcast Action:  Device is shutting down.
2608     * This is broadcast when the device is being shut down (completely turned
2609     * off, not sleeping).  Once the broadcast is complete, the final shutdown
2610     * will proceed and all unsaved data lost.  Apps will not normally need
2611     * to handle this, since the foreground activity will be paused as well.
2612     * <p>As of {@link Build.VERSION_CODES#P} this broadcast is only sent to receivers registered
2613     * through {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
2614     * Context.registerReceiver}.
2615     *
2616     * <p class="note">This is a protected intent that can only be sent
2617     * by the system.
2618     * <p>May include the following extras:
2619     * <ul>
2620     * <li> {@link #EXTRA_SHUTDOWN_USERSPACE_ONLY} a boolean that is set to true if this
2621     * shutdown is only for userspace processes.  If not set, assumed to be false.
2622     * </ul>
2623     */
2624    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2625    public static final String ACTION_SHUTDOWN = "android.intent.action.ACTION_SHUTDOWN";
2626    /**
2627     * Activity Action:  Start this activity to request system shutdown.
2628     * The optional boolean extra field {@link #EXTRA_KEY_CONFIRM} can be set to true
2629     * to request confirmation from the user before shutting down. The optional boolean
2630     * extra field {@link #EXTRA_USER_REQUESTED_SHUTDOWN} can be set to true to
2631     * indicate that the shutdown is requested by the user.
2632     *
2633     * <p class="note">This is a protected intent that can only be sent
2634     * by the system.
2635     *
2636     * {@hide}
2637     */
2638    public static final String ACTION_REQUEST_SHUTDOWN
2639            = "com.android.internal.intent.action.REQUEST_SHUTDOWN";
2640    /**
2641     * Broadcast Action: A sticky broadcast that indicates low storage space
2642     * condition on the device
2643     * <p class="note">
2644     * This is a protected intent that can only be sent by the system.
2645     *
2646     * @deprecated if your app targets {@link android.os.Build.VERSION_CODES#O}
2647     *             or above, this broadcast will no longer be delivered to any
2648     *             {@link BroadcastReceiver} defined in your manifest. Instead,
2649     *             apps are strongly encouraged to use the improved
2650     *             {@link Context#getCacheDir()} behavior so the system can
2651     *             automatically free up storage when needed.
2652     */
2653    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2654    @Deprecated
2655    public static final String ACTION_DEVICE_STORAGE_LOW = "android.intent.action.DEVICE_STORAGE_LOW";
2656    /**
2657     * Broadcast Action: Indicates low storage space condition on the device no
2658     * longer exists
2659     * <p class="note">
2660     * This is a protected intent that can only be sent by the system.
2661     *
2662     * @deprecated if your app targets {@link android.os.Build.VERSION_CODES#O}
2663     *             or above, this broadcast will no longer be delivered to any
2664     *             {@link BroadcastReceiver} defined in your manifest. Instead,
2665     *             apps are strongly encouraged to use the improved
2666     *             {@link Context#getCacheDir()} behavior so the system can
2667     *             automatically free up storage when needed.
2668     */
2669    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2670    @Deprecated
2671    public static final String ACTION_DEVICE_STORAGE_OK = "android.intent.action.DEVICE_STORAGE_OK";
2672    /**
2673     * Broadcast Action: A sticky broadcast that indicates a storage space full
2674     * condition on the device. This is intended for activities that want to be
2675     * able to fill the data partition completely, leaving only enough free
2676     * space to prevent system-wide SQLite failures.
2677     * <p class="note">
2678     * This is a protected intent that can only be sent by the system.
2679     *
2680     * @deprecated if your app targets {@link android.os.Build.VERSION_CODES#O}
2681     *             or above, this broadcast will no longer be delivered to any
2682     *             {@link BroadcastReceiver} defined in your manifest. Instead,
2683     *             apps are strongly encouraged to use the improved
2684     *             {@link Context#getCacheDir()} behavior so the system can
2685     *             automatically free up storage when needed.
2686     * @hide
2687     */
2688    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2689    @Deprecated
2690    public static final String ACTION_DEVICE_STORAGE_FULL = "android.intent.action.DEVICE_STORAGE_FULL";
2691    /**
2692     * Broadcast Action: Indicates storage space full condition on the device no
2693     * longer exists.
2694     * <p class="note">
2695     * This is a protected intent that can only be sent by the system.
2696     *
2697     * @deprecated if your app targets {@link android.os.Build.VERSION_CODES#O}
2698     *             or above, this broadcast will no longer be delivered to any
2699     *             {@link BroadcastReceiver} defined in your manifest. Instead,
2700     *             apps are strongly encouraged to use the improved
2701     *             {@link Context#getCacheDir()} behavior so the system can
2702     *             automatically free up storage when needed.
2703     * @hide
2704     */
2705    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2706    @Deprecated
2707    public static final String ACTION_DEVICE_STORAGE_NOT_FULL = "android.intent.action.DEVICE_STORAGE_NOT_FULL";
2708    /**
2709     * Broadcast Action:  Indicates low memory condition notification acknowledged by user
2710     * and package management should be started.
2711     * This is triggered by the user from the ACTION_DEVICE_STORAGE_LOW
2712     * notification.
2713     */
2714    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2715    public static final String ACTION_MANAGE_PACKAGE_STORAGE = "android.intent.action.MANAGE_PACKAGE_STORAGE";
2716    /**
2717     * Broadcast Action:  The device has entered USB Mass Storage mode.
2718     * This is used mainly for the USB Settings panel.
2719     * Apps should listen for ACTION_MEDIA_MOUNTED and ACTION_MEDIA_UNMOUNTED broadcasts to be notified
2720     * when the SD card file system is mounted or unmounted
2721     * @deprecated replaced by android.os.storage.StorageEventListener
2722     */
2723    @Deprecated
2724    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2725    public static final String ACTION_UMS_CONNECTED = "android.intent.action.UMS_CONNECTED";
2726
2727    /**
2728     * Broadcast Action:  The device has exited USB Mass Storage mode.
2729     * This is used mainly for the USB Settings panel.
2730     * Apps should listen for ACTION_MEDIA_MOUNTED and ACTION_MEDIA_UNMOUNTED broadcasts to be notified
2731     * when the SD card file system is mounted or unmounted
2732     * @deprecated replaced by android.os.storage.StorageEventListener
2733     */
2734    @Deprecated
2735    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2736    public static final String ACTION_UMS_DISCONNECTED = "android.intent.action.UMS_DISCONNECTED";
2737
2738    /**
2739     * Broadcast Action:  External media has been removed.
2740     * The path to the mount point for the removed media is contained in the Intent.mData field.
2741     */
2742    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2743    public static final String ACTION_MEDIA_REMOVED = "android.intent.action.MEDIA_REMOVED";
2744
2745    /**
2746     * Broadcast Action:  External media is present, but not mounted at its mount point.
2747     * The path to the mount point for the unmounted media is contained in the Intent.mData field.
2748     */
2749    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2750    public static final String ACTION_MEDIA_UNMOUNTED = "android.intent.action.MEDIA_UNMOUNTED";
2751
2752    /**
2753     * Broadcast Action:  External media is present, and being disk-checked
2754     * The path to the mount point for the checking media is contained in the Intent.mData field.
2755     */
2756    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2757    public static final String ACTION_MEDIA_CHECKING = "android.intent.action.MEDIA_CHECKING";
2758
2759    /**
2760     * Broadcast Action:  External media is present, but is using an incompatible fs (or is blank)
2761     * The path to the mount point for the checking media is contained in the Intent.mData field.
2762     */
2763    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2764    public static final String ACTION_MEDIA_NOFS = "android.intent.action.MEDIA_NOFS";
2765
2766    /**
2767     * Broadcast Action:  External media is present and mounted at its mount point.
2768     * The path to the mount point for the mounted media is contained in the Intent.mData field.
2769     * The Intent contains an extra with name "read-only" and Boolean value to indicate if the
2770     * media was mounted read only.
2771     */
2772    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2773    public static final String ACTION_MEDIA_MOUNTED = "android.intent.action.MEDIA_MOUNTED";
2774
2775    /**
2776     * Broadcast Action:  External media is unmounted because it is being shared via USB mass storage.
2777     * The path to the mount point for the shared media is contained in the Intent.mData field.
2778     */
2779    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2780    public static final String ACTION_MEDIA_SHARED = "android.intent.action.MEDIA_SHARED";
2781
2782    /**
2783     * Broadcast Action:  External media is no longer being shared via USB mass storage.
2784     * The path to the mount point for the previously shared media is contained in the Intent.mData field.
2785     *
2786     * @hide
2787     */
2788    public static final String ACTION_MEDIA_UNSHARED = "android.intent.action.MEDIA_UNSHARED";
2789
2790    /**
2791     * Broadcast Action:  External media was removed from SD card slot, but mount point was not unmounted.
2792     * The path to the mount point for the removed media is contained in the Intent.mData field.
2793     */
2794    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2795    public static final String ACTION_MEDIA_BAD_REMOVAL = "android.intent.action.MEDIA_BAD_REMOVAL";
2796
2797    /**
2798     * Broadcast Action:  External media is present but cannot be mounted.
2799     * The path to the mount point for the unmountable media is contained in the Intent.mData field.
2800     */
2801    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2802    public static final String ACTION_MEDIA_UNMOUNTABLE = "android.intent.action.MEDIA_UNMOUNTABLE";
2803
2804   /**
2805     * Broadcast Action:  User has expressed the desire to remove the external storage media.
2806     * Applications should close all files they have open within the mount point when they receive this intent.
2807     * The path to the mount point for the media to be ejected is contained in the Intent.mData field.
2808     */
2809    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2810    public static final String ACTION_MEDIA_EJECT = "android.intent.action.MEDIA_EJECT";
2811
2812    /**
2813     * Broadcast Action:  The media scanner has started scanning a directory.
2814     * The path to the directory being scanned is contained in the Intent.mData field.
2815     */
2816    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2817    public static final String ACTION_MEDIA_SCANNER_STARTED = "android.intent.action.MEDIA_SCANNER_STARTED";
2818
2819   /**
2820     * Broadcast Action:  The media scanner has finished scanning a directory.
2821     * The path to the scanned directory is contained in the Intent.mData field.
2822     */
2823    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2824    public static final String ACTION_MEDIA_SCANNER_FINISHED = "android.intent.action.MEDIA_SCANNER_FINISHED";
2825
2826   /**
2827     * Broadcast Action:  Request the media scanner to scan a file and add it to the media database.
2828     * The path to the file is contained in the Intent.mData field.
2829     */
2830    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2831    public static final String ACTION_MEDIA_SCANNER_SCAN_FILE = "android.intent.action.MEDIA_SCANNER_SCAN_FILE";
2832
2833   /**
2834     * Broadcast Action:  The "Media Button" was pressed.  Includes a single
2835     * extra field, {@link #EXTRA_KEY_EVENT}, containing the key event that
2836     * caused the broadcast.
2837     */
2838    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2839    public static final String ACTION_MEDIA_BUTTON = "android.intent.action.MEDIA_BUTTON";
2840
2841    /**
2842     * Broadcast Action:  The "Camera Button" was pressed.  Includes a single
2843     * extra field, {@link #EXTRA_KEY_EVENT}, containing the key event that
2844     * caused the broadcast.
2845     */
2846    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2847    public static final String ACTION_CAMERA_BUTTON = "android.intent.action.CAMERA_BUTTON";
2848
2849    // *** NOTE: @todo(*) The following really should go into a more domain-specific
2850    // location; they are not general-purpose actions.
2851
2852    /**
2853     * Broadcast Action: A GTalk connection has been established.
2854     */
2855    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2856    public static final String ACTION_GTALK_SERVICE_CONNECTED =
2857            "android.intent.action.GTALK_CONNECTED";
2858
2859    /**
2860     * Broadcast Action: A GTalk connection has been disconnected.
2861     */
2862    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2863    public static final String ACTION_GTALK_SERVICE_DISCONNECTED =
2864            "android.intent.action.GTALK_DISCONNECTED";
2865
2866    /**
2867     * Broadcast Action: An input method has been changed.
2868     */
2869    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2870    public static final String ACTION_INPUT_METHOD_CHANGED =
2871            "android.intent.action.INPUT_METHOD_CHANGED";
2872
2873    /**
2874     * <p>Broadcast Action: The user has switched the phone into or out of Airplane Mode. One or
2875     * more radios have been turned off or on. The intent will have the following extra value:</p>
2876     * <ul>
2877     *   <li><em>state</em> - A boolean value indicating whether Airplane Mode is on. If true,
2878     *   then cell radio and possibly other radios such as bluetooth or WiFi may have also been
2879     *   turned off</li>
2880     * </ul>
2881     *
2882     * <p class="note">This is a protected intent that can only be sent by the system.</p>
2883     */
2884    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2885    public static final String ACTION_AIRPLANE_MODE_CHANGED = "android.intent.action.AIRPLANE_MODE";
2886
2887    /**
2888     * Broadcast Action: Some content providers have parts of their namespace
2889     * where they publish new events or items that the user may be especially
2890     * interested in. For these things, they may broadcast this action when the
2891     * set of interesting items change.
2892     *
2893     * For example, GmailProvider sends this notification when the set of unread
2894     * mail in the inbox changes.
2895     *
2896     * <p>The data of the intent identifies which part of which provider
2897     * changed. When queried through the content resolver, the data URI will
2898     * return the data set in question.
2899     *
2900     * <p>The intent will have the following extra values:
2901     * <ul>
2902     *   <li><em>count</em> - The number of items in the data set. This is the
2903     *       same as the number of items in the cursor returned by querying the
2904     *       data URI. </li>
2905     * </ul>
2906     *
2907     * This intent will be sent at boot (if the count is non-zero) and when the
2908     * data set changes. It is possible for the data set to change without the
2909     * count changing (for example, if a new unread message arrives in the same
2910     * sync operation in which a message is archived). The phone should still
2911     * ring/vibrate/etc as normal in this case.
2912     */
2913    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2914    public static final String ACTION_PROVIDER_CHANGED =
2915            "android.intent.action.PROVIDER_CHANGED";
2916
2917    /**
2918     * Broadcast Action: Wired Headset plugged in or unplugged.
2919     *
2920     * Same as {@link android.media.AudioManager#ACTION_HEADSET_PLUG}, to be consulted for value
2921     *   and documentation.
2922     * <p>If the minimum SDK version of your application is
2923     * {@link android.os.Build.VERSION_CODES#LOLLIPOP}, it is recommended to refer
2924     * to the <code>AudioManager</code> constant in your receiver registration code instead.
2925     */
2926    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2927    public static final String ACTION_HEADSET_PLUG = android.media.AudioManager.ACTION_HEADSET_PLUG;
2928
2929    /**
2930     * <p>Broadcast Action: The user has switched on advanced settings in the settings app:</p>
2931     * <ul>
2932     *   <li><em>state</em> - A boolean value indicating whether the settings is on or off.</li>
2933     * </ul>
2934     *
2935     * <p class="note">This is a protected intent that can only be sent
2936     * by the system.
2937     *
2938     * @hide
2939     */
2940    //@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2941    public static final String ACTION_ADVANCED_SETTINGS_CHANGED
2942            = "android.intent.action.ADVANCED_SETTINGS";
2943
2944    /**
2945     *  Broadcast Action: Sent after application restrictions are changed.
2946     *
2947     * <p class="note">This is a protected intent that can only be sent
2948     * by the system.</p>
2949     */
2950    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2951    public static final String ACTION_APPLICATION_RESTRICTIONS_CHANGED =
2952            "android.intent.action.APPLICATION_RESTRICTIONS_CHANGED";
2953
2954    /**
2955     * Broadcast Action: An outgoing call is about to be placed.
2956     *
2957     * <p>The Intent will have the following extra value:</p>
2958     * <ul>
2959     *   <li><em>{@link android.content.Intent#EXTRA_PHONE_NUMBER}</em> -
2960     *       the phone number originally intended to be dialed.</li>
2961     * </ul>
2962     * <p>Once the broadcast is finished, the resultData is used as the actual
2963     * number to call.  If  <code>null</code>, no call will be placed.</p>
2964     * <p>It is perfectly acceptable for multiple receivers to process the
2965     * outgoing call in turn: for example, a parental control application
2966     * might verify that the user is authorized to place the call at that
2967     * time, then a number-rewriting application might add an area code if
2968     * one was not specified.</p>
2969     * <p>For consistency, any receiver whose purpose is to prohibit phone
2970     * calls should have a priority of 0, to ensure it will see the final
2971     * phone number to be dialed.
2972     * Any receiver whose purpose is to rewrite phone numbers to be called
2973     * should have a positive priority.
2974     * Negative priorities are reserved for the system for this broadcast;
2975     * using them may cause problems.</p>
2976     * <p>Any BroadcastReceiver receiving this Intent <em>must not</em>
2977     * abort the broadcast.</p>
2978     * <p>Emergency calls cannot be intercepted using this mechanism, and
2979     * other calls cannot be modified to call emergency numbers using this
2980     * mechanism.
2981     * <p>Some apps (such as VoIP apps) may want to redirect the outgoing
2982     * call to use their own service instead. Those apps should first prevent
2983     * the call from being placed by setting resultData to <code>null</code>
2984     * and then start their own app to make the call.
2985     * <p>You must hold the
2986     * {@link android.Manifest.permission#PROCESS_OUTGOING_CALLS}
2987     * permission to receive this Intent.</p>
2988     *
2989     * <p class="note">This is a protected intent that can only be sent
2990     * by the system.
2991     */
2992    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
2993    public static final String ACTION_NEW_OUTGOING_CALL =
2994            "android.intent.action.NEW_OUTGOING_CALL";
2995
2996    /**
2997     * Broadcast Action: Have the device reboot.  This is only for use by
2998     * system code.
2999     *
3000     * <p class="note">This is a protected intent that can only be sent
3001     * by the system.
3002     */
3003    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3004    public static final String ACTION_REBOOT =
3005            "android.intent.action.REBOOT";
3006
3007    /**
3008     * Broadcast Action:  A sticky broadcast for changes in the physical
3009     * docking state of the device.
3010     *
3011     * <p>The intent will have the following extra values:
3012     * <ul>
3013     *   <li><em>{@link #EXTRA_DOCK_STATE}</em> - the current dock
3014     *       state, indicating which dock the device is physically in.</li>
3015     * </ul>
3016     * <p>This is intended for monitoring the current physical dock state.
3017     * See {@link android.app.UiModeManager} for the normal API dealing with
3018     * dock mode changes.
3019     */
3020    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3021    public static final String ACTION_DOCK_EVENT =
3022            "android.intent.action.DOCK_EVENT";
3023
3024    /**
3025     * Broadcast Action: A broadcast when idle maintenance can be started.
3026     * This means that the user is not interacting with the device and is
3027     * not expected to do so soon. Typical use of the idle maintenance is
3028     * to perform somehow expensive tasks that can be postponed at a moment
3029     * when they will not degrade user experience.
3030     * <p>
3031     * <p class="note">In order to keep the device responsive in case of an
3032     * unexpected user interaction, implementations of a maintenance task
3033     * should be interruptible. In such a scenario a broadcast with action
3034     * {@link #ACTION_IDLE_MAINTENANCE_END} will be sent. In other words, you
3035     * should not do the maintenance work in
3036     * {@link BroadcastReceiver#onReceive(Context, Intent)}, rather start a
3037     * maintenance service by {@link Context#startService(Intent)}. Also
3038     * you should hold a wake lock while your maintenance service is running
3039     * to prevent the device going to sleep.
3040     * </p>
3041     * <p>
3042     * <p class="note">This is a protected intent that can only be sent by
3043     * the system.
3044     * </p>
3045     *
3046     * @see #ACTION_IDLE_MAINTENANCE_END
3047     *
3048     * @hide
3049     */
3050    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3051    public static final String ACTION_IDLE_MAINTENANCE_START =
3052            "android.intent.action.ACTION_IDLE_MAINTENANCE_START";
3053
3054    /**
3055     * Broadcast Action:  A broadcast when idle maintenance should be stopped.
3056     * This means that the user was not interacting with the device as a result
3057     * of which a broadcast with action {@link #ACTION_IDLE_MAINTENANCE_START}
3058     * was sent and now the user started interacting with the device. Typical
3059     * use of the idle maintenance is to perform somehow expensive tasks that
3060     * can be postponed at a moment when they will not degrade user experience.
3061     * <p>
3062     * <p class="note">In order to keep the device responsive in case of an
3063     * unexpected user interaction, implementations of a maintenance task
3064     * should be interruptible. Hence, on receiving a broadcast with this
3065     * action, the maintenance task should be interrupted as soon as possible.
3066     * In other words, you should not do the maintenance work in
3067     * {@link BroadcastReceiver#onReceive(Context, Intent)}, rather stop the
3068     * maintenance service that was started on receiving of
3069     * {@link #ACTION_IDLE_MAINTENANCE_START}.Also you should release the wake
3070     * lock you acquired when your maintenance service started.
3071     * </p>
3072     * <p class="note">This is a protected intent that can only be sent
3073     * by the system.
3074     *
3075     * @see #ACTION_IDLE_MAINTENANCE_START
3076     *
3077     * @hide
3078     */
3079    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3080    public static final String ACTION_IDLE_MAINTENANCE_END =
3081            "android.intent.action.ACTION_IDLE_MAINTENANCE_END";
3082
3083    /**
3084     * Broadcast Action: a remote intent is to be broadcasted.
3085     *
3086     * A remote intent is used for remote RPC between devices. The remote intent
3087     * is serialized and sent from one device to another device. The receiving
3088     * device parses the remote intent and broadcasts it. Note that anyone can
3089     * broadcast a remote intent. However, if the intent receiver of the remote intent
3090     * does not trust intent broadcasts from arbitrary intent senders, it should require
3091     * the sender to hold certain permissions so only trusted sender's broadcast will be
3092     * let through.
3093     * @hide
3094     */
3095    public static final String ACTION_REMOTE_INTENT =
3096            "com.google.android.c2dm.intent.RECEIVE";
3097
3098    /**
3099     * Broadcast Action: This is broadcast once when the user is booting after a
3100     * system update. It can be used to perform cleanup or upgrades after a
3101     * system update.
3102     * <p>
3103     * This broadcast is sent after the {@link #ACTION_LOCKED_BOOT_COMPLETED}
3104     * broadcast but before the {@link #ACTION_BOOT_COMPLETED} broadcast. It's
3105     * only sent when the {@link Build#FINGERPRINT} has changed, and it's only
3106     * sent to receivers in the system image.
3107     *
3108     * @hide
3109     */
3110    @SystemApi
3111    public static final String ACTION_PRE_BOOT_COMPLETED =
3112            "android.intent.action.PRE_BOOT_COMPLETED";
3113
3114    /**
3115     * Broadcast to a specific application to query any supported restrictions to impose
3116     * on restricted users. The broadcast intent contains an extra
3117     * {@link #EXTRA_RESTRICTIONS_BUNDLE} with the currently persisted
3118     * restrictions as a Bundle of key/value pairs. The value types can be Boolean, String or
3119     * String[] depending on the restriction type.<p/>
3120     * The response should contain an extra {@link #EXTRA_RESTRICTIONS_LIST},
3121     * which is of type <code>ArrayList&lt;RestrictionEntry&gt;</code>. It can also
3122     * contain an extra {@link #EXTRA_RESTRICTIONS_INTENT}, which is of type <code>Intent</code>.
3123     * The activity specified by that intent will be launched for a result which must contain
3124     * one of the extras {@link #EXTRA_RESTRICTIONS_LIST} or {@link #EXTRA_RESTRICTIONS_BUNDLE}.
3125     * The keys and values of the returned restrictions will be persisted.
3126     * @see RestrictionEntry
3127     */
3128    public static final String ACTION_GET_RESTRICTION_ENTRIES =
3129            "android.intent.action.GET_RESTRICTION_ENTRIES";
3130
3131    /**
3132     * Sent the first time a user is starting, to allow system apps to
3133     * perform one time initialization.  (This will not be seen by third
3134     * party applications because a newly initialized user does not have any
3135     * third party applications installed for it.)  This is sent early in
3136     * starting the user, around the time the home app is started, before
3137     * {@link #ACTION_BOOT_COMPLETED} is sent.  This is sent as a foreground
3138     * broadcast, since it is part of a visible user interaction; be as quick
3139     * as possible when handling it.
3140     */
3141    public static final String ACTION_USER_INITIALIZE =
3142            "android.intent.action.USER_INITIALIZE";
3143
3144    /**
3145     * Sent when a user switch is happening, causing the process's user to be
3146     * brought to the foreground.  This is only sent to receivers registered
3147     * through {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
3148     * Context.registerReceiver}.  It is sent to the user that is going to the
3149     * foreground.  This is sent as a foreground
3150     * broadcast, since it is part of a visible user interaction; be as quick
3151     * as possible when handling it.
3152     */
3153    public static final String ACTION_USER_FOREGROUND =
3154            "android.intent.action.USER_FOREGROUND";
3155
3156    /**
3157     * Sent when a user switch is happening, causing the process's user to be
3158     * sent to the background.  This is only sent to receivers registered
3159     * through {@link Context#registerReceiver(BroadcastReceiver, IntentFilter)
3160     * Context.registerReceiver}.  It is sent to the user that is going to the
3161     * background.  This is sent as a foreground
3162     * broadcast, since it is part of a visible user interaction; be as quick
3163     * as possible when handling it.
3164     */
3165    public static final String ACTION_USER_BACKGROUND =
3166            "android.intent.action.USER_BACKGROUND";
3167
3168    /**
3169     * Broadcast sent to the system when a user is added. Carries an extra
3170     * EXTRA_USER_HANDLE that has the userHandle of the new user.  It is sent to
3171     * all running users.  You must hold
3172     * {@link android.Manifest.permission#MANAGE_USERS} to receive this broadcast.
3173     * @hide
3174     */
3175    public static final String ACTION_USER_ADDED =
3176            "android.intent.action.USER_ADDED";
3177
3178    /**
3179     * Broadcast sent by the system when a user is started. Carries an extra
3180     * EXTRA_USER_HANDLE that has the userHandle of the user.  This is only sent to
3181     * registered receivers, not manifest receivers.  It is sent to the user
3182     * that has been started.  This is sent as a foreground
3183     * broadcast, since it is part of a visible user interaction; be as quick
3184     * as possible when handling it.
3185     * @hide
3186     */
3187    public static final String ACTION_USER_STARTED =
3188            "android.intent.action.USER_STARTED";
3189
3190    /**
3191     * Broadcast sent when a user is in the process of starting.  Carries an extra
3192     * EXTRA_USER_HANDLE that has the userHandle of the user.  This is only
3193     * sent to registered receivers, not manifest receivers.  It is sent to all
3194     * users (including the one that is being started).  You must hold
3195     * {@link android.Manifest.permission#INTERACT_ACROSS_USERS} to receive
3196     * this broadcast.  This is sent as a background broadcast, since
3197     * its result is not part of the primary UX flow; to safely keep track of
3198     * started/stopped state of a user you can use this in conjunction with
3199     * {@link #ACTION_USER_STOPPING}.  It is <b>not</b> generally safe to use with
3200     * other user state broadcasts since those are foreground broadcasts so can
3201     * execute in a different order.
3202     * @hide
3203     */
3204    public static final String ACTION_USER_STARTING =
3205            "android.intent.action.USER_STARTING";
3206
3207    /**
3208     * Broadcast sent when a user is going to be stopped.  Carries an extra
3209     * EXTRA_USER_HANDLE that has the userHandle of the user.  This is only
3210     * sent to registered receivers, not manifest receivers.  It is sent to all
3211     * users (including the one that is being stopped).  You must hold
3212     * {@link android.Manifest.permission#INTERACT_ACROSS_USERS} to receive
3213     * this broadcast.  The user will not stop until all receivers have
3214     * handled the broadcast.  This is sent as a background broadcast, since
3215     * its result is not part of the primary UX flow; to safely keep track of
3216     * started/stopped state of a user you can use this in conjunction with
3217     * {@link #ACTION_USER_STARTING}.  It is <b>not</b> generally safe to use with
3218     * other user state broadcasts since those are foreground broadcasts so can
3219     * execute in a different order.
3220     * @hide
3221     */
3222    public static final String ACTION_USER_STOPPING =
3223            "android.intent.action.USER_STOPPING";
3224
3225    /**
3226     * Broadcast sent to the system when a user is stopped. Carries an extra
3227     * EXTRA_USER_HANDLE that has the userHandle of the user.  This is similar to
3228     * {@link #ACTION_PACKAGE_RESTARTED}, but for an entire user instead of a
3229     * specific package.  This is only sent to registered receivers, not manifest
3230     * receivers.  It is sent to all running users <em>except</em> the one that
3231     * has just been stopped (which is no longer running).
3232     * @hide
3233     */
3234    public static final String ACTION_USER_STOPPED =
3235            "android.intent.action.USER_STOPPED";
3236
3237    /**
3238     * Broadcast sent to the system when a user is removed. Carries an extra EXTRA_USER_HANDLE that has
3239     * the userHandle of the user.  It is sent to all running users except the
3240     * one that has been removed. The user will not be completely removed until all receivers have
3241     * handled the broadcast. You must hold
3242     * {@link android.Manifest.permission#MANAGE_USERS} to receive this broadcast.
3243     * @hide
3244     */
3245    @SystemApi
3246    public static final String ACTION_USER_REMOVED =
3247            "android.intent.action.USER_REMOVED";
3248
3249    /**
3250     * Broadcast sent to the system when the user switches. Carries an extra EXTRA_USER_HANDLE that has
3251     * the userHandle of the user to become the current one. This is only sent to
3252     * registered receivers, not manifest receivers.  It is sent to all running users.
3253     * You must hold
3254     * {@link android.Manifest.permission#MANAGE_USERS} to receive this broadcast.
3255     * @hide
3256     */
3257    public static final String ACTION_USER_SWITCHED =
3258            "android.intent.action.USER_SWITCHED";
3259
3260    /**
3261     * Broadcast Action: Sent when the credential-encrypted private storage has
3262     * become unlocked for the target user. This is only sent to registered
3263     * receivers, not manifest receivers.
3264     */
3265    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3266    public static final String ACTION_USER_UNLOCKED = "android.intent.action.USER_UNLOCKED";
3267
3268    /**
3269     * Broadcast sent to the system when a user's information changes. Carries an extra
3270     * {@link #EXTRA_USER_HANDLE} to indicate which user's information changed.
3271     * This is only sent to registered receivers, not manifest receivers. It is sent to all users.
3272     * @hide
3273     */
3274    public static final String ACTION_USER_INFO_CHANGED =
3275            "android.intent.action.USER_INFO_CHANGED";
3276
3277    /**
3278     * Broadcast sent to the primary user when an associated managed profile is added (the profile
3279     * was created and is ready to be used). Carries an extra {@link #EXTRA_USER} that specifies
3280     * the UserHandle of the profile that was added. Only applications (for example Launchers)
3281     * that need to display merged content across both primary and managed profiles need to
3282     * worry about this broadcast. This is only sent to registered receivers,
3283     * not manifest receivers.
3284     */
3285    public static final String ACTION_MANAGED_PROFILE_ADDED =
3286            "android.intent.action.MANAGED_PROFILE_ADDED";
3287
3288    /**
3289     * Broadcast sent to the primary user when an associated managed profile is removed. Carries an
3290     * extra {@link #EXTRA_USER} that specifies the UserHandle of the profile that was removed.
3291     * Only applications (for example Launchers) that need to display merged content across both
3292     * primary and managed profiles need to worry about this broadcast. This is only sent to
3293     * registered receivers, not manifest receivers.
3294     */
3295    public static final String ACTION_MANAGED_PROFILE_REMOVED =
3296            "android.intent.action.MANAGED_PROFILE_REMOVED";
3297
3298    /**
3299     * Broadcast sent to the primary user when the credential-encrypted private storage for
3300     * an associated managed profile is unlocked. Carries an extra {@link #EXTRA_USER} that
3301     * specifies the UserHandle of the profile that was unlocked. Only applications (for example
3302     * Launchers) that need to display merged content across both primary and managed profiles
3303     * need to worry about this broadcast. This is only sent to registered receivers,
3304     * not manifest receivers.
3305     */
3306    public static final String ACTION_MANAGED_PROFILE_UNLOCKED =
3307            "android.intent.action.MANAGED_PROFILE_UNLOCKED";
3308
3309    /**
3310     * Broadcast sent to the primary user when an associated managed profile has become available.
3311     * Currently this includes when the user disables quiet mode for the profile. Carries an extra
3312     * {@link #EXTRA_USER} that specifies the UserHandle of the profile. When quiet mode is changed,
3313     * this broadcast will carry a boolean extra {@link #EXTRA_QUIET_MODE} indicating the new state
3314     * of quiet mode. This is only sent to registered receivers, not manifest receivers.
3315     */
3316    public static final String ACTION_MANAGED_PROFILE_AVAILABLE =
3317            "android.intent.action.MANAGED_PROFILE_AVAILABLE";
3318
3319    /**
3320     * Broadcast sent to the primary user when an associated managed profile has become unavailable.
3321     * Currently this includes when the user enables quiet mode for the profile. Carries an extra
3322     * {@link #EXTRA_USER} that specifies the UserHandle of the profile. When quiet mode is changed,
3323     * this broadcast will carry a boolean extra {@link #EXTRA_QUIET_MODE} indicating the new state
3324     * of quiet mode. This is only sent to registered receivers, not manifest receivers.
3325     */
3326    public static final String ACTION_MANAGED_PROFILE_UNAVAILABLE =
3327            "android.intent.action.MANAGED_PROFILE_UNAVAILABLE";
3328
3329    /**
3330     * Broadcast sent to the system user when the 'device locked' state changes for any user.
3331     * Carries an extra {@link #EXTRA_USER_HANDLE} that specifies the ID of the user for which
3332     * the device was locked or unlocked.
3333     *
3334     * This is only sent to registered receivers.
3335     *
3336     * @hide
3337     */
3338    public static final String ACTION_DEVICE_LOCKED_CHANGED =
3339            "android.intent.action.DEVICE_LOCKED_CHANGED";
3340
3341    /**
3342     * Sent when the user taps on the clock widget in the system's "quick settings" area.
3343     */
3344    public static final String ACTION_QUICK_CLOCK =
3345            "android.intent.action.QUICK_CLOCK";
3346
3347    /**
3348     * Activity Action: Shows the brightness setting dialog.
3349     * @hide
3350     */
3351    public static final String ACTION_SHOW_BRIGHTNESS_DIALOG =
3352            "com.android.intent.action.SHOW_BRIGHTNESS_DIALOG";
3353
3354    /**
3355     * Broadcast Action:  A global button was pressed.  Includes a single
3356     * extra field, {@link #EXTRA_KEY_EVENT}, containing the key event that
3357     * caused the broadcast.
3358     * @hide
3359     */
3360    @SystemApi
3361    public static final String ACTION_GLOBAL_BUTTON = "android.intent.action.GLOBAL_BUTTON";
3362
3363    /**
3364     * Broadcast Action: Sent when media resource is granted.
3365     * <p>
3366     * {@link #EXTRA_PACKAGES} specifies the packages on the process holding the media resource
3367     * granted.
3368     * </p>
3369     * <p class="note">
3370     * This is a protected intent that can only be sent by the system.
3371     * </p>
3372     * <p class="note">
3373     * This requires {@link android.Manifest.permission#RECEIVE_MEDIA_RESOURCE_USAGE} permission.
3374     * </p>
3375     *
3376     * @hide
3377     */
3378    public static final String ACTION_MEDIA_RESOURCE_GRANTED =
3379            "android.intent.action.MEDIA_RESOURCE_GRANTED";
3380
3381    /**
3382     * Broadcast Action: An overlay package has changed. The data contains the
3383     * name of the overlay package which has changed. This is broadcast on all
3384     * changes to the OverlayInfo returned by {@link
3385     * android.content.om.IOverlayManager#getOverlayInfo(String, int)}. The
3386     * most common change is a state change that will change whether the
3387     * overlay is enabled or not.
3388     * @hide
3389     */
3390    public static final String ACTION_OVERLAY_CHANGED = "android.intent.action.OVERLAY_CHANGED";
3391
3392    /**
3393     * Activity Action: Allow the user to select and return one or more existing
3394     * documents. When invoked, the system will display the various
3395     * {@link DocumentsProvider} instances installed on the device, letting the
3396     * user interactively navigate through them. These documents include local
3397     * media, such as photos and video, and documents provided by installed
3398     * cloud storage providers.
3399     * <p>
3400     * Each document is represented as a {@code content://} URI backed by a
3401     * {@link DocumentsProvider}, which can be opened as a stream with
3402     * {@link ContentResolver#openFileDescriptor(Uri, String)}, or queried for
3403     * {@link android.provider.DocumentsContract.Document} metadata.
3404     * <p>
3405     * All selected documents are returned to the calling application with
3406     * persistable read and write permission grants. If you want to maintain
3407     * access to the documents across device reboots, you need to explicitly
3408     * take the persistable permissions using
3409     * {@link ContentResolver#takePersistableUriPermission(Uri, int)}.
3410     * <p>
3411     * Callers must indicate the acceptable document MIME types through
3412     * {@link #setType(String)}. For example, to select photos, use
3413     * {@code image/*}. If multiple disjoint MIME types are acceptable, define
3414     * them in {@link #EXTRA_MIME_TYPES} and {@link #setType(String)} to
3415     * {@literal *}/*.
3416     * <p>
3417     * If the caller can handle multiple returned items (the user performing
3418     * multiple selection), then you can specify {@link #EXTRA_ALLOW_MULTIPLE}
3419     * to indicate this.
3420     * <p>
3421     * Callers must include {@link #CATEGORY_OPENABLE} in the Intent to obtain
3422     * URIs that can be opened with
3423     * {@link ContentResolver#openFileDescriptor(Uri, String)}.
3424     * <p>
3425     * Callers can set a document URI through
3426     * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial
3427     * location of documents navigator. System will do its best to launch the
3428     * navigator in the specified document if it's a folder, or the folder that
3429     * contains the specified document if not.
3430     * <p>
3431     * Output: The URI of the item that was picked, returned in
3432     * {@link #getData()}. This must be a {@code content://} URI so that any
3433     * receiver can access it. If multiple documents were selected, they are
3434     * returned in {@link #getClipData()}.
3435     *
3436     * @see DocumentsContract
3437     * @see #ACTION_OPEN_DOCUMENT_TREE
3438     * @see #ACTION_CREATE_DOCUMENT
3439     * @see #FLAG_GRANT_PERSISTABLE_URI_PERMISSION
3440     */
3441    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
3442    public static final String ACTION_OPEN_DOCUMENT = "android.intent.action.OPEN_DOCUMENT";
3443
3444    /**
3445     * Activity Action: Allow the user to create a new document. When invoked,
3446     * the system will display the various {@link DocumentsProvider} instances
3447     * installed on the device, letting the user navigate through them. The
3448     * returned document may be a newly created document with no content, or it
3449     * may be an existing document with the requested MIME type.
3450     * <p>
3451     * Each document is represented as a {@code content://} URI backed by a
3452     * {@link DocumentsProvider}, which can be opened as a stream with
3453     * {@link ContentResolver#openFileDescriptor(Uri, String)}, or queried for
3454     * {@link android.provider.DocumentsContract.Document} metadata.
3455     * <p>
3456     * Callers must indicate the concrete MIME type of the document being
3457     * created by setting {@link #setType(String)}. This MIME type cannot be
3458     * changed after the document is created.
3459     * <p>
3460     * Callers can provide an initial display name through {@link #EXTRA_TITLE},
3461     * but the user may change this value before creating the file.
3462     * <p>
3463     * Callers must include {@link #CATEGORY_OPENABLE} in the Intent to obtain
3464     * URIs that can be opened with
3465     * {@link ContentResolver#openFileDescriptor(Uri, String)}.
3466     * <p>
3467     * Callers can set a document URI through
3468     * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial
3469     * location of documents navigator. System will do its best to launch the
3470     * navigator in the specified document if it's a folder, or the folder that
3471     * contains the specified document if not.
3472     * <p>
3473     * Output: The URI of the item that was created. This must be a
3474     * {@code content://} URI so that any receiver can access it.
3475     *
3476     * @see DocumentsContract
3477     * @see #ACTION_OPEN_DOCUMENT
3478     * @see #ACTION_OPEN_DOCUMENT_TREE
3479     * @see #FLAG_GRANT_PERSISTABLE_URI_PERMISSION
3480     */
3481    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
3482    public static final String ACTION_CREATE_DOCUMENT = "android.intent.action.CREATE_DOCUMENT";
3483
3484    /**
3485     * Activity Action: Allow the user to pick a directory subtree. When
3486     * invoked, the system will display the various {@link DocumentsProvider}
3487     * instances installed on the device, letting the user navigate through
3488     * them. Apps can fully manage documents within the returned directory.
3489     * <p>
3490     * To gain access to descendant (child, grandchild, etc) documents, use
3491     * {@link DocumentsContract#buildDocumentUriUsingTree(Uri, String)} and
3492     * {@link DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)}
3493     * with the returned URI.
3494     * <p>
3495     * Callers can set a document URI through
3496     * {@link DocumentsContract#EXTRA_INITIAL_URI} to indicate the initial
3497     * location of documents navigator. System will do its best to launch the
3498     * navigator in the specified document if it's a folder, or the folder that
3499     * contains the specified document if not.
3500     * <p>
3501     * Output: The URI representing the selected directory tree.
3502     *
3503     * @see DocumentsContract
3504     */
3505    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
3506    public static final String
3507            ACTION_OPEN_DOCUMENT_TREE = "android.intent.action.OPEN_DOCUMENT_TREE";
3508
3509    /**
3510     * Broadcast Action: List of dynamic sensor is changed due to new sensor being connected or
3511     * exisiting sensor being disconnected.
3512     *
3513     * <p class="note">This is a protected intent that can only be sent by the system.</p>
3514     *
3515     * {@hide}
3516     */
3517    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3518    public static final String
3519            ACTION_DYNAMIC_SENSOR_CHANGED = "android.intent.action.DYNAMIC_SENSOR_CHANGED";
3520
3521    /**
3522     * Deprecated - use ACTION_FACTORY_RESET instead.
3523     * @hide
3524     * @removed
3525     */
3526    @Deprecated
3527    @SystemApi
3528    public static final String ACTION_MASTER_CLEAR = "android.intent.action.MASTER_CLEAR";
3529
3530    /**
3531     * Broadcast intent sent by the RecoverySystem to inform listeners that a master clear (wipe)
3532     * is about to be performed.
3533     * @hide
3534     */
3535    @SystemApi
3536    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3537    public static final String ACTION_MASTER_CLEAR_NOTIFICATION
3538            = "android.intent.action.MASTER_CLEAR_NOTIFICATION";
3539
3540    /**
3541     * Boolean intent extra to be used with {@link #ACTION_MASTER_CLEAR} in order to force a factory
3542     * reset even if {@link android.os.UserManager#DISALLOW_FACTORY_RESET} is set.
3543     *
3544     * <p>Deprecated - use {@link #EXTRA_FORCE_FACTORY_RESET} instead.
3545     *
3546     * @hide
3547     */
3548    @Deprecated
3549    public static final String EXTRA_FORCE_MASTER_CLEAR =
3550            "android.intent.extra.FORCE_MASTER_CLEAR";
3551
3552    /**
3553     * A broadcast action to trigger a factory reset.
3554     *
3555     * <p>The sender must hold the {@link android.Manifest.permission#MASTER_CLEAR} permission. The
3556     * reason for the factory reset should be specified as {@link #EXTRA_REASON}.
3557     *
3558     * <p>Not for use by third-party applications.
3559     *
3560     * @see #EXTRA_FORCE_FACTORY_RESET
3561     *
3562     * {@hide}
3563     */
3564    @SystemApi
3565    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3566    public static final String ACTION_FACTORY_RESET = "android.intent.action.FACTORY_RESET";
3567
3568    /**
3569     * Boolean intent extra to be used with {@link #ACTION_MASTER_CLEAR} in order to force a factory
3570     * reset even if {@link android.os.UserManager#DISALLOW_FACTORY_RESET} is set.
3571     *
3572     * <p>Not for use by third-party applications.
3573     *
3574     * @hide
3575     */
3576    @SystemApi
3577    public static final String EXTRA_FORCE_FACTORY_RESET =
3578            "android.intent.extra.FORCE_FACTORY_RESET";
3579
3580    /**
3581     * Broadcast action: report that a settings element is being restored from backup. The intent
3582     * contains four extras: EXTRA_SETTING_NAME is a string naming the restored setting,
3583     * EXTRA_SETTING_NEW_VALUE is the value being restored, EXTRA_SETTING_PREVIOUS_VALUE
3584     * is the value of that settings entry prior to the restore operation, and
3585     * EXTRA_SETTING_RESTORED_FROM_SDK_INT is the version of the SDK that the setting has been
3586     * restored from (corresponds to {@link android.os.Build.VERSION#SDK_INT}). The first three
3587     * values are represented as strings, the fourth one as int.
3588     *
3589     * <p>This broadcast is sent only for settings provider entries known to require special handling
3590     * around restore time.  These entries are found in the BROADCAST_ON_RESTORE table within
3591     * the provider's backup agent implementation.
3592     *
3593     * @see #EXTRA_SETTING_NAME
3594     * @see #EXTRA_SETTING_PREVIOUS_VALUE
3595     * @see #EXTRA_SETTING_NEW_VALUE
3596     * @see #EXTRA_SETTING_RESTORED_FROM_SDK_INT
3597     * {@hide}
3598     */
3599    public static final String ACTION_SETTING_RESTORED = "android.os.action.SETTING_RESTORED";
3600
3601    /** {@hide} */
3602    public static final String EXTRA_SETTING_NAME = "setting_name";
3603    /** {@hide} */
3604    public static final String EXTRA_SETTING_PREVIOUS_VALUE = "previous_value";
3605    /** {@hide} */
3606    public static final String EXTRA_SETTING_NEW_VALUE = "new_value";
3607    /** {@hide} */
3608    public static final String EXTRA_SETTING_RESTORED_FROM_SDK_INT = "restored_from_sdk_int";
3609
3610    /**
3611     * Activity Action: Process a piece of text.
3612     * <p>Input: {@link #EXTRA_PROCESS_TEXT} contains the text to be processed.
3613     * {@link #EXTRA_PROCESS_TEXT_READONLY} states if the resulting text will be read-only.</p>
3614     * <p>Output: {@link #EXTRA_PROCESS_TEXT} contains the processed text.</p>
3615     */
3616    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
3617    public static final String ACTION_PROCESS_TEXT = "android.intent.action.PROCESS_TEXT";
3618
3619    /**
3620     * Broadcast Action: The sim card state has changed.
3621     * For more details see TelephonyIntents.ACTION_SIM_STATE_CHANGED. This is here
3622     * because TelephonyIntents is an internal class.
3623     * @hide
3624     * @deprecated Use {@link #ACTION_SIM_CARD_STATE_CHANGED} or
3625     * {@link #ACTION_SIM_APPLICATION_STATE_CHANGED}
3626     */
3627    @Deprecated
3628    @SystemApi
3629    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
3630    public static final String ACTION_SIM_STATE_CHANGED = "android.intent.action.SIM_STATE_CHANGED";
3631
3632    /**
3633     * Broadcast Action: indicate that the phone service state has changed.
3634     * The intent will have the following extra values:</p>
3635     * <p>
3636     * @see #EXTRA_VOICE_REG_STATE
3637     * @see #EXTRA_DATA_REG_STATE
3638     * @see #EXTRA_VOICE_ROAMING_TYPE
3639     * @see #EXTRA_DATA_ROAMING_TYPE
3640     * @see #EXTRA_OPERATOR_ALPHA_LONG
3641     * @see #EXTRA_OPERATOR_ALPHA_SHORT
3642     * @see #EXTRA_OPERATOR_NUMERIC
3643     * @see #EXTRA_DATA_OPERATOR_ALPHA_LONG
3644     * @see #EXTRA_DATA_OPERATOR_ALPHA_SHORT
3645     * @see #EXTRA_DATA_OPERATOR_NUMERIC
3646     * @see #EXTRA_MANUAL
3647     * @see #EXTRA_VOICE_RADIO_TECH
3648     * @see #EXTRA_DATA_RADIO_TECH
3649     * @see #EXTRA_CSS_INDICATOR
3650     * @see #EXTRA_NETWORK_ID
3651     * @see #EXTRA_SYSTEM_ID
3652     * @see #EXTRA_CDMA_ROAMING_INDICATOR
3653     * @see #EXTRA_CDMA_DEFAULT_ROAMING_INDICATOR
3654     * @see #EXTRA_EMERGENCY_ONLY
3655     * @see #EXTRA_IS_DATA_ROAMING_FROM_REGISTRATION
3656     * @see #EXTRA_IS_USING_CARRIER_AGGREGATION
3657     * @see #EXTRA_LTE_EARFCN_RSRP_BOOST
3658     *
3659     * <p class="note">
3660     * Requires the READ_PHONE_STATE permission.
3661     *
3662     * <p class="note">This is a protected intent that can only be sent by the system.
3663     * @hide
3664     * @removed
3665     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable} and the helper
3666     * functions {@code ServiceStateTable.getUriForSubscriptionIdAndField} and
3667     * {@code ServiceStateTable.getUriForSubscriptionId} to subscribe to changes to the ServiceState
3668     * for a given subscription id and field with a ContentObserver or using JobScheduler.
3669     */
3670    @Deprecated
3671    @SystemApi
3672    @SdkConstant(SdkConstant.SdkConstantType.BROADCAST_INTENT_ACTION)
3673    public static final String ACTION_SERVICE_STATE = "android.intent.action.SERVICE_STATE";
3674
3675    /**
3676     * An int extra used with {@link #ACTION_SERVICE_STATE} which indicates voice registration
3677     * state.
3678     * @see android.telephony.ServiceState#STATE_EMERGENCY_ONLY
3679     * @see android.telephony.ServiceState#STATE_IN_SERVICE
3680     * @see android.telephony.ServiceState#STATE_OUT_OF_SERVICE
3681     * @see android.telephony.ServiceState#STATE_POWER_OFF
3682     * @hide
3683     * @removed
3684     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#VOICE_REG_STATE}.
3685     */
3686    @Deprecated
3687    @SystemApi
3688    public static final String EXTRA_VOICE_REG_STATE = "voiceRegState";
3689
3690    /**
3691     * An int extra used with {@link #ACTION_SERVICE_STATE} which indicates data registration state.
3692     * @see android.telephony.ServiceState#STATE_EMERGENCY_ONLY
3693     * @see android.telephony.ServiceState#STATE_IN_SERVICE
3694     * @see android.telephony.ServiceState#STATE_OUT_OF_SERVICE
3695     * @see android.telephony.ServiceState#STATE_POWER_OFF
3696     * @hide
3697     * @removed
3698     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#DATA_REG_STATE}.
3699     */
3700    @Deprecated
3701    @SystemApi
3702    public static final String EXTRA_DATA_REG_STATE = "dataRegState";
3703
3704    /**
3705     * An integer extra used with {@link #ACTION_SERVICE_STATE} which indicates the voice roaming
3706     * type.
3707     * @hide
3708     * @removed
3709     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#VOICE_ROAMING_TYPE}.
3710     */
3711    @Deprecated
3712    @SystemApi
3713    public static final String EXTRA_VOICE_ROAMING_TYPE = "voiceRoamingType";
3714
3715    /**
3716     * An integer extra used with {@link #ACTION_SERVICE_STATE} which indicates the data roaming
3717     * type.
3718     * @hide
3719     * @removed
3720     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#DATA_ROAMING_TYPE}.
3721     */
3722    @Deprecated
3723    @SystemApi
3724    public static final String EXTRA_DATA_ROAMING_TYPE = "dataRoamingType";
3725
3726    /**
3727     * A string extra used with {@link #ACTION_SERVICE_STATE} which represents the current
3728     * registered voice operator name in long alphanumeric format.
3729     * {@code null} if the operator name is not known or unregistered.
3730     * @hide
3731     * @removed
3732     * @deprecated Use
3733     * {@link android.provider.Telephony.ServiceStateTable#VOICE_OPERATOR_ALPHA_LONG}.
3734     */
3735    @Deprecated
3736    @SystemApi
3737    public static final String EXTRA_OPERATOR_ALPHA_LONG = "operator-alpha-long";
3738
3739    /**
3740     * A string extra used with {@link #ACTION_SERVICE_STATE} which represents the current
3741     * registered voice operator name in short alphanumeric format.
3742     * {@code null} if the operator name is not known or unregistered.
3743     * @hide
3744     * @removed
3745     * @deprecated Use
3746     * {@link android.provider.Telephony.ServiceStateTable#VOICE_OPERATOR_ALPHA_SHORT}.
3747     */
3748    @Deprecated
3749    @SystemApi
3750    public static final String EXTRA_OPERATOR_ALPHA_SHORT = "operator-alpha-short";
3751
3752    /**
3753     * A string extra used with {@link #ACTION_SERVICE_STATE} containing the MCC
3754     * (Mobile Country Code, 3 digits) and MNC (Mobile Network code, 2-3 digits) for the mobile
3755     * network.
3756     * @hide
3757     * @removed
3758     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#VOICE_OPERATOR_NUMERIC}.
3759     */
3760    @Deprecated
3761    @SystemApi
3762    public static final String EXTRA_OPERATOR_NUMERIC = "operator-numeric";
3763
3764    /**
3765     * A string extra used with {@link #ACTION_SERVICE_STATE} which represents the current
3766     * registered data operator name in long alphanumeric format.
3767     * {@code null} if the operator name is not known or unregistered.
3768     * @hide
3769     * @removed
3770     * @deprecated Use
3771     * {@link android.provider.Telephony.ServiceStateTable#DATA_OPERATOR_ALPHA_LONG}.
3772     */
3773    @Deprecated
3774    @SystemApi
3775    public static final String EXTRA_DATA_OPERATOR_ALPHA_LONG = "data-operator-alpha-long";
3776
3777    /**
3778     * A string extra used with {@link #ACTION_SERVICE_STATE} which represents the current
3779     * registered data operator name in short alphanumeric format.
3780     * {@code null} if the operator name is not known or unregistered.
3781     * @hide
3782     * @removed
3783     * @deprecated Use
3784     * {@link android.provider.Telephony.ServiceStateTable#DATA_OPERATOR_ALPHA_SHORT}.
3785     */
3786    @Deprecated
3787    @SystemApi
3788    public static final String EXTRA_DATA_OPERATOR_ALPHA_SHORT = "data-operator-alpha-short";
3789
3790    /**
3791     * A string extra used with {@link #ACTION_SERVICE_STATE} containing the MCC
3792     * (Mobile Country Code, 3 digits) and MNC (Mobile Network code, 2-3 digits) for the
3793     * data operator.
3794     * @hide
3795     * @removed
3796     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#DATA_OPERATOR_NUMERIC}.
3797     */
3798    @Deprecated
3799    @SystemApi
3800    public static final String EXTRA_DATA_OPERATOR_NUMERIC = "data-operator-numeric";
3801
3802    /**
3803     * A boolean extra used with {@link #ACTION_SERVICE_STATE} which indicates whether the current
3804     * network selection mode is manual.
3805     * Will be {@code true} if manual mode, {@code false} if automatic mode.
3806     * @hide
3807     * @removed
3808     * @deprecated Use
3809     * {@link android.provider.Telephony.ServiceStateTable#IS_MANUAL_NETWORK_SELECTION}.
3810     */
3811    @Deprecated
3812    @SystemApi
3813    public static final String EXTRA_MANUAL = "manual";
3814
3815    /**
3816     * An integer extra used with {@link #ACTION_SERVICE_STATE} which represents the current voice
3817     * radio technology.
3818     * @hide
3819     * @removed
3820     * @deprecated Use
3821     * {@link android.provider.Telephony.ServiceStateTable#RIL_VOICE_RADIO_TECHNOLOGY}.
3822     */
3823    @Deprecated
3824    @SystemApi
3825    public static final String EXTRA_VOICE_RADIO_TECH = "radioTechnology";
3826
3827    /**
3828     * An integer extra used with {@link #ACTION_SERVICE_STATE} which represents the current data
3829     * radio technology.
3830     * @hide
3831     * @removed
3832     * @deprecated Use
3833     * {@link android.provider.Telephony.ServiceStateTable#RIL_DATA_RADIO_TECHNOLOGY}.
3834     */
3835    @Deprecated
3836    @SystemApi
3837    public static final String EXTRA_DATA_RADIO_TECH = "dataRadioTechnology";
3838
3839    /**
3840     * A boolean extra used with {@link #ACTION_SERVICE_STATE} which represents concurrent service
3841     * support on CDMA network.
3842     * Will be {@code true} if support, {@code false} otherwise.
3843     * @hide
3844     * @removed
3845     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#CSS_INDICATOR}.
3846     */
3847    @Deprecated
3848    @SystemApi
3849    public static final String EXTRA_CSS_INDICATOR = "cssIndicator";
3850
3851    /**
3852     * An integer extra used with {@link #ACTION_SERVICE_STATE} which represents the CDMA network
3853     * id. {@code Integer.MAX_VALUE} if unknown.
3854     * @hide
3855     * @removed
3856     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#NETWORK_ID}.
3857     */
3858    @Deprecated
3859    @SystemApi
3860    public static final String EXTRA_NETWORK_ID = "networkId";
3861
3862    /**
3863     * An integer extra used with {@link #ACTION_SERVICE_STATE} which represents the CDMA system id.
3864     * {@code Integer.MAX_VALUE} if unknown.
3865     * @hide
3866     * @removed
3867     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#SYSTEM_ID}.
3868     */
3869    @Deprecated
3870    @SystemApi
3871    public static final String EXTRA_SYSTEM_ID = "systemId";
3872
3873    /**
3874     * An integer extra used with {@link #ACTION_SERVICE_STATE} represents the TSB-58 roaming
3875     * indicator if registered on a CDMA or EVDO system or {@code -1} if not.
3876     * @hide
3877     * @removed
3878     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#CDMA_ROAMING_INDICATOR}.
3879     */
3880    @Deprecated
3881    @SystemApi
3882    public static final String EXTRA_CDMA_ROAMING_INDICATOR = "cdmaRoamingIndicator";
3883
3884    /**
3885     * An integer extra used with {@link #ACTION_SERVICE_STATE} represents the default roaming
3886     * indicator from the PRL if registered on a CDMA or EVDO system {@code -1} if not.
3887     * @hide
3888     * @removed
3889     * @deprecated Use
3890     * {@link android.provider.Telephony.ServiceStateTable#CDMA_DEFAULT_ROAMING_INDICATOR}.
3891     */
3892    @Deprecated
3893    @SystemApi
3894    public static final String EXTRA_CDMA_DEFAULT_ROAMING_INDICATOR = "cdmaDefaultRoamingIndicator";
3895
3896    /**
3897     * A boolean extra used with {@link #ACTION_SERVICE_STATE} which indicates if under emergency
3898     * only mode.
3899     * {@code true} if in emergency only mode, {@code false} otherwise.
3900     * @hide
3901     * @removed
3902     * @deprecated Use {@link android.provider.Telephony.ServiceStateTable#IS_EMERGENCY_ONLY}.
3903     */
3904    @Deprecated
3905    @SystemApi
3906    public static final String EXTRA_EMERGENCY_ONLY = "emergencyOnly";
3907
3908    /**
3909     * A boolean extra used with {@link #ACTION_SERVICE_STATE} which indicates whether data network
3910     * registration state is roaming.
3911     * {@code true} if registration indicates roaming, {@code false} otherwise
3912     * @hide
3913     * @removed
3914     * @deprecated Use
3915     * {@link android.provider.Telephony.ServiceStateTable#IS_DATA_ROAMING_FROM_REGISTRATION}.
3916     */
3917    @Deprecated
3918    @SystemApi
3919    public static final String EXTRA_IS_DATA_ROAMING_FROM_REGISTRATION =
3920            "isDataRoamingFromRegistration";
3921
3922    /**
3923     * A boolean extra used with {@link #ACTION_SERVICE_STATE} which indicates if carrier
3924     * aggregation is in use.
3925     * {@code true} if carrier aggregation is in use, {@code false} otherwise.
3926     * @hide
3927     * @removed
3928     * @deprecated Use
3929     * {@link android.provider.Telephony.ServiceStateTable#IS_USING_CARRIER_AGGREGATION}.
3930     */
3931    @Deprecated
3932    @SystemApi
3933    public static final String EXTRA_IS_USING_CARRIER_AGGREGATION = "isUsingCarrierAggregation";
3934
3935    /**
3936     * An integer extra used with {@link #ACTION_SERVICE_STATE} representing the offset which
3937     * is reduced from the rsrp threshold while calculating signal strength level.
3938     * @hide
3939     * @removed
3940     */
3941    @Deprecated
3942    @SystemApi
3943    public static final String EXTRA_LTE_EARFCN_RSRP_BOOST = "LteEarfcnRsrpBoost";
3944
3945    /**
3946     * The name of the extra used to define the text to be processed, as a
3947     * CharSequence. Note that this may be a styled CharSequence, so you must use
3948     * {@link Bundle#getCharSequence(String) Bundle.getCharSequence()} to retrieve it.
3949     */
3950    public static final String EXTRA_PROCESS_TEXT = "android.intent.extra.PROCESS_TEXT";
3951    /**
3952     * The name of the boolean extra used to define if the processed text will be used as read-only.
3953     */
3954    public static final String EXTRA_PROCESS_TEXT_READONLY =
3955            "android.intent.extra.PROCESS_TEXT_READONLY";
3956
3957    /**
3958     * Broadcast action: reports when a new thermal event has been reached. When the device
3959     * is reaching its maximum temperatue, the thermal level reported
3960     * {@hide}
3961     */
3962    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
3963    public static final String ACTION_THERMAL_EVENT = "android.intent.action.THERMAL_EVENT";
3964
3965    /** {@hide} */
3966    public static final String EXTRA_THERMAL_STATE = "android.intent.extra.THERMAL_STATE";
3967
3968    /**
3969     * Thermal state when the device is normal. This state is sent in the
3970     * {@link #ACTION_THERMAL_EVENT} broadcast as {@link #EXTRA_THERMAL_STATE}.
3971     * {@hide}
3972     */
3973    public static final int EXTRA_THERMAL_STATE_NORMAL = 0;
3974
3975    /**
3976     * Thermal state where the device is approaching its maximum threshold. This state is sent in
3977     * the {@link #ACTION_THERMAL_EVENT} broadcast as {@link #EXTRA_THERMAL_STATE}.
3978     * {@hide}
3979     */
3980    public static final int EXTRA_THERMAL_STATE_WARNING = 1;
3981
3982    /**
3983     * Thermal state where the device has reached its maximum threshold. This state is sent in the
3984     * {@link #ACTION_THERMAL_EVENT} broadcast as {@link #EXTRA_THERMAL_STATE}.
3985     * {@hide}
3986     */
3987    public static final int EXTRA_THERMAL_STATE_EXCEEDED = 2;
3988
3989    /**
3990     * Broadcast Action: Indicates the dock in idle state while device is docked.
3991     *
3992     * <p class="note">This is a protected intent that can only be sent
3993     * by the system.
3994     *
3995     * @hide
3996     */
3997    public static final String ACTION_DOCK_IDLE = "android.intent.action.DOCK_IDLE";
3998
3999    /**
4000     * Broadcast Action: Indicates the dock in active state while device is docked.
4001     *
4002     * <p class="note">This is a protected intent that can only be sent
4003     * by the system.
4004     *
4005     * @hide
4006     */
4007    public static final String ACTION_DOCK_ACTIVE = "android.intent.action.DOCK_ACTIVE";
4008
4009
4010    // ---------------------------------------------------------------------
4011    // ---------------------------------------------------------------------
4012    // Standard intent categories (see addCategory()).
4013
4014    /**
4015     * Set if the activity should be an option for the default action
4016     * (center press) to perform on a piece of data.  Setting this will
4017     * hide from the user any activities without it set when performing an
4018     * action on some data.  Note that this is normally -not- set in the
4019     * Intent when initiating an action -- it is for use in intent filters
4020     * specified in packages.
4021     */
4022    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4023    public static final String CATEGORY_DEFAULT = "android.intent.category.DEFAULT";
4024    /**
4025     * Activities that can be safely invoked from a browser must support this
4026     * category.  For example, if the user is viewing a web page or an e-mail
4027     * and clicks on a link in the text, the Intent generated execute that
4028     * link will require the BROWSABLE category, so that only activities
4029     * supporting this category will be considered as possible actions.  By
4030     * supporting this category, you are promising that there is nothing
4031     * damaging (without user intervention) that can happen by invoking any
4032     * matching Intent.
4033     */
4034    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4035    public static final String CATEGORY_BROWSABLE = "android.intent.category.BROWSABLE";
4036    /**
4037     * Categories for activities that can participate in voice interaction.
4038     * An activity that supports this category must be prepared to run with
4039     * no UI shown at all (though in some case it may have a UI shown), and
4040     * rely on {@link android.app.VoiceInteractor} to interact with the user.
4041     */
4042    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4043    public static final String CATEGORY_VOICE = "android.intent.category.VOICE";
4044    /**
4045     * Set if the activity should be considered as an alternative action to
4046     * the data the user is currently viewing.  See also
4047     * {@link #CATEGORY_SELECTED_ALTERNATIVE} for an alternative action that
4048     * applies to the selection in a list of items.
4049     *
4050     * <p>Supporting this category means that you would like your activity to be
4051     * displayed in the set of alternative things the user can do, usually as
4052     * part of the current activity's options menu.  You will usually want to
4053     * include a specific label in the &lt;intent-filter&gt; of this action
4054     * describing to the user what it does.
4055     *
4056     * <p>The action of IntentFilter with this category is important in that it
4057     * describes the specific action the target will perform.  This generally
4058     * should not be a generic action (such as {@link #ACTION_VIEW}, but rather
4059     * a specific name such as "com.android.camera.action.CROP.  Only one
4060     * alternative of any particular action will be shown to the user, so using
4061     * a specific action like this makes sure that your alternative will be
4062     * displayed while also allowing other applications to provide their own
4063     * overrides of that particular action.
4064     */
4065    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4066    public static final String CATEGORY_ALTERNATIVE = "android.intent.category.ALTERNATIVE";
4067    /**
4068     * Set if the activity should be considered as an alternative selection
4069     * action to the data the user has currently selected.  This is like
4070     * {@link #CATEGORY_ALTERNATIVE}, but is used in activities showing a list
4071     * of items from which the user can select, giving them alternatives to the
4072     * default action that will be performed on it.
4073     */
4074    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4075    public static final String CATEGORY_SELECTED_ALTERNATIVE = "android.intent.category.SELECTED_ALTERNATIVE";
4076    /**
4077     * Intended to be used as a tab inside of a containing TabActivity.
4078     */
4079    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4080    public static final String CATEGORY_TAB = "android.intent.category.TAB";
4081    /**
4082     * Should be displayed in the top-level launcher.
4083     */
4084    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4085    public static final String CATEGORY_LAUNCHER = "android.intent.category.LAUNCHER";
4086    /**
4087     * Indicates an activity optimized for Leanback mode, and that should
4088     * be displayed in the Leanback launcher.
4089     */
4090    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4091    public static final String CATEGORY_LEANBACK_LAUNCHER = "android.intent.category.LEANBACK_LAUNCHER";
4092    /**
4093     * Indicates the preferred entry-point activity when an application is launched from a Car
4094     * launcher. If not present, Car launcher can optionally use {@link #CATEGORY_LAUNCHER} as a
4095     * fallback, or exclude the application entirely.
4096     * @hide
4097     */
4098    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4099    public static final String CATEGORY_CAR_LAUNCHER = "android.intent.category.CAR_LAUNCHER";
4100    /**
4101     * Indicates a Leanback settings activity to be displayed in the Leanback launcher.
4102     * @hide
4103     */
4104    @SystemApi
4105    public static final String CATEGORY_LEANBACK_SETTINGS = "android.intent.category.LEANBACK_SETTINGS";
4106    /**
4107     * Provides information about the package it is in; typically used if
4108     * a package does not contain a {@link #CATEGORY_LAUNCHER} to provide
4109     * a front-door to the user without having to be shown in the all apps list.
4110     */
4111    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4112    public static final String CATEGORY_INFO = "android.intent.category.INFO";
4113    /**
4114     * This is the home activity, that is the first activity that is displayed
4115     * when the device boots.
4116     */
4117    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4118    public static final String CATEGORY_HOME = "android.intent.category.HOME";
4119    /**
4120     * This is the home activity that is displayed when the device is finished setting up and ready
4121     * for use.
4122     * @hide
4123     */
4124    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4125    public static final String CATEGORY_HOME_MAIN = "android.intent.category.HOME_MAIN";
4126    /**
4127     * This is the setup wizard activity, that is the first activity that is displayed
4128     * when the user sets up the device for the first time.
4129     * @hide
4130     */
4131    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4132    public static final String CATEGORY_SETUP_WIZARD = "android.intent.category.SETUP_WIZARD";
4133    /**
4134     * This is the home activity, that is the activity that serves as the launcher app
4135     * from there the user can start other apps. Often components with lower/higher
4136     * priority intent filters handle the home intent, for example SetupWizard, to
4137     * setup the device and we need to be able to distinguish the home app from these
4138     * setup helpers.
4139     * @hide
4140     */
4141    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4142    public static final String CATEGORY_LAUNCHER_APP = "android.intent.category.LAUNCHER_APP";
4143    /**
4144     * This activity is a preference panel.
4145     */
4146    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4147    public static final String CATEGORY_PREFERENCE = "android.intent.category.PREFERENCE";
4148    /**
4149     * This activity is a development preference panel.
4150     */
4151    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4152    public static final String CATEGORY_DEVELOPMENT_PREFERENCE = "android.intent.category.DEVELOPMENT_PREFERENCE";
4153    /**
4154     * Capable of running inside a parent activity container.
4155     */
4156    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4157    public static final String CATEGORY_EMBED = "android.intent.category.EMBED";
4158    /**
4159     * This activity allows the user to browse and download new applications.
4160     */
4161    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4162    public static final String CATEGORY_APP_MARKET = "android.intent.category.APP_MARKET";
4163    /**
4164     * This activity may be exercised by the monkey or other automated test tools.
4165     */
4166    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4167    public static final String CATEGORY_MONKEY = "android.intent.category.MONKEY";
4168    /**
4169     * To be used as a test (not part of the normal user experience).
4170     */
4171    public static final String CATEGORY_TEST = "android.intent.category.TEST";
4172    /**
4173     * To be used as a unit test (run through the Test Harness).
4174     */
4175    public static final String CATEGORY_UNIT_TEST = "android.intent.category.UNIT_TEST";
4176    /**
4177     * To be used as a sample code example (not part of the normal user
4178     * experience).
4179     */
4180    public static final String CATEGORY_SAMPLE_CODE = "android.intent.category.SAMPLE_CODE";
4181
4182    /**
4183     * Used to indicate that an intent only wants URIs that can be opened with
4184     * {@link ContentResolver#openFileDescriptor(Uri, String)}. Openable URIs
4185     * must support at least the columns defined in {@link OpenableColumns} when
4186     * queried.
4187     *
4188     * @see #ACTION_GET_CONTENT
4189     * @see #ACTION_OPEN_DOCUMENT
4190     * @see #ACTION_CREATE_DOCUMENT
4191     */
4192    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4193    public static final String CATEGORY_OPENABLE = "android.intent.category.OPENABLE";
4194
4195    /**
4196     * Used to indicate that an intent filter can accept files which are not necessarily
4197     * openable by {@link ContentResolver#openFileDescriptor(Uri, String)}, but
4198     * at least streamable via
4199     * {@link ContentResolver#openTypedAssetFileDescriptor(Uri, String, Bundle)}
4200     * using one of the stream types exposed via
4201     * {@link ContentResolver#getStreamTypes(Uri, String)}.
4202     *
4203     * @see #ACTION_SEND
4204     * @see #ACTION_SEND_MULTIPLE
4205     */
4206    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4207    public static final String CATEGORY_TYPED_OPENABLE  =
4208            "android.intent.category.TYPED_OPENABLE";
4209
4210    /**
4211     * To be used as code under test for framework instrumentation tests.
4212     */
4213    public static final String CATEGORY_FRAMEWORK_INSTRUMENTATION_TEST =
4214            "android.intent.category.FRAMEWORK_INSTRUMENTATION_TEST";
4215    /**
4216     * An activity to run when device is inserted into a car dock.
4217     * Used with {@link #ACTION_MAIN} to launch an activity.  For more
4218     * information, see {@link android.app.UiModeManager}.
4219     */
4220    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4221    public static final String CATEGORY_CAR_DOCK = "android.intent.category.CAR_DOCK";
4222    /**
4223     * An activity to run when device is inserted into a car dock.
4224     * Used with {@link #ACTION_MAIN} to launch an activity.  For more
4225     * information, see {@link android.app.UiModeManager}.
4226     */
4227    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4228    public static final String CATEGORY_DESK_DOCK = "android.intent.category.DESK_DOCK";
4229    /**
4230     * An activity to run when device is inserted into a analog (low end) dock.
4231     * Used with {@link #ACTION_MAIN} to launch an activity.  For more
4232     * information, see {@link android.app.UiModeManager}.
4233     */
4234    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4235    public static final String CATEGORY_LE_DESK_DOCK = "android.intent.category.LE_DESK_DOCK";
4236
4237    /**
4238     * An activity to run when device is inserted into a digital (high end) dock.
4239     * Used with {@link #ACTION_MAIN} to launch an activity.  For more
4240     * information, see {@link android.app.UiModeManager}.
4241     */
4242    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4243    public static final String CATEGORY_HE_DESK_DOCK = "android.intent.category.HE_DESK_DOCK";
4244
4245    /**
4246     * Used to indicate that the activity can be used in a car environment.
4247     */
4248    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4249    public static final String CATEGORY_CAR_MODE = "android.intent.category.CAR_MODE";
4250
4251    /**
4252     * An activity to use for the launcher when the device is placed in a VR Headset viewer.
4253     * Used with {@link #ACTION_MAIN} to launch an activity.  For more
4254     * information, see {@link android.app.UiModeManager}.
4255     */
4256    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4257    public static final String CATEGORY_VR_HOME = "android.intent.category.VR_HOME";
4258    // ---------------------------------------------------------------------
4259    // ---------------------------------------------------------------------
4260    // Application launch intent categories (see addCategory()).
4261
4262    /**
4263     * Used with {@link #ACTION_MAIN} to launch the browser application.
4264     * The activity should be able to browse the Internet.
4265     * <p>NOTE: This should not be used as the primary key of an Intent,
4266     * since it will not result in the app launching with the correct
4267     * action and category.  Instead, use this with
4268     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4269     * Intent with this category in the selector.</p>
4270     */
4271    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4272    public static final String CATEGORY_APP_BROWSER = "android.intent.category.APP_BROWSER";
4273
4274    /**
4275     * Used with {@link #ACTION_MAIN} to launch the calculator application.
4276     * The activity should be able to perform standard arithmetic operations.
4277     * <p>NOTE: This should not be used as the primary key of an Intent,
4278     * since it will not result in the app launching with the correct
4279     * action and category.  Instead, use this with
4280     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4281     * Intent with this category in the selector.</p>
4282     */
4283    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4284    public static final String CATEGORY_APP_CALCULATOR = "android.intent.category.APP_CALCULATOR";
4285
4286    /**
4287     * Used with {@link #ACTION_MAIN} to launch the calendar application.
4288     * The activity should be able to view and manipulate calendar entries.
4289     * <p>NOTE: This should not be used as the primary key of an Intent,
4290     * since it will not result in the app launching with the correct
4291     * action and category.  Instead, use this with
4292     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4293     * Intent with this category in the selector.</p>
4294     */
4295    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4296    public static final String CATEGORY_APP_CALENDAR = "android.intent.category.APP_CALENDAR";
4297
4298    /**
4299     * Used with {@link #ACTION_MAIN} to launch the contacts application.
4300     * The activity should be able to view and manipulate address book entries.
4301     * <p>NOTE: This should not be used as the primary key of an Intent,
4302     * since it will not result in the app launching with the correct
4303     * action and category.  Instead, use this with
4304     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4305     * Intent with this category in the selector.</p>
4306     */
4307    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4308    public static final String CATEGORY_APP_CONTACTS = "android.intent.category.APP_CONTACTS";
4309
4310    /**
4311     * Used with {@link #ACTION_MAIN} to launch the email application.
4312     * The activity should be able to send and receive email.
4313     * <p>NOTE: This should not be used as the primary key of an Intent,
4314     * since it will not result in the app launching with the correct
4315     * action and category.  Instead, use this with
4316     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4317     * Intent with this category in the selector.</p>
4318     */
4319    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4320    public static final String CATEGORY_APP_EMAIL = "android.intent.category.APP_EMAIL";
4321
4322    /**
4323     * Used with {@link #ACTION_MAIN} to launch the gallery application.
4324     * The activity should be able to view and manipulate image and video files
4325     * stored on the device.
4326     * <p>NOTE: This should not be used as the primary key of an Intent,
4327     * since it will not result in the app launching with the correct
4328     * action and category.  Instead, use this with
4329     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4330     * Intent with this category in the selector.</p>
4331     */
4332    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4333    public static final String CATEGORY_APP_GALLERY = "android.intent.category.APP_GALLERY";
4334
4335    /**
4336     * Used with {@link #ACTION_MAIN} to launch the maps application.
4337     * The activity should be able to show the user's current location and surroundings.
4338     * <p>NOTE: This should not be used as the primary key of an Intent,
4339     * since it will not result in the app launching with the correct
4340     * action and category.  Instead, use this with
4341     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4342     * Intent with this category in the selector.</p>
4343     */
4344    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4345    public static final String CATEGORY_APP_MAPS = "android.intent.category.APP_MAPS";
4346
4347    /**
4348     * Used with {@link #ACTION_MAIN} to launch the messaging application.
4349     * The activity should be able to send and receive text messages.
4350     * <p>NOTE: This should not be used as the primary key of an Intent,
4351     * since it will not result in the app launching with the correct
4352     * action and category.  Instead, use this with
4353     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4354     * Intent with this category in the selector.</p>
4355     */
4356    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4357    public static final String CATEGORY_APP_MESSAGING = "android.intent.category.APP_MESSAGING";
4358
4359    /**
4360     * Used with {@link #ACTION_MAIN} to launch the music application.
4361     * The activity should be able to play, browse, or manipulate music files
4362     * stored on the device.
4363     * <p>NOTE: This should not be used as the primary key of an Intent,
4364     * since it will not result in the app launching with the correct
4365     * action and category.  Instead, use this with
4366     * {@link #makeMainSelectorActivity(String, String)} to generate a main
4367     * Intent with this category in the selector.</p>
4368     */
4369    @SdkConstant(SdkConstantType.INTENT_CATEGORY)
4370    public static final String CATEGORY_APP_MUSIC = "android.intent.category.APP_MUSIC";
4371
4372    // ---------------------------------------------------------------------
4373    // ---------------------------------------------------------------------
4374    // Standard extra data keys.
4375
4376    /**
4377     * The initial data to place in a newly created record.  Use with
4378     * {@link #ACTION_INSERT}.  The data here is a Map containing the same
4379     * fields as would be given to the underlying ContentProvider.insert()
4380     * call.
4381     */
4382    public static final String EXTRA_TEMPLATE = "android.intent.extra.TEMPLATE";
4383
4384    /**
4385     * A constant CharSequence that is associated with the Intent, used with
4386     * {@link #ACTION_SEND} to supply the literal data to be sent.  Note that
4387     * this may be a styled CharSequence, so you must use
4388     * {@link Bundle#getCharSequence(String) Bundle.getCharSequence()} to
4389     * retrieve it.
4390     */
4391    public static final String EXTRA_TEXT = "android.intent.extra.TEXT";
4392
4393    /**
4394     * A constant String that is associated with the Intent, used with
4395     * {@link #ACTION_SEND} to supply an alternative to {@link #EXTRA_TEXT}
4396     * as HTML formatted text.  Note that you <em>must</em> also supply
4397     * {@link #EXTRA_TEXT}.
4398     */
4399    public static final String EXTRA_HTML_TEXT = "android.intent.extra.HTML_TEXT";
4400
4401    /**
4402     * A content: URI holding a stream of data associated with the Intent,
4403     * used with {@link #ACTION_SEND} to supply the data being sent.
4404     */
4405    public static final String EXTRA_STREAM = "android.intent.extra.STREAM";
4406
4407    /**
4408     * A String[] holding e-mail addresses that should be delivered to.
4409     */
4410    public static final String EXTRA_EMAIL       = "android.intent.extra.EMAIL";
4411
4412    /**
4413     * A String[] holding e-mail addresses that should be carbon copied.
4414     */
4415    public static final String EXTRA_CC       = "android.intent.extra.CC";
4416
4417    /**
4418     * A String[] holding e-mail addresses that should be blind carbon copied.
4419     */
4420    public static final String EXTRA_BCC      = "android.intent.extra.BCC";
4421
4422    /**
4423     * A constant string holding the desired subject line of a message.
4424     */
4425    public static final String EXTRA_SUBJECT  = "android.intent.extra.SUBJECT";
4426
4427    /**
4428     * An Intent describing the choices you would like shown with
4429     * {@link #ACTION_PICK_ACTIVITY} or {@link #ACTION_CHOOSER}.
4430     */
4431    public static final String EXTRA_INTENT = "android.intent.extra.INTENT";
4432
4433    /**
4434     * An int representing the user id to be used.
4435     *
4436     * @hide
4437     */
4438    public static final String EXTRA_USER_ID = "android.intent.extra.USER_ID";
4439
4440    /**
4441     * An int representing the task id to be retrieved. This is used when a launch from recents is
4442     * intercepted by another action such as credentials confirmation to remember which task should
4443     * be resumed when complete.
4444     *
4445     * @hide
4446     */
4447    public static final String EXTRA_TASK_ID = "android.intent.extra.TASK_ID";
4448
4449    /**
4450     * An Intent[] describing additional, alternate choices you would like shown with
4451     * {@link #ACTION_CHOOSER}.
4452     *
4453     * <p>An app may be capable of providing several different payload types to complete a
4454     * user's intended action. For example, an app invoking {@link #ACTION_SEND} to share photos
4455     * with another app may use EXTRA_ALTERNATE_INTENTS to have the chooser transparently offer
4456     * several different supported sending mechanisms for sharing, such as the actual "image/*"
4457     * photo data or a hosted link where the photos can be viewed.</p>
4458     *
4459     * <p>The intent present in {@link #EXTRA_INTENT} will be treated as the
4460     * first/primary/preferred intent in the set. Additional intents specified in
4461     * this extra are ordered; by default intents that appear earlier in the array will be
4462     * preferred over intents that appear later in the array as matches for the same
4463     * target component. To alter this preference, a calling app may also supply
4464     * {@link #EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER}.</p>
4465     */
4466    public static final String EXTRA_ALTERNATE_INTENTS = "android.intent.extra.ALTERNATE_INTENTS";
4467
4468    /**
4469     * A {@link ComponentName ComponentName[]} describing components that should be filtered out
4470     * and omitted from a list of components presented to the user.
4471     *
4472     * <p>When used with {@link #ACTION_CHOOSER}, the chooser will omit any of the components
4473     * in this array if it otherwise would have shown them. Useful for omitting specific targets
4474     * from your own package or other apps from your organization if the idea of sending to those
4475     * targets would be redundant with other app functionality. Filtered components will not
4476     * be able to present targets from an associated <code>ChooserTargetService</code>.</p>
4477     */
4478    public static final String EXTRA_EXCLUDE_COMPONENTS
4479            = "android.intent.extra.EXCLUDE_COMPONENTS";
4480
4481    /**
4482     * A {@link android.service.chooser.ChooserTarget ChooserTarget[]} for {@link #ACTION_CHOOSER}
4483     * describing additional high-priority deep-link targets for the chooser to present to the user.
4484     *
4485     * <p>Targets provided in this way will be presented inline with all other targets provided
4486     * by services from other apps. They will be prioritized before other service targets, but
4487     * after those targets provided by sources that the user has manually pinned to the front.</p>
4488     *
4489     * @see #ACTION_CHOOSER
4490     */
4491    public static final String EXTRA_CHOOSER_TARGETS = "android.intent.extra.CHOOSER_TARGETS";
4492
4493    /**
4494     * An {@link IntentSender} for an Activity that will be invoked when the user makes a selection
4495     * from the chooser activity presented by {@link #ACTION_CHOOSER}.
4496     *
4497     * <p>An app preparing an action for another app to complete may wish to allow the user to
4498     * disambiguate between several options for completing the action based on the chosen target
4499     * or otherwise refine the action before it is invoked.
4500     * </p>
4501     *
4502     * <p>When sent, this IntentSender may be filled in with the following extras:</p>
4503     * <ul>
4504     *     <li>{@link #EXTRA_INTENT} The first intent that matched the user's chosen target</li>
4505     *     <li>{@link #EXTRA_ALTERNATE_INTENTS} Any additional intents that also matched the user's
4506     *     chosen target beyond the first</li>
4507     *     <li>{@link #EXTRA_RESULT_RECEIVER} A {@link ResultReceiver} that the refinement activity
4508     *     should fill in and send once the disambiguation is complete</li>
4509     * </ul>
4510     */
4511    public static final String EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER
4512            = "android.intent.extra.CHOOSER_REFINEMENT_INTENT_SENDER";
4513
4514    /**
4515     * An {@code ArrayList} of {@code String} annotations describing content for
4516     * {@link #ACTION_CHOOSER}.
4517     *
4518     * <p>If {@link #EXTRA_CONTENT_ANNOTATIONS} is present in an intent used to start a
4519     * {@link #ACTION_CHOOSER} activity, the first three annotations will be used to rank apps.</p>
4520     *
4521     * <p>Annotations should describe the major components or topics of the content. It is up to
4522     * apps initiating {@link #ACTION_CHOOSER} to learn and add annotations. Annotations should be
4523     * learned in advance, e.g., when creating or saving content, to avoid increasing latency to
4524     * start {@link #ACTION_CHOOSER}. Names of customized annotations should not contain the colon
4525     * character. Performance on customized annotations can suffer, if they are rarely used for
4526     * {@link #ACTION_CHOOSER} in the past 14 days. Therefore, it is recommended to use the
4527     * following annotations when applicable.</p>
4528     * <ul>
4529     *     <li>"product" represents that the topic of the content is mainly about products, e.g.,
4530     *     health & beauty, and office supplies.</li>
4531     *     <li>"emotion" represents that the topic of the content is mainly about emotions, e.g.,
4532     *     happy, and sad.</li>
4533     *     <li>"person" represents that the topic of the content is mainly about persons, e.g.,
4534     *     face, finger, standing, and walking.</li>
4535     *     <li>"child" represents that the topic of the content is mainly about children, e.g.,
4536     *     child, and baby.</li>
4537     *     <li>"selfie" represents that the topic of the content is mainly about selfies.</li>
4538     *     <li>"crowd" represents that the topic of the content is mainly about crowds.</li>
4539     *     <li>"party" represents that the topic of the content is mainly about parties.</li>
4540     *     <li>"animal" represent that the topic of the content is mainly about animals.</li>
4541     *     <li>"plant" represents that the topic of the content is mainly about plants, e.g.,
4542     *     flowers.</li>
4543     *     <li>"vacation" represents that the topic of the content is mainly about vacations.</li>
4544     *     <li>"fashion" represents that the topic of the content is mainly about fashion, e.g.
4545     *     sunglasses, jewelry, handbags and clothing.</li>
4546     *     <li>"material" represents that the topic of the content is mainly about materials, e.g.,
4547     *     paper, and silk.</li>
4548     *     <li>"vehicle" represents that the topic of the content is mainly about vehicles, like
4549     *     cars, and boats.</li>
4550     *     <li>"document" represents that the topic of the content is mainly about documents, e.g.
4551     *     posters.</li>
4552     *     <li>"design" represents that the topic of the content is mainly about design, e.g. arts
4553     *     and designs of houses.</li>
4554     *     <li>"holiday" represents that the topic of the content is mainly about holidays, e.g.,
4555     *     Christmas and Thanksgiving.</li>
4556     * </ul>
4557     */
4558    public static final String EXTRA_CONTENT_ANNOTATIONS
4559            = "android.intent.extra.CONTENT_ANNOTATIONS";
4560
4561    /**
4562     * A {@link ResultReceiver} used to return data back to the sender.
4563     *
4564     * <p>Used to complete an app-specific
4565     * {@link #EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER refinement} for {@link #ACTION_CHOOSER}.</p>
4566     *
4567     * <p>If {@link #EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER} is present in the intent
4568     * used to start a {@link #ACTION_CHOOSER} activity this extra will be
4569     * {@link #fillIn(Intent, int) filled in} to that {@link IntentSender} and sent
4570     * when the user selects a target component from the chooser. It is up to the recipient
4571     * to send a result to this ResultReceiver to signal that disambiguation is complete
4572     * and that the chooser should invoke the user's choice.</p>
4573     *
4574     * <p>The disambiguator should provide a Bundle to the ResultReceiver with an intent
4575     * assigned to the key {@link #EXTRA_INTENT}. This supplied intent will be used by the chooser
4576     * to match and fill in the final Intent or ChooserTarget before starting it.
4577     * The supplied intent must {@link #filterEquals(Intent) match} one of the intents from
4578     * {@link #EXTRA_INTENT} or {@link #EXTRA_ALTERNATE_INTENTS} passed to
4579     * {@link #EXTRA_CHOOSER_REFINEMENT_INTENT_SENDER} to be accepted.</p>
4580     *
4581     * <p>The result code passed to the ResultReceiver should be
4582     * {@link android.app.Activity#RESULT_OK} if the refinement succeeded and the supplied intent's
4583     * target in the chooser should be started, or {@link android.app.Activity#RESULT_CANCELED} if
4584     * the chooser should finish without starting a target.</p>
4585     */
4586    public static final String EXTRA_RESULT_RECEIVER
4587            = "android.intent.extra.RESULT_RECEIVER";
4588
4589    /**
4590     * A CharSequence dialog title to provide to the user when used with a
4591     * {@link #ACTION_CHOOSER}.
4592     */
4593    public static final String EXTRA_TITLE = "android.intent.extra.TITLE";
4594
4595    /**
4596     * A Parcelable[] of {@link Intent} or
4597     * {@link android.content.pm.LabeledIntent} objects as set with
4598     * {@link #putExtra(String, Parcelable[])} of additional activities to place
4599     * a the front of the list of choices, when shown to the user with a
4600     * {@link #ACTION_CHOOSER}.
4601     */
4602    public static final String EXTRA_INITIAL_INTENTS = "android.intent.extra.INITIAL_INTENTS";
4603
4604    /**
4605     * A {@link IntentSender} to start after ephemeral installation success.
4606     * @deprecated Use {@link #EXTRA_INSTANT_APP_SUCCESS).
4607     * @removed
4608     * @hide
4609     */
4610    @Deprecated
4611    public static final String EXTRA_EPHEMERAL_SUCCESS = "android.intent.extra.EPHEMERAL_SUCCESS";
4612
4613    /**
4614     * A {@link IntentSender} to start after instant app installation success.
4615     * @hide
4616     */
4617    @SystemApi
4618    public static final String EXTRA_INSTANT_APP_SUCCESS =
4619            "android.intent.extra.INSTANT_APP_SUCCESS";
4620
4621    /**
4622     * A {@link IntentSender} to start after ephemeral installation failure.
4623     * @deprecated Use {@link #EXTRA_INSTANT_APP_FAILURE).
4624     * @removed
4625     * @hide
4626     */
4627    @Deprecated
4628    public static final String EXTRA_EPHEMERAL_FAILURE = "android.intent.extra.EPHEMERAL_FAILURE";
4629
4630    /**
4631     * A {@link IntentSender} to start after instant app installation failure.
4632     * @hide
4633     */
4634    @SystemApi
4635    public static final String EXTRA_INSTANT_APP_FAILURE =
4636            "android.intent.extra.INSTANT_APP_FAILURE";
4637
4638    /**
4639     * The host name that triggered an ephemeral resolution.
4640     * @deprecated Use {@link #EXTRA_INSTANT_APP_HOSTNAME).
4641     * @removed
4642     * @hide
4643     */
4644    @Deprecated
4645    public static final String EXTRA_EPHEMERAL_HOSTNAME = "android.intent.extra.EPHEMERAL_HOSTNAME";
4646
4647    /**
4648     * The host name that triggered an instant app resolution.
4649     * @hide
4650     */
4651    @SystemApi
4652    public static final String EXTRA_INSTANT_APP_HOSTNAME =
4653            "android.intent.extra.INSTANT_APP_HOSTNAME";
4654
4655    /**
4656     * An opaque token to track ephemeral resolution.
4657     * @deprecated Use {@link #EXTRA_INSTANT_APP_TOKEN).
4658     * @removed
4659     * @hide
4660     */
4661    @Deprecated
4662    public static final String EXTRA_EPHEMERAL_TOKEN = "android.intent.extra.EPHEMERAL_TOKEN";
4663
4664    /**
4665     * An opaque token to track instant app resolution.
4666     * @hide
4667     */
4668    @SystemApi
4669    public static final String EXTRA_INSTANT_APP_TOKEN =
4670            "android.intent.extra.INSTANT_APP_TOKEN";
4671
4672    /**
4673     * The action that triggered an instant application resolution.
4674     * @hide
4675     */
4676    @SystemApi
4677    public static final String EXTRA_INSTANT_APP_ACTION = "android.intent.extra.INSTANT_APP_ACTION";
4678
4679    /**
4680     * An array of {@link Bundle}s containing details about resolved instant apps..
4681     * @hide
4682     */
4683    @SystemApi
4684    public static final String EXTRA_INSTANT_APP_BUNDLES =
4685            "android.intent.extra.INSTANT_APP_BUNDLES";
4686
4687    /**
4688     * A {@link Bundle} of metadata that describes the instant application that needs to be
4689     * installed. This data is populated from the response to
4690     * {@link android.content.pm.InstantAppResolveInfo#getExtras()} as provided by the registered
4691     * instant application resolver.
4692     * @hide
4693     */
4694    @SystemApi
4695    public static final String EXTRA_INSTANT_APP_EXTRAS =
4696            "android.intent.extra.INSTANT_APP_EXTRAS";
4697
4698    /**
4699     * A boolean value indicating that the instant app resolver was unable to state with certainty
4700     * that it did or did not have an app for the sanitized {@link Intent} defined at
4701     * {@link #EXTRA_INTENT}.
4702     * @hide
4703     */
4704    @SystemApi
4705    public static final String EXTRA_UNKNOWN_INSTANT_APP =
4706            "android.intent.extra.UNKNOWN_INSTANT_APP";
4707
4708    /**
4709     * The version code of the app to install components from.
4710     * @deprecated Use {@link #EXTRA_LONG_VERSION_CODE).
4711     * @hide
4712     */
4713    @Deprecated
4714    public static final String EXTRA_VERSION_CODE = "android.intent.extra.VERSION_CODE";
4715
4716    /**
4717     * The version code of the app to install components from.
4718     * @hide
4719     */
4720    @SystemApi
4721    public static final String EXTRA_LONG_VERSION_CODE = "android.intent.extra.LONG_VERSION_CODE";
4722
4723    /**
4724     * The app that triggered the instant app installation.
4725     * @hide
4726     */
4727    @SystemApi
4728    public static final String EXTRA_CALLING_PACKAGE
4729            = "android.intent.extra.CALLING_PACKAGE";
4730
4731    /**
4732     * Optional calling app provided bundle containing additional launch information the
4733     * installer may use.
4734     * @hide
4735     */
4736    @SystemApi
4737    public static final String EXTRA_VERIFICATION_BUNDLE
4738            = "android.intent.extra.VERIFICATION_BUNDLE";
4739
4740    /**
4741     * A Bundle forming a mapping of potential target package names to different extras Bundles
4742     * to add to the default intent extras in {@link #EXTRA_INTENT} when used with
4743     * {@link #ACTION_CHOOSER}. Each key should be a package name. The package need not
4744     * be currently installed on the device.
4745     *
4746     * <p>An application may choose to provide alternate extras for the case where a user
4747     * selects an activity from a predetermined set of target packages. If the activity
4748     * the user selects from the chooser belongs to a package with its package name as
4749     * a key in this bundle, the corresponding extras for that package will be merged with
4750     * the extras already present in the intent at {@link #EXTRA_INTENT}. If a replacement
4751     * extra has the same key as an extra already present in the intent it will overwrite
4752     * the extra from the intent.</p>
4753     *
4754     * <p><em>Examples:</em>
4755     * <ul>
4756     *     <li>An application may offer different {@link #EXTRA_TEXT} to an application
4757     *     when sharing with it via {@link #ACTION_SEND}, augmenting a link with additional query
4758     *     parameters for that target.</li>
4759     *     <li>An application may offer additional metadata for known targets of a given intent
4760     *     to pass along information only relevant to that target such as account or content
4761     *     identifiers already known to that application.</li>
4762     * </ul></p>
4763     */
4764    public static final String EXTRA_REPLACEMENT_EXTRAS =
4765            "android.intent.extra.REPLACEMENT_EXTRAS";
4766
4767    /**
4768     * An {@link IntentSender} that will be notified if a user successfully chooses a target
4769     * component to handle an action in an {@link #ACTION_CHOOSER} activity. The IntentSender
4770     * will have the extra {@link #EXTRA_CHOSEN_COMPONENT} appended to it containing the
4771     * {@link ComponentName} of the chosen component.
4772     *
4773     * <p>In some situations this callback may never come, for example if the user abandons
4774     * the chooser, switches to another task or any number of other reasons. Apps should not
4775     * be written assuming that this callback will always occur.</p>
4776     */
4777    public static final String EXTRA_CHOSEN_COMPONENT_INTENT_SENDER =
4778            "android.intent.extra.CHOSEN_COMPONENT_INTENT_SENDER";
4779
4780    /**
4781     * The {@link ComponentName} chosen by the user to complete an action.
4782     *
4783     * @see #EXTRA_CHOSEN_COMPONENT_INTENT_SENDER
4784     */
4785    public static final String EXTRA_CHOSEN_COMPONENT = "android.intent.extra.CHOSEN_COMPONENT";
4786
4787    /**
4788     * A {@link android.view.KeyEvent} object containing the event that
4789     * triggered the creation of the Intent it is in.
4790     */
4791    public static final String EXTRA_KEY_EVENT = "android.intent.extra.KEY_EVENT";
4792
4793    /**
4794     * Set to true in {@link #ACTION_REQUEST_SHUTDOWN} to request confirmation from the user
4795     * before shutting down.
4796     *
4797     * {@hide}
4798     */
4799    public static final String EXTRA_KEY_CONFIRM = "android.intent.extra.KEY_CONFIRM";
4800
4801    /**
4802     * Set to true in {@link #ACTION_REQUEST_SHUTDOWN} to indicate that the shutdown is
4803     * requested by the user.
4804     *
4805     * {@hide}
4806     */
4807    public static final String EXTRA_USER_REQUESTED_SHUTDOWN =
4808            "android.intent.extra.USER_REQUESTED_SHUTDOWN";
4809
4810    /**
4811     * Used as a boolean extra field in {@link android.content.Intent#ACTION_PACKAGE_REMOVED} or
4812     * {@link android.content.Intent#ACTION_PACKAGE_CHANGED} intents to override the default action
4813     * of restarting the application.
4814     */
4815    public static final String EXTRA_DONT_KILL_APP = "android.intent.extra.DONT_KILL_APP";
4816
4817    /**
4818     * A String holding the phone number originally entered in
4819     * {@link android.content.Intent#ACTION_NEW_OUTGOING_CALL}, or the actual
4820     * number to call in a {@link android.content.Intent#ACTION_CALL}.
4821     */
4822    public static final String EXTRA_PHONE_NUMBER = "android.intent.extra.PHONE_NUMBER";
4823
4824    /**
4825     * Used as an int extra field in {@link android.content.Intent#ACTION_UID_REMOVED}
4826     * intents to supply the uid the package had been assigned.  Also an optional
4827     * extra in {@link android.content.Intent#ACTION_PACKAGE_REMOVED} or
4828     * {@link android.content.Intent#ACTION_PACKAGE_CHANGED} for the same
4829     * purpose.
4830     */
4831    public static final String EXTRA_UID = "android.intent.extra.UID";
4832
4833    /**
4834     * @hide String array of package names.
4835     */
4836    @SystemApi
4837    public static final String EXTRA_PACKAGES = "android.intent.extra.PACKAGES";
4838
4839    /**
4840     * Used as a boolean extra field in {@link android.content.Intent#ACTION_PACKAGE_REMOVED}
4841     * intents to indicate whether this represents a full uninstall (removing
4842     * both the code and its data) or a partial uninstall (leaving its data,
4843     * implying that this is an update).
4844     */
4845    public static final String EXTRA_DATA_REMOVED = "android.intent.extra.DATA_REMOVED";
4846
4847    /**
4848     * @hide
4849     * Used as a boolean extra field in {@link android.content.Intent#ACTION_PACKAGE_REMOVED}
4850     * intents to indicate that at this point the package has been removed for
4851     * all users on the device.
4852     */
4853    public static final String EXTRA_REMOVED_FOR_ALL_USERS
4854            = "android.intent.extra.REMOVED_FOR_ALL_USERS";
4855
4856    /**
4857     * Used as a boolean extra field in {@link android.content.Intent#ACTION_PACKAGE_REMOVED}
4858     * intents to indicate that this is a replacement of the package, so this
4859     * broadcast will immediately be followed by an add broadcast for a
4860     * different version of the same package.
4861     */
4862    public static final String EXTRA_REPLACING = "android.intent.extra.REPLACING";
4863
4864    /**
4865     * Used as an int extra field in {@link android.app.AlarmManager} intents
4866     * to tell the application being invoked how many pending alarms are being
4867     * delievered with the intent.  For one-shot alarms this will always be 1.
4868     * For recurring alarms, this might be greater than 1 if the device was
4869     * asleep or powered off at the time an earlier alarm would have been
4870     * delivered.
4871     */
4872    public static final String EXTRA_ALARM_COUNT = "android.intent.extra.ALARM_COUNT";
4873
4874    /**
4875     * Used as an int extra field in {@link android.content.Intent#ACTION_DOCK_EVENT}
4876     * intents to request the dock state.  Possible values are
4877     * {@link android.content.Intent#EXTRA_DOCK_STATE_UNDOCKED},
4878     * {@link android.content.Intent#EXTRA_DOCK_STATE_DESK}, or
4879     * {@link android.content.Intent#EXTRA_DOCK_STATE_CAR}, or
4880     * {@link android.content.Intent#EXTRA_DOCK_STATE_LE_DESK}, or
4881     * {@link android.content.Intent#EXTRA_DOCK_STATE_HE_DESK}.
4882     */
4883    public static final String EXTRA_DOCK_STATE = "android.intent.extra.DOCK_STATE";
4884
4885    /**
4886     * Used as an int value for {@link android.content.Intent#EXTRA_DOCK_STATE}
4887     * to represent that the phone is not in any dock.
4888     */
4889    public static final int EXTRA_DOCK_STATE_UNDOCKED = 0;
4890
4891    /**
4892     * Used as an int value for {@link android.content.Intent#EXTRA_DOCK_STATE}
4893     * to represent that the phone is in a desk dock.
4894     */
4895    public static final int EXTRA_DOCK_STATE_DESK = 1;
4896
4897    /**
4898     * Used as an int value for {@link android.content.Intent#EXTRA_DOCK_STATE}
4899     * to represent that the phone is in a car dock.
4900     */
4901    public static final int EXTRA_DOCK_STATE_CAR = 2;
4902
4903    /**
4904     * Used as an int value for {@link android.content.Intent#EXTRA_DOCK_STATE}
4905     * to represent that the phone is in a analog (low end) dock.
4906     */
4907    public static final int EXTRA_DOCK_STATE_LE_DESK = 3;
4908
4909    /**
4910     * Used as an int value for {@link android.content.Intent#EXTRA_DOCK_STATE}
4911     * to represent that the phone is in a digital (high end) dock.
4912     */
4913    public static final int EXTRA_DOCK_STATE_HE_DESK = 4;
4914
4915    /**
4916     * Boolean that can be supplied as meta-data with a dock activity, to
4917     * indicate that the dock should take over the home key when it is active.
4918     */
4919    public static final String METADATA_DOCK_HOME = "android.dock_home";
4920
4921    /**
4922     * Used as a parcelable extra field in {@link #ACTION_APP_ERROR}, containing
4923     * the bug report.
4924     */
4925    public static final String EXTRA_BUG_REPORT = "android.intent.extra.BUG_REPORT";
4926
4927    /**
4928     * Used in the extra field in the remote intent. It's astring token passed with the
4929     * remote intent.
4930     */
4931    public static final String EXTRA_REMOTE_INTENT_TOKEN =
4932            "android.intent.extra.remote_intent_token";
4933
4934    /**
4935     * @deprecated See {@link #EXTRA_CHANGED_COMPONENT_NAME_LIST}; this field
4936     * will contain only the first name in the list.
4937     */
4938    @Deprecated public static final String EXTRA_CHANGED_COMPONENT_NAME =
4939            "android.intent.extra.changed_component_name";
4940
4941    /**
4942     * This field is part of {@link android.content.Intent#ACTION_PACKAGE_CHANGED},
4943     * and contains a string array of all of the components that have changed.  If
4944     * the state of the overall package has changed, then it will contain an entry
4945     * with the package name itself.
4946     */
4947    public static final String EXTRA_CHANGED_COMPONENT_NAME_LIST =
4948            "android.intent.extra.changed_component_name_list";
4949
4950    /**
4951     * This field is part of
4952     * {@link android.content.Intent#ACTION_EXTERNAL_APPLICATIONS_AVAILABLE},
4953     * {@link android.content.Intent#ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE},
4954     * {@link android.content.Intent#ACTION_PACKAGES_SUSPENDED},
4955     * {@link android.content.Intent#ACTION_PACKAGES_UNSUSPENDED}
4956     * and contains a string array of all of the components that have changed.
4957     */
4958    public static final String EXTRA_CHANGED_PACKAGE_LIST =
4959            "android.intent.extra.changed_package_list";
4960
4961    /**
4962     * This field is part of
4963     * {@link android.content.Intent#ACTION_EXTERNAL_APPLICATIONS_AVAILABLE},
4964     * {@link android.content.Intent#ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE}
4965     * and contains an integer array of uids of all of the components
4966     * that have changed.
4967     */
4968    public static final String EXTRA_CHANGED_UID_LIST =
4969            "android.intent.extra.changed_uid_list";
4970
4971    /**
4972     * @hide
4973     * Magic extra system code can use when binding, to give a label for
4974     * who it is that has bound to a service.  This is an integer giving
4975     * a framework string resource that can be displayed to the user.
4976     */
4977    public static final String EXTRA_CLIENT_LABEL =
4978            "android.intent.extra.client_label";
4979
4980    /**
4981     * @hide
4982     * Magic extra system code can use when binding, to give a PendingIntent object
4983     * that can be launched for the user to disable the system's use of this
4984     * service.
4985     */
4986    public static final String EXTRA_CLIENT_INTENT =
4987            "android.intent.extra.client_intent";
4988
4989    /**
4990     * Extra used to indicate that an intent should only return data that is on
4991     * the local device. This is a boolean extra; the default is false. If true,
4992     * an implementation should only allow the user to select data that is
4993     * already on the device, not requiring it be downloaded from a remote
4994     * service when opened.
4995     *
4996     * @see #ACTION_GET_CONTENT
4997     * @see #ACTION_OPEN_DOCUMENT
4998     * @see #ACTION_OPEN_DOCUMENT_TREE
4999     * @see #ACTION_CREATE_DOCUMENT
5000     */
5001    public static final String EXTRA_LOCAL_ONLY =
5002            "android.intent.extra.LOCAL_ONLY";
5003
5004    /**
5005     * Extra used to indicate that an intent can allow the user to select and
5006     * return multiple items. This is a boolean extra; the default is false. If
5007     * true, an implementation is allowed to present the user with a UI where
5008     * they can pick multiple items that are all returned to the caller. When
5009     * this happens, they should be returned as the {@link #getClipData()} part
5010     * of the result Intent.
5011     *
5012     * @see #ACTION_GET_CONTENT
5013     * @see #ACTION_OPEN_DOCUMENT
5014     */
5015    public static final String EXTRA_ALLOW_MULTIPLE =
5016            "android.intent.extra.ALLOW_MULTIPLE";
5017
5018    /**
5019     * The integer userHandle carried with broadcast intents related to addition, removal and
5020     * switching of users and managed profiles - {@link #ACTION_USER_ADDED},
5021     * {@link #ACTION_USER_REMOVED} and {@link #ACTION_USER_SWITCHED}.
5022     *
5023     * @hide
5024     */
5025    public static final String EXTRA_USER_HANDLE =
5026            "android.intent.extra.user_handle";
5027
5028    /**
5029     * The UserHandle carried with broadcasts intents related to addition and removal of managed
5030     * profiles - {@link #ACTION_MANAGED_PROFILE_ADDED} and {@link #ACTION_MANAGED_PROFILE_REMOVED}.
5031     */
5032    public static final String EXTRA_USER =
5033            "android.intent.extra.USER";
5034
5035    /**
5036     * Extra used in the response from a BroadcastReceiver that handles
5037     * {@link #ACTION_GET_RESTRICTION_ENTRIES}. The type of the extra is
5038     * <code>ArrayList&lt;RestrictionEntry&gt;</code>.
5039     */
5040    public static final String EXTRA_RESTRICTIONS_LIST = "android.intent.extra.restrictions_list";
5041
5042    /**
5043     * Extra sent in the intent to the BroadcastReceiver that handles
5044     * {@link #ACTION_GET_RESTRICTION_ENTRIES}. The type of the extra is a Bundle containing
5045     * the restrictions as key/value pairs.
5046     */
5047    public static final String EXTRA_RESTRICTIONS_BUNDLE =
5048            "android.intent.extra.restrictions_bundle";
5049
5050    /**
5051     * Extra used in the response from a BroadcastReceiver that handles
5052     * {@link #ACTION_GET_RESTRICTION_ENTRIES}.
5053     */
5054    public static final String EXTRA_RESTRICTIONS_INTENT =
5055            "android.intent.extra.restrictions_intent";
5056
5057    /**
5058     * Extra used to communicate a set of acceptable MIME types. The type of the
5059     * extra is {@code String[]}. Values may be a combination of concrete MIME
5060     * types (such as "image/png") and/or partial MIME types (such as
5061     * "audio/*").
5062     *
5063     * @see #ACTION_GET_CONTENT
5064     * @see #ACTION_OPEN_DOCUMENT
5065     */
5066    public static final String EXTRA_MIME_TYPES = "android.intent.extra.MIME_TYPES";
5067
5068    /**
5069     * Optional extra for {@link #ACTION_SHUTDOWN} that allows the sender to qualify that
5070     * this shutdown is only for the user space of the system, not a complete shutdown.
5071     * When this is true, hardware devices can use this information to determine that
5072     * they shouldn't do a complete shutdown of their device since this is not a
5073     * complete shutdown down to the kernel, but only user space restarting.
5074     * The default if not supplied is false.
5075     */
5076    public static final String EXTRA_SHUTDOWN_USERSPACE_ONLY
5077            = "android.intent.extra.SHUTDOWN_USERSPACE_ONLY";
5078
5079    /**
5080     * Optional int extra for {@link #ACTION_TIME_CHANGED} that indicates the
5081     * user has set their time format preference. See {@link #EXTRA_TIME_PREF_VALUE_USE_12_HOUR},
5082     * {@link #EXTRA_TIME_PREF_VALUE_USE_24_HOUR} and
5083     * {@link #EXTRA_TIME_PREF_VALUE_USE_LOCALE_DEFAULT}. The value must not be negative.
5084     *
5085     * @hide for internal use only.
5086     */
5087    public static final String EXTRA_TIME_PREF_24_HOUR_FORMAT =
5088            "android.intent.extra.TIME_PREF_24_HOUR_FORMAT";
5089    /** @hide */
5090    public static final int EXTRA_TIME_PREF_VALUE_USE_12_HOUR = 0;
5091    /** @hide */
5092    public static final int EXTRA_TIME_PREF_VALUE_USE_24_HOUR = 1;
5093    /** @hide */
5094    public static final int EXTRA_TIME_PREF_VALUE_USE_LOCALE_DEFAULT = 2;
5095
5096    /**
5097     * Intent extra: the reason that the operation associated with this intent is being performed.
5098     *
5099     * <p>Type: String
5100     * @hide
5101     */
5102    @SystemApi
5103    public static final String EXTRA_REASON = "android.intent.extra.REASON";
5104
5105    /**
5106     * {@hide}
5107     * This extra will be send together with {@link #ACTION_FACTORY_RESET}
5108     */
5109    public static final String EXTRA_WIPE_EXTERNAL_STORAGE = "android.intent.extra.WIPE_EXTERNAL_STORAGE";
5110
5111    /**
5112     * {@hide}
5113     * This extra will be set to true when the user choose to wipe the data on eSIM during factory
5114     * reset for the device with eSIM. This extra will be sent together with
5115     * {@link #ACTION_FACTORY_RESET}
5116     */
5117    public static final String EXTRA_WIPE_ESIMS = "com.android.internal.intent.extra.WIPE_ESIMS";
5118
5119    /**
5120     * Optional {@link android.app.PendingIntent} extra used to deliver the result of the SIM
5121     * activation request.
5122     * TODO: Add information about the structure and response data used with the pending intent.
5123     * @hide
5124     */
5125    public static final String EXTRA_SIM_ACTIVATION_RESPONSE =
5126            "android.intent.extra.SIM_ACTIVATION_RESPONSE";
5127
5128    /**
5129     * Optional index with semantics depending on the intent action.
5130     *
5131     * <p>The value must be an integer greater or equal to 0.
5132     * @see #ACTION_QUICK_VIEW
5133     */
5134    public static final String EXTRA_INDEX = "android.intent.extra.INDEX";
5135
5136    /**
5137     * Tells the quick viewer to show additional UI actions suitable for the passed Uris,
5138     * such as opening in other apps, sharing, opening, editing, printing, deleting,
5139     * casting, etc.
5140     *
5141     * <p>The value is boolean. By default false.
5142     * @see #ACTION_QUICK_VIEW
5143     * @removed
5144     */
5145    @Deprecated
5146    public static final String EXTRA_QUICK_VIEW_ADVANCED =
5147            "android.intent.extra.QUICK_VIEW_ADVANCED";
5148
5149    /**
5150     * An optional extra of {@code String[]} indicating which quick view features should be made
5151     * available to the user in the quick view UI while handing a
5152     * {@link Intent#ACTION_QUICK_VIEW} intent.
5153     * <li>Enumeration of features here is not meant to restrict capabilities of the quick viewer.
5154     * Quick viewer can implement features not listed below.
5155     * <li>Features included at this time are: {@link QuickViewConstants#FEATURE_VIEW},
5156     * {@link QuickViewConstants#FEATURE_EDIT}, {@link QuickViewConstants#FEATURE_DELETE},
5157     * {@link QuickViewConstants#FEATURE_DOWNLOAD}, {@link QuickViewConstants#FEATURE_SEND},
5158     * {@link QuickViewConstants#FEATURE_PRINT}.
5159     * <p>
5160     * Requirements:
5161     * <li>Quick viewer shouldn't show a feature if the feature is absent in
5162     * {@link #EXTRA_QUICK_VIEW_FEATURES}.
5163     * <li>When {@link #EXTRA_QUICK_VIEW_FEATURES} is not present, quick viewer should follow
5164     * internal policies.
5165     * <li>Presence of an feature in {@link #EXTRA_QUICK_VIEW_FEATURES}, does not constitute a
5166     * requirement that the feature be shown. Quick viewer may, according to its own policies,
5167     * disable or hide features.
5168     *
5169     * @see #ACTION_QUICK_VIEW
5170     */
5171    public static final String EXTRA_QUICK_VIEW_FEATURES =
5172            "android.intent.extra.QUICK_VIEW_FEATURES";
5173
5174    /**
5175     * Optional boolean extra indicating whether quiet mode has been switched on or off.
5176     * When a profile goes into quiet mode, all apps in the profile are killed and the
5177     * profile user is stopped. Widgets originating from the profile are masked, and app
5178     * launcher icons are grayed out.
5179     */
5180    public static final String EXTRA_QUIET_MODE = "android.intent.extra.QUIET_MODE";
5181
5182    /**
5183     * Used as an int extra field in {@link #ACTION_MEDIA_RESOURCE_GRANTED}
5184     * intents to specify the resource type granted. Possible values are
5185     * {@link #EXTRA_MEDIA_RESOURCE_TYPE_VIDEO_CODEC} or
5186     * {@link #EXTRA_MEDIA_RESOURCE_TYPE_AUDIO_CODEC}.
5187     *
5188     * @hide
5189     */
5190    public static final String EXTRA_MEDIA_RESOURCE_TYPE =
5191            "android.intent.extra.MEDIA_RESOURCE_TYPE";
5192
5193    /**
5194     * Used as a boolean extra field in {@link #ACTION_CHOOSER} intents to specify
5195     * whether to show the chooser or not when there is only one application available
5196     * to choose from.
5197     *
5198     * @hide
5199     */
5200    public static final String EXTRA_AUTO_LAUNCH_SINGLE_CHOICE =
5201            "android.intent.extra.AUTO_LAUNCH_SINGLE_CHOICE";
5202
5203    /**
5204     * Used as an int value for {@link #EXTRA_MEDIA_RESOURCE_TYPE}
5205     * to represent that a video codec is allowed to use.
5206     *
5207     * @hide
5208     */
5209    public static final int EXTRA_MEDIA_RESOURCE_TYPE_VIDEO_CODEC = 0;
5210
5211    /**
5212     * Used as an int value for {@link #EXTRA_MEDIA_RESOURCE_TYPE}
5213     * to represent that a audio codec is allowed to use.
5214     *
5215     * @hide
5216     */
5217    public static final int EXTRA_MEDIA_RESOURCE_TYPE_AUDIO_CODEC = 1;
5218
5219    // ---------------------------------------------------------------------
5220    // ---------------------------------------------------------------------
5221    // Intent flags (see mFlags variable).
5222
5223    /** @hide */
5224    @IntDef(flag = true, prefix = { "FLAG_GRANT_" }, value = {
5225            FLAG_GRANT_READ_URI_PERMISSION, FLAG_GRANT_WRITE_URI_PERMISSION,
5226            FLAG_GRANT_PERSISTABLE_URI_PERMISSION, FLAG_GRANT_PREFIX_URI_PERMISSION })
5227    @Retention(RetentionPolicy.SOURCE)
5228    public @interface GrantUriMode {}
5229
5230    /** @hide */
5231    @IntDef(flag = true, prefix = { "FLAG_GRANT_" }, value = {
5232            FLAG_GRANT_READ_URI_PERMISSION, FLAG_GRANT_WRITE_URI_PERMISSION })
5233    @Retention(RetentionPolicy.SOURCE)
5234    public @interface AccessUriMode {}
5235
5236    /**
5237     * Test if given mode flags specify an access mode, which must be at least
5238     * read and/or write.
5239     *
5240     * @hide
5241     */
5242    public static boolean isAccessUriMode(int modeFlags) {
5243        return (modeFlags & (Intent.FLAG_GRANT_READ_URI_PERMISSION
5244                | Intent.FLAG_GRANT_WRITE_URI_PERMISSION)) != 0;
5245    }
5246
5247    /** @hide */
5248    @IntDef(flag = true, prefix = { "FLAG_" }, value = {
5249            FLAG_GRANT_READ_URI_PERMISSION,
5250            FLAG_GRANT_WRITE_URI_PERMISSION,
5251            FLAG_FROM_BACKGROUND,
5252            FLAG_DEBUG_LOG_RESOLUTION,
5253            FLAG_EXCLUDE_STOPPED_PACKAGES,
5254            FLAG_INCLUDE_STOPPED_PACKAGES,
5255            FLAG_GRANT_PERSISTABLE_URI_PERMISSION,
5256            FLAG_GRANT_PREFIX_URI_PERMISSION,
5257            FLAG_DEBUG_TRIAGED_MISSING,
5258            FLAG_IGNORE_EPHEMERAL,
5259            FLAG_ACTIVITY_MATCH_EXTERNAL,
5260            FLAG_ACTIVITY_NO_HISTORY,
5261            FLAG_ACTIVITY_SINGLE_TOP,
5262            FLAG_ACTIVITY_NEW_TASK,
5263            FLAG_ACTIVITY_MULTIPLE_TASK,
5264            FLAG_ACTIVITY_CLEAR_TOP,
5265            FLAG_ACTIVITY_FORWARD_RESULT,
5266            FLAG_ACTIVITY_PREVIOUS_IS_TOP,
5267            FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS,
5268            FLAG_ACTIVITY_BROUGHT_TO_FRONT,
5269            FLAG_ACTIVITY_RESET_TASK_IF_NEEDED,
5270            FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY,
5271            FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET,
5272            FLAG_ACTIVITY_NEW_DOCUMENT,
5273            FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET,
5274            FLAG_ACTIVITY_NO_USER_ACTION,
5275            FLAG_ACTIVITY_REORDER_TO_FRONT,
5276            FLAG_ACTIVITY_NO_ANIMATION,
5277            FLAG_ACTIVITY_CLEAR_TASK,
5278            FLAG_ACTIVITY_TASK_ON_HOME,
5279            FLAG_ACTIVITY_RETAIN_IN_RECENTS,
5280            FLAG_ACTIVITY_LAUNCH_ADJACENT,
5281            FLAG_RECEIVER_REGISTERED_ONLY,
5282            FLAG_RECEIVER_REPLACE_PENDING,
5283            FLAG_RECEIVER_FOREGROUND,
5284            FLAG_RECEIVER_NO_ABORT,
5285            FLAG_RECEIVER_REGISTERED_ONLY_BEFORE_BOOT,
5286            FLAG_RECEIVER_BOOT_UPGRADE,
5287            FLAG_RECEIVER_INCLUDE_BACKGROUND,
5288            FLAG_RECEIVER_EXCLUDE_BACKGROUND,
5289            FLAG_RECEIVER_FROM_SHELL,
5290            FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS,
5291    })
5292    @Retention(RetentionPolicy.SOURCE)
5293    public @interface Flags {}
5294
5295    /** @hide */
5296    @IntDef(flag = true, prefix = { "FLAG_" }, value = {
5297            FLAG_FROM_BACKGROUND,
5298            FLAG_DEBUG_LOG_RESOLUTION,
5299            FLAG_EXCLUDE_STOPPED_PACKAGES,
5300            FLAG_INCLUDE_STOPPED_PACKAGES,
5301            FLAG_DEBUG_TRIAGED_MISSING,
5302            FLAG_IGNORE_EPHEMERAL,
5303            FLAG_ACTIVITY_MATCH_EXTERNAL,
5304            FLAG_ACTIVITY_NO_HISTORY,
5305            FLAG_ACTIVITY_SINGLE_TOP,
5306            FLAG_ACTIVITY_NEW_TASK,
5307            FLAG_ACTIVITY_MULTIPLE_TASK,
5308            FLAG_ACTIVITY_CLEAR_TOP,
5309            FLAG_ACTIVITY_FORWARD_RESULT,
5310            FLAG_ACTIVITY_PREVIOUS_IS_TOP,
5311            FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS,
5312            FLAG_ACTIVITY_BROUGHT_TO_FRONT,
5313            FLAG_ACTIVITY_RESET_TASK_IF_NEEDED,
5314            FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY,
5315            FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET,
5316            FLAG_ACTIVITY_NEW_DOCUMENT,
5317            FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET,
5318            FLAG_ACTIVITY_NO_USER_ACTION,
5319            FLAG_ACTIVITY_REORDER_TO_FRONT,
5320            FLAG_ACTIVITY_NO_ANIMATION,
5321            FLAG_ACTIVITY_CLEAR_TASK,
5322            FLAG_ACTIVITY_TASK_ON_HOME,
5323            FLAG_ACTIVITY_RETAIN_IN_RECENTS,
5324            FLAG_ACTIVITY_LAUNCH_ADJACENT,
5325            FLAG_RECEIVER_REGISTERED_ONLY,
5326            FLAG_RECEIVER_REPLACE_PENDING,
5327            FLAG_RECEIVER_FOREGROUND,
5328            FLAG_RECEIVER_NO_ABORT,
5329            FLAG_RECEIVER_REGISTERED_ONLY_BEFORE_BOOT,
5330            FLAG_RECEIVER_BOOT_UPGRADE,
5331            FLAG_RECEIVER_INCLUDE_BACKGROUND,
5332            FLAG_RECEIVER_EXCLUDE_BACKGROUND,
5333            FLAG_RECEIVER_FROM_SHELL,
5334            FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS,
5335    })
5336    @Retention(RetentionPolicy.SOURCE)
5337    public @interface MutableFlags {}
5338
5339    /**
5340     * If set, the recipient of this Intent will be granted permission to
5341     * perform read operations on the URI in the Intent's data and any URIs
5342     * specified in its ClipData.  When applying to an Intent's ClipData,
5343     * all URIs as well as recursive traversals through data or other ClipData
5344     * in Intent items will be granted; only the grant flags of the top-level
5345     * Intent are used.
5346     */
5347    public static final int FLAG_GRANT_READ_URI_PERMISSION = 0x00000001;
5348    /**
5349     * If set, the recipient of this Intent will be granted permission to
5350     * perform write operations on the URI in the Intent's data and any URIs
5351     * specified in its ClipData.  When applying to an Intent's ClipData,
5352     * all URIs as well as recursive traversals through data or other ClipData
5353     * in Intent items will be granted; only the grant flags of the top-level
5354     * Intent are used.
5355     */
5356    public static final int FLAG_GRANT_WRITE_URI_PERMISSION = 0x00000002;
5357    /**
5358     * Can be set by the caller to indicate that this Intent is coming from
5359     * a background operation, not from direct user interaction.
5360     */
5361    public static final int FLAG_FROM_BACKGROUND = 0x00000004;
5362    /**
5363     * A flag you can enable for debugging: when set, log messages will be
5364     * printed during the resolution of this intent to show you what has
5365     * been found to create the final resolved list.
5366     */
5367    public static final int FLAG_DEBUG_LOG_RESOLUTION = 0x00000008;
5368    /**
5369     * If set, this intent will not match any components in packages that
5370     * are currently stopped.  If this is not set, then the default behavior
5371     * is to include such applications in the result.
5372     */
5373    public static final int FLAG_EXCLUDE_STOPPED_PACKAGES = 0x00000010;
5374    /**
5375     * If set, this intent will always match any components in packages that
5376     * are currently stopped.  This is the default behavior when
5377     * {@link #FLAG_EXCLUDE_STOPPED_PACKAGES} is not set.  If both of these
5378     * flags are set, this one wins (it allows overriding of exclude for
5379     * places where the framework may automatically set the exclude flag).
5380     */
5381    public static final int FLAG_INCLUDE_STOPPED_PACKAGES = 0x00000020;
5382
5383    /**
5384     * When combined with {@link #FLAG_GRANT_READ_URI_PERMISSION} and/or
5385     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, the URI permission grant can be
5386     * persisted across device reboots until explicitly revoked with
5387     * {@link Context#revokeUriPermission(Uri, int)}. This flag only offers the
5388     * grant for possible persisting; the receiving application must call
5389     * {@link ContentResolver#takePersistableUriPermission(Uri, int)} to
5390     * actually persist.
5391     *
5392     * @see ContentResolver#takePersistableUriPermission(Uri, int)
5393     * @see ContentResolver#releasePersistableUriPermission(Uri, int)
5394     * @see ContentResolver#getPersistedUriPermissions()
5395     * @see ContentResolver#getOutgoingPersistedUriPermissions()
5396     */
5397    public static final int FLAG_GRANT_PERSISTABLE_URI_PERMISSION = 0x00000040;
5398
5399    /**
5400     * When combined with {@link #FLAG_GRANT_READ_URI_PERMISSION} and/or
5401     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, the URI permission grant
5402     * applies to any URI that is a prefix match against the original granted
5403     * URI. (Without this flag, the URI must match exactly for access to be
5404     * granted.) Another URI is considered a prefix match only when scheme,
5405     * authority, and all path segments defined by the prefix are an exact
5406     * match.
5407     */
5408    public static final int FLAG_GRANT_PREFIX_URI_PERMISSION = 0x00000080;
5409
5410    /**
5411     * Internal flag used to indicate that a system component has done their
5412     * homework and verified that they correctly handle packages and components
5413     * that come and go over time. In particular:
5414     * <ul>
5415     * <li>Apps installed on external storage, which will appear to be
5416     * uninstalled while the the device is ejected.
5417     * <li>Apps with encryption unaware components, which will appear to not
5418     * exist while the device is locked.
5419     * </ul>
5420     *
5421     * @hide
5422     */
5423    public static final int FLAG_DEBUG_TRIAGED_MISSING = 0x00000100;
5424
5425    /**
5426     * Internal flag used to indicate ephemeral applications should not be
5427     * considered when resolving the intent.
5428     *
5429     * @hide
5430     */
5431    public static final int FLAG_IGNORE_EPHEMERAL = 0x00000200;
5432
5433    /**
5434     * If set, the new activity is not kept in the history stack.  As soon as
5435     * the user navigates away from it, the activity is finished.  This may also
5436     * be set with the {@link android.R.styleable#AndroidManifestActivity_noHistory
5437     * noHistory} attribute.
5438     *
5439     * <p>If set, {@link android.app.Activity#onActivityResult onActivityResult()}
5440     * is never invoked when the current activity starts a new activity which
5441     * sets a result and finishes.
5442     */
5443    public static final int FLAG_ACTIVITY_NO_HISTORY = 0x40000000;
5444    /**
5445     * If set, the activity will not be launched if it is already running
5446     * at the top of the history stack.
5447     */
5448    public static final int FLAG_ACTIVITY_SINGLE_TOP = 0x20000000;
5449    /**
5450     * If set, this activity will become the start of a new task on this
5451     * history stack.  A task (from the activity that started it to the
5452     * next task activity) defines an atomic group of activities that the
5453     * user can move to.  Tasks can be moved to the foreground and background;
5454     * all of the activities inside of a particular task always remain in
5455     * the same order.  See
5456     * <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
5457     * Stack</a> for more information about tasks.
5458     *
5459     * <p>This flag is generally used by activities that want
5460     * to present a "launcher" style behavior: they give the user a list of
5461     * separate things that can be done, which otherwise run completely
5462     * independently of the activity launching them.
5463     *
5464     * <p>When using this flag, if a task is already running for the activity
5465     * you are now starting, then a new activity will not be started; instead,
5466     * the current task will simply be brought to the front of the screen with
5467     * the state it was last in.  See {@link #FLAG_ACTIVITY_MULTIPLE_TASK} for a flag
5468     * to disable this behavior.
5469     *
5470     * <p>This flag can not be used when the caller is requesting a result from
5471     * the activity being launched.
5472     */
5473    public static final int FLAG_ACTIVITY_NEW_TASK = 0x10000000;
5474    /**
5475     * This flag is used to create a new task and launch an activity into it.
5476     * This flag is always paired with either {@link #FLAG_ACTIVITY_NEW_DOCUMENT}
5477     * or {@link #FLAG_ACTIVITY_NEW_TASK}. In both cases these flags alone would
5478     * search through existing tasks for ones matching this Intent. Only if no such
5479     * task is found would a new task be created. When paired with
5480     * FLAG_ACTIVITY_MULTIPLE_TASK both of these behaviors are modified to skip
5481     * the search for a matching task and unconditionally start a new task.
5482     *
5483     * <strong>When used with {@link #FLAG_ACTIVITY_NEW_TASK} do not use this
5484     * flag unless you are implementing your own
5485     * top-level application launcher.</strong>  Used in conjunction with
5486     * {@link #FLAG_ACTIVITY_NEW_TASK} to disable the
5487     * behavior of bringing an existing task to the foreground.  When set,
5488     * a new task is <em>always</em> started to host the Activity for the
5489     * Intent, regardless of whether there is already an existing task running
5490     * the same thing.
5491     *
5492     * <p><strong>Because the default system does not include graphical task management,
5493     * you should not use this flag unless you provide some way for a user to
5494     * return back to the tasks you have launched.</strong>
5495     *
5496     * See {@link #FLAG_ACTIVITY_NEW_DOCUMENT} for details of this flag's use for
5497     * creating new document tasks.
5498     *
5499     * <p>This flag is ignored if one of {@link #FLAG_ACTIVITY_NEW_TASK} or
5500     * {@link #FLAG_ACTIVITY_NEW_DOCUMENT} is not also set.
5501     *
5502     * <p>See
5503     * <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
5504     * Stack</a> for more information about tasks.
5505     *
5506     * @see #FLAG_ACTIVITY_NEW_DOCUMENT
5507     * @see #FLAG_ACTIVITY_NEW_TASK
5508     */
5509    public static final int FLAG_ACTIVITY_MULTIPLE_TASK = 0x08000000;
5510    /**
5511     * If set, and the activity being launched is already running in the
5512     * current task, then instead of launching a new instance of that activity,
5513     * all of the other activities on top of it will be closed and this Intent
5514     * will be delivered to the (now on top) old activity as a new Intent.
5515     *
5516     * <p>For example, consider a task consisting of the activities: A, B, C, D.
5517     * If D calls startActivity() with an Intent that resolves to the component
5518     * of activity B, then C and D will be finished and B receive the given
5519     * Intent, resulting in the stack now being: A, B.
5520     *
5521     * <p>The currently running instance of activity B in the above example will
5522     * either receive the new intent you are starting here in its
5523     * onNewIntent() method, or be itself finished and restarted with the
5524     * new intent.  If it has declared its launch mode to be "multiple" (the
5525     * default) and you have not set {@link #FLAG_ACTIVITY_SINGLE_TOP} in
5526     * the same intent, then it will be finished and re-created; for all other
5527     * launch modes or if {@link #FLAG_ACTIVITY_SINGLE_TOP} is set then this
5528     * Intent will be delivered to the current instance's onNewIntent().
5529     *
5530     * <p>This launch mode can also be used to good effect in conjunction with
5531     * {@link #FLAG_ACTIVITY_NEW_TASK}: if used to start the root activity
5532     * of a task, it will bring any currently running instance of that task
5533     * to the foreground, and then clear it to its root state.  This is
5534     * especially useful, for example, when launching an activity from the
5535     * notification manager.
5536     *
5537     * <p>See
5538     * <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
5539     * Stack</a> for more information about tasks.
5540     */
5541    public static final int FLAG_ACTIVITY_CLEAR_TOP = 0x04000000;
5542    /**
5543     * If set and this intent is being used to launch a new activity from an
5544     * existing one, then the reply target of the existing activity will be
5545     * transfered to the new activity.  This way the new activity can call
5546     * {@link android.app.Activity#setResult} and have that result sent back to
5547     * the reply target of the original activity.
5548     */
5549    public static final int FLAG_ACTIVITY_FORWARD_RESULT = 0x02000000;
5550    /**
5551     * If set and this intent is being used to launch a new activity from an
5552     * existing one, the current activity will not be counted as the top
5553     * activity for deciding whether the new intent should be delivered to
5554     * the top instead of starting a new one.  The previous activity will
5555     * be used as the top, with the assumption being that the current activity
5556     * will finish itself immediately.
5557     */
5558    public static final int FLAG_ACTIVITY_PREVIOUS_IS_TOP = 0x01000000;
5559    /**
5560     * If set, the new activity is not kept in the list of recently launched
5561     * activities.
5562     */
5563    public static final int FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS = 0x00800000;
5564    /**
5565     * This flag is not normally set by application code, but set for you by
5566     * the system as described in the
5567     * {@link android.R.styleable#AndroidManifestActivity_launchMode
5568     * launchMode} documentation for the singleTask mode.
5569     */
5570    public static final int FLAG_ACTIVITY_BROUGHT_TO_FRONT = 0x00400000;
5571    /**
5572     * If set, and this activity is either being started in a new task or
5573     * bringing to the top an existing task, then it will be launched as
5574     * the front door of the task.  This will result in the application of
5575     * any affinities needed to have that task in the proper state (either
5576     * moving activities to or from it), or simply resetting that task to
5577     * its initial state if needed.
5578     */
5579    public static final int FLAG_ACTIVITY_RESET_TASK_IF_NEEDED = 0x00200000;
5580    /**
5581     * This flag is not normally set by application code, but set for you by
5582     * the system if this activity is being launched from history
5583     * (longpress home key).
5584     */
5585    public static final int FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY = 0x00100000;
5586    /**
5587     * @deprecated As of API 21 this performs identically to
5588     * {@link #FLAG_ACTIVITY_NEW_DOCUMENT} which should be used instead of this.
5589     */
5590    @Deprecated
5591    public static final int FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET = 0x00080000;
5592    /**
5593     * This flag is used to open a document into a new task rooted at the activity launched
5594     * by this Intent. Through the use of this flag, or its equivalent attribute,
5595     * {@link android.R.attr#documentLaunchMode} multiple instances of the same activity
5596     * containing different documents will appear in the recent tasks list.
5597     *
5598     * <p>The use of the activity attribute form of this,
5599     * {@link android.R.attr#documentLaunchMode}, is
5600     * preferred over the Intent flag described here. The attribute form allows the
5601     * Activity to specify multiple document behavior for all launchers of the Activity
5602     * whereas using this flag requires each Intent that launches the Activity to specify it.
5603     *
5604     * <p>Note that the default semantics of this flag w.r.t. whether the recents entry for
5605     * it is kept after the activity is finished is different than the use of
5606     * {@link #FLAG_ACTIVITY_NEW_TASK} and {@link android.R.attr#documentLaunchMode} -- if
5607     * this flag is being used to create a new recents entry, then by default that entry
5608     * will be removed once the activity is finished.  You can modify this behavior with
5609     * {@link #FLAG_ACTIVITY_RETAIN_IN_RECENTS}.
5610     *
5611     * <p>FLAG_ACTIVITY_NEW_DOCUMENT may be used in conjunction with {@link
5612     * #FLAG_ACTIVITY_MULTIPLE_TASK}. When used alone it is the
5613     * equivalent of the Activity manifest specifying {@link
5614     * android.R.attr#documentLaunchMode}="intoExisting". When used with
5615     * FLAG_ACTIVITY_MULTIPLE_TASK it is the equivalent of the Activity manifest specifying
5616     * {@link android.R.attr#documentLaunchMode}="always".
5617     *
5618     * Refer to {@link android.R.attr#documentLaunchMode} for more information.
5619     *
5620     * @see android.R.attr#documentLaunchMode
5621     * @see #FLAG_ACTIVITY_MULTIPLE_TASK
5622     */
5623    public static final int FLAG_ACTIVITY_NEW_DOCUMENT = FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET;
5624    /**
5625     * If set, this flag will prevent the normal {@link android.app.Activity#onUserLeaveHint}
5626     * callback from occurring on the current frontmost activity before it is
5627     * paused as the newly-started activity is brought to the front.
5628     *
5629     * <p>Typically, an activity can rely on that callback to indicate that an
5630     * explicit user action has caused their activity to be moved out of the
5631     * foreground. The callback marks an appropriate point in the activity's
5632     * lifecycle for it to dismiss any notifications that it intends to display
5633     * "until the user has seen them," such as a blinking LED.
5634     *
5635     * <p>If an activity is ever started via any non-user-driven events such as
5636     * phone-call receipt or an alarm handler, this flag should be passed to {@link
5637     * Context#startActivity Context.startActivity}, ensuring that the pausing
5638     * activity does not think the user has acknowledged its notification.
5639     */
5640    public static final int FLAG_ACTIVITY_NO_USER_ACTION = 0x00040000;
5641    /**
5642     * If set in an Intent passed to {@link Context#startActivity Context.startActivity()},
5643     * this flag will cause the launched activity to be brought to the front of its
5644     * task's history stack if it is already running.
5645     *
5646     * <p>For example, consider a task consisting of four activities: A, B, C, D.
5647     * If D calls startActivity() with an Intent that resolves to the component
5648     * of activity B, then B will be brought to the front of the history stack,
5649     * with this resulting order:  A, C, D, B.
5650     *
5651     * This flag will be ignored if {@link #FLAG_ACTIVITY_CLEAR_TOP} is also
5652     * specified.
5653     */
5654    public static final int FLAG_ACTIVITY_REORDER_TO_FRONT = 0X00020000;
5655    /**
5656     * If set in an Intent passed to {@link Context#startActivity Context.startActivity()},
5657     * this flag will prevent the system from applying an activity transition
5658     * animation to go to the next activity state.  This doesn't mean an
5659     * animation will never run -- if another activity change happens that doesn't
5660     * specify this flag before the activity started here is displayed, then
5661     * that transition will be used.  This flag can be put to good use
5662     * when you are going to do a series of activity operations but the
5663     * animation seen by the user shouldn't be driven by the first activity
5664     * change but rather a later one.
5665     */
5666    public static final int FLAG_ACTIVITY_NO_ANIMATION = 0X00010000;
5667    /**
5668     * If set in an Intent passed to {@link Context#startActivity Context.startActivity()},
5669     * this flag will cause any existing task that would be associated with the
5670     * activity to be cleared before the activity is started.  That is, the activity
5671     * becomes the new root of an otherwise empty task, and any old activities
5672     * are finished.  This can only be used in conjunction with {@link #FLAG_ACTIVITY_NEW_TASK}.
5673     */
5674    public static final int FLAG_ACTIVITY_CLEAR_TASK = 0X00008000;
5675    /**
5676     * If set in an Intent passed to {@link Context#startActivity Context.startActivity()},
5677     * this flag will cause a newly launching task to be placed on top of the current
5678     * home activity task (if there is one).  That is, pressing back from the task
5679     * will always return the user to home even if that was not the last activity they
5680     * saw.   This can only be used in conjunction with {@link #FLAG_ACTIVITY_NEW_TASK}.
5681     */
5682    public static final int FLAG_ACTIVITY_TASK_ON_HOME = 0X00004000;
5683    /**
5684     * By default a document created by {@link #FLAG_ACTIVITY_NEW_DOCUMENT} will
5685     * have its entry in recent tasks removed when the user closes it (with back
5686     * or however else it may finish()). If you would like to instead allow the
5687     * document to be kept in recents so that it can be re-launched, you can use
5688     * this flag. When set and the task's activity is finished, the recents
5689     * entry will remain in the interface for the user to re-launch it, like a
5690     * recents entry for a top-level application.
5691     * <p>
5692     * The receiving activity can override this request with
5693     * {@link android.R.attr#autoRemoveFromRecents} or by explcitly calling
5694     * {@link android.app.Activity#finishAndRemoveTask()
5695     * Activity.finishAndRemoveTask()}.
5696     */
5697    public static final int FLAG_ACTIVITY_RETAIN_IN_RECENTS = 0x00002000;
5698
5699    /**
5700     * This flag is only used in split-screen multi-window mode. The new activity will be displayed
5701     * adjacent to the one launching it. This can only be used in conjunction with
5702     * {@link #FLAG_ACTIVITY_NEW_TASK}. Also, setting {@link #FLAG_ACTIVITY_MULTIPLE_TASK} is
5703     * required if you want a new instance of an existing activity to be created.
5704     */
5705    public static final int FLAG_ACTIVITY_LAUNCH_ADJACENT = 0x00001000;
5706
5707
5708    /**
5709     * If set in an Intent passed to {@link Context#startActivity Context.startActivity()},
5710     * this flag will attempt to launch an instant app if no full app on the device can already
5711     * handle the intent.
5712     * <p>
5713     * When attempting to resolve instant apps externally, the following {@link Intent} properties
5714     * are supported:
5715     * <ul>
5716     *     <li>{@link Intent#setAction(String)}</li>
5717     *     <li>{@link Intent#addCategory(String)}</li>
5718     *     <li>{@link Intent#setData(Uri)}</li>
5719     *     <li>{@link Intent#setType(String)}</li>
5720     *     <li>{@link Intent#setPackage(String)}</li>
5721     *     <li>{@link Intent#addFlags(int)}</li>
5722     * </ul>
5723     * <p>
5724     * In the case that no instant app can be found, the installer will be launched to notify the
5725     * user that the intent could not be resolved. On devices that do not support instant apps,
5726     * the flag will be ignored.
5727     */
5728    public static final int FLAG_ACTIVITY_MATCH_EXTERNAL = 0x00000800;
5729
5730    /**
5731     * If set, when sending a broadcast only registered receivers will be
5732     * called -- no BroadcastReceiver components will be launched.
5733     */
5734    public static final int FLAG_RECEIVER_REGISTERED_ONLY = 0x40000000;
5735    /**
5736     * If set, when sending a broadcast the new broadcast will replace
5737     * any existing pending broadcast that matches it.  Matching is defined
5738     * by {@link Intent#filterEquals(Intent) Intent.filterEquals} returning
5739     * true for the intents of the two broadcasts.  When a match is found,
5740     * the new broadcast (and receivers associated with it) will replace the
5741     * existing one in the pending broadcast list, remaining at the same
5742     * position in the list.
5743     *
5744     * <p>This flag is most typically used with sticky broadcasts, which
5745     * only care about delivering the most recent values of the broadcast
5746     * to their receivers.
5747     */
5748    public static final int FLAG_RECEIVER_REPLACE_PENDING = 0x20000000;
5749    /**
5750     * If set, when sending a broadcast the recipient is allowed to run at
5751     * foreground priority, with a shorter timeout interval.  During normal
5752     * broadcasts the receivers are not automatically hoisted out of the
5753     * background priority class.
5754     */
5755    public static final int FLAG_RECEIVER_FOREGROUND = 0x10000000;
5756    /**
5757     * If this is an ordered broadcast, don't allow receivers to abort the broadcast.
5758     * They can still propagate results through to later receivers, but they can not prevent
5759     * later receivers from seeing the broadcast.
5760     */
5761    public static final int FLAG_RECEIVER_NO_ABORT = 0x08000000;
5762    /**
5763     * If set, when sending a broadcast <i>before boot has completed</i> only
5764     * registered receivers will be called -- no BroadcastReceiver components
5765     * will be launched.  Sticky intent state will be recorded properly even
5766     * if no receivers wind up being called.  If {@link #FLAG_RECEIVER_REGISTERED_ONLY}
5767     * is specified in the broadcast intent, this flag is unnecessary.
5768     *
5769     * <p>This flag is only for use by system sevices as a convenience to
5770     * avoid having to implement a more complex mechanism around detection
5771     * of boot completion.
5772     *
5773     * @hide
5774     */
5775    public static final int FLAG_RECEIVER_REGISTERED_ONLY_BEFORE_BOOT = 0x04000000;
5776    /**
5777     * Set when this broadcast is for a boot upgrade, a special mode that
5778     * allows the broadcast to be sent before the system is ready and launches
5779     * the app process with no providers running in it.
5780     * @hide
5781     */
5782    public static final int FLAG_RECEIVER_BOOT_UPGRADE = 0x02000000;
5783    /**
5784     * If set, the broadcast will always go to manifest receivers in background (cached
5785     * or not running) apps, regardless of whether that would be done by default.  By
5786     * default they will only receive broadcasts if the broadcast has specified an
5787     * explicit component or package name.
5788     *
5789     * NOTE: dumpstate uses this flag numerically, so when its value is changed
5790     * the broadcast code there must also be changed to match.
5791     *
5792     * @hide
5793     */
5794    public static final int FLAG_RECEIVER_INCLUDE_BACKGROUND = 0x01000000;
5795    /**
5796     * If set, the broadcast will never go to manifest receivers in background (cached
5797     * or not running) apps, regardless of whether that would be done by default.  By
5798     * default they will receive broadcasts if the broadcast has specified an
5799     * explicit component or package name.
5800     * @hide
5801     */
5802    public static final int FLAG_RECEIVER_EXCLUDE_BACKGROUND = 0x00800000;
5803    /**
5804     * If set, this broadcast is being sent from the shell.
5805     * @hide
5806     */
5807    public static final int FLAG_RECEIVER_FROM_SHELL = 0x00400000;
5808
5809    /**
5810     * If set, the broadcast will be visible to receivers in Instant Apps. By default Instant Apps
5811     * will not receive broadcasts.
5812     *
5813     * <em>This flag has no effect when used by an Instant App.</em>
5814     */
5815    public static final int FLAG_RECEIVER_VISIBLE_TO_INSTANT_APPS = 0x00200000;
5816
5817    /**
5818     * @hide Flags that can't be changed with PendingIntent.
5819     */
5820    public static final int IMMUTABLE_FLAGS = FLAG_GRANT_READ_URI_PERMISSION
5821            | FLAG_GRANT_WRITE_URI_PERMISSION | FLAG_GRANT_PERSISTABLE_URI_PERMISSION
5822            | FLAG_GRANT_PREFIX_URI_PERMISSION;
5823
5824    // ---------------------------------------------------------------------
5825    // ---------------------------------------------------------------------
5826    // toUri() and parseUri() options.
5827
5828    /** @hide */
5829    @IntDef(flag = true, prefix = { "URI_" }, value = {
5830            URI_ALLOW_UNSAFE,
5831            URI_ANDROID_APP_SCHEME,
5832            URI_INTENT_SCHEME,
5833    })
5834    @Retention(RetentionPolicy.SOURCE)
5835    public @interface UriFlags {}
5836
5837    /**
5838     * Flag for use with {@link #toUri} and {@link #parseUri}: the URI string
5839     * always has the "intent:" scheme.  This syntax can be used when you want
5840     * to later disambiguate between URIs that are intended to describe an
5841     * Intent vs. all others that should be treated as raw URIs.  When used
5842     * with {@link #parseUri}, any other scheme will result in a generic
5843     * VIEW action for that raw URI.
5844     */
5845    public static final int URI_INTENT_SCHEME = 1<<0;
5846
5847    /**
5848     * Flag for use with {@link #toUri} and {@link #parseUri}: the URI string
5849     * always has the "android-app:" scheme.  This is a variation of
5850     * {@link #URI_INTENT_SCHEME} whose format is simpler for the case of an
5851     * http/https URI being delivered to a specific package name.  The format
5852     * is:
5853     *
5854     * <pre class="prettyprint">
5855     * android-app://{package_id}[/{scheme}[/{host}[/{path}]]][#Intent;{...}]</pre>
5856     *
5857     * <p>In this scheme, only the <code>package_id</code> is required.  If you include a host,
5858     * you must also include a scheme; including a path also requires both a host and a scheme.
5859     * The final #Intent; fragment can be used without a scheme, host, or path.
5860     * Note that this can not be
5861     * used with intents that have a {@link #setSelector}, since the base intent
5862     * will always have an explicit package name.</p>
5863     *
5864     * <p>Some examples of how this scheme maps to Intent objects:</p>
5865     * <table border="2" width="85%" align="center" frame="hsides" rules="rows">
5866     *     <colgroup align="left" />
5867     *     <colgroup align="left" />
5868     *     <thead>
5869     *     <tr><th>URI</th> <th>Intent</th></tr>
5870     *     </thead>
5871     *
5872     *     <tbody>
5873     *     <tr><td><code>android-app://com.example.app</code></td>
5874     *         <td><table style="margin:0;border:0;cellpadding:0;cellspacing:0">
5875     *             <tr><td>Action: </td><td>{@link #ACTION_MAIN}</td></tr>
5876     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5877     *         </table></td>
5878     *     </tr>
5879     *     <tr><td><code>android-app://com.example.app/http/example.com</code></td>
5880     *         <td><table style="margin:0;border:0;cellpadding:0;cellspacing:0">
5881     *             <tr><td>Action: </td><td>{@link #ACTION_VIEW}</td></tr>
5882     *             <tr><td>Data: </td><td><code>http://example.com/</code></td></tr>
5883     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5884     *         </table></td>
5885     *     </tr>
5886     *     <tr><td><code>android-app://com.example.app/http/example.com/foo?1234</code></td>
5887     *         <td><table style="margin:0;border:0;cellpadding:0;cellspacing:0">
5888     *             <tr><td>Action: </td><td>{@link #ACTION_VIEW}</td></tr>
5889     *             <tr><td>Data: </td><td><code>http://example.com/foo?1234</code></td></tr>
5890     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5891     *         </table></td>
5892     *     </tr>
5893     *     <tr><td><code>android-app://com.example.app/<br />#Intent;action=com.example.MY_ACTION;end</code></td>
5894     *         <td><table style="margin:0;border:0;cellpadding:0;cellspacing:0">
5895     *             <tr><td>Action: </td><td><code>com.example.MY_ACTION</code></td></tr>
5896     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5897     *         </table></td>
5898     *     </tr>
5899     *     <tr><td><code>android-app://com.example.app/http/example.com/foo?1234<br />#Intent;action=com.example.MY_ACTION;end</code></td>
5900     *         <td><table style="margin:0;border:0;cellpadding:0;cellspacing:0">
5901     *             <tr><td>Action: </td><td><code>com.example.MY_ACTION</code></td></tr>
5902     *             <tr><td>Data: </td><td><code>http://example.com/foo?1234</code></td></tr>
5903     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5904     *         </table></td>
5905     *     </tr>
5906     *     <tr><td><code>android-app://com.example.app/<br />#Intent;action=com.example.MY_ACTION;<br />i.some_int=100;S.some_str=hello;end</code></td>
5907     *         <td><table border="" style="margin:0" >
5908     *             <tr><td>Action: </td><td><code>com.example.MY_ACTION</code></td></tr>
5909     *             <tr><td>Package: </td><td><code>com.example.app</code></td></tr>
5910     *             <tr><td>Extras: </td><td><code>some_int=(int)100<br />some_str=(String)hello</code></td></tr>
5911     *         </table></td>
5912     *     </tr>
5913     *     </tbody>
5914     * </table>
5915     */
5916    public static final int URI_ANDROID_APP_SCHEME = 1<<1;
5917
5918    /**
5919     * Flag for use with {@link #toUri} and {@link #parseUri}: allow parsing
5920     * of unsafe information.  In particular, the flags {@link #FLAG_GRANT_READ_URI_PERMISSION},
5921     * {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, {@link #FLAG_GRANT_PERSISTABLE_URI_PERMISSION},
5922     * and {@link #FLAG_GRANT_PREFIX_URI_PERMISSION} flags can not be set, so that the
5923     * generated Intent can not cause unexpected data access to happen.
5924     *
5925     * <p>If you do not trust the source of the URI being parsed, you should still do further
5926     * processing to protect yourself from it.  In particular, when using it to start an
5927     * activity you should usually add in {@link #CATEGORY_BROWSABLE} to limit the activities
5928     * that can handle it.</p>
5929     */
5930    public static final int URI_ALLOW_UNSAFE = 1<<2;
5931
5932    // ---------------------------------------------------------------------
5933
5934    private String mAction;
5935    private Uri mData;
5936    private String mType;
5937    private String mPackage;
5938    private ComponentName mComponent;
5939    private int mFlags;
5940    private ArraySet<String> mCategories;
5941    private Bundle mExtras;
5942    private Rect mSourceBounds;
5943    private Intent mSelector;
5944    private ClipData mClipData;
5945    private int mContentUserHint = UserHandle.USER_CURRENT;
5946    /** Token to track instant app launches. Local only; do not copy cross-process. */
5947    private String mLaunchToken;
5948
5949    // ---------------------------------------------------------------------
5950
5951    private static final int COPY_MODE_ALL = 0;
5952    private static final int COPY_MODE_FILTER = 1;
5953    private static final int COPY_MODE_HISTORY = 2;
5954
5955    /** @hide */
5956    @IntDef(prefix = { "COPY_MODE_" }, value = {
5957            COPY_MODE_ALL,
5958            COPY_MODE_FILTER,
5959            COPY_MODE_HISTORY
5960    })
5961    @Retention(RetentionPolicy.SOURCE)
5962    public @interface CopyMode {}
5963
5964    /**
5965     * Create an empty intent.
5966     */
5967    public Intent() {
5968    }
5969
5970    /**
5971     * Copy constructor.
5972     */
5973    public Intent(Intent o) {
5974        this(o, COPY_MODE_ALL);
5975    }
5976
5977    private Intent(Intent o, @CopyMode int copyMode) {
5978        this.mAction = o.mAction;
5979        this.mData = o.mData;
5980        this.mType = o.mType;
5981        this.mPackage = o.mPackage;
5982        this.mComponent = o.mComponent;
5983
5984        if (o.mCategories != null) {
5985            this.mCategories = new ArraySet<>(o.mCategories);
5986        }
5987
5988        if (copyMode != COPY_MODE_FILTER) {
5989            this.mFlags = o.mFlags;
5990            this.mContentUserHint = o.mContentUserHint;
5991            this.mLaunchToken = o.mLaunchToken;
5992            if (o.mSourceBounds != null) {
5993                this.mSourceBounds = new Rect(o.mSourceBounds);
5994            }
5995            if (o.mSelector != null) {
5996                this.mSelector = new Intent(o.mSelector);
5997            }
5998
5999            if (copyMode != COPY_MODE_HISTORY) {
6000                if (o.mExtras != null) {
6001                    this.mExtras = new Bundle(o.mExtras);
6002                }
6003                if (o.mClipData != null) {
6004                    this.mClipData = new ClipData(o.mClipData);
6005                }
6006            } else {
6007                if (o.mExtras != null && !o.mExtras.maybeIsEmpty()) {
6008                    this.mExtras = Bundle.STRIPPED;
6009                }
6010
6011                // Also set "stripped" clip data when we ever log mClipData in the (broadcast)
6012                // history.
6013            }
6014        }
6015    }
6016
6017    @Override
6018    public Object clone() {
6019        return new Intent(this);
6020    }
6021
6022    /**
6023     * Make a clone of only the parts of the Intent that are relevant for
6024     * filter matching: the action, data, type, component, and categories.
6025     */
6026    public @NonNull Intent cloneFilter() {
6027        return new Intent(this, COPY_MODE_FILTER);
6028    }
6029
6030    /**
6031     * Create an intent with a given action.  All other fields (data, type,
6032     * class) are null.  Note that the action <em>must</em> be in a
6033     * namespace because Intents are used globally in the system -- for
6034     * example the system VIEW action is android.intent.action.VIEW; an
6035     * application's custom action would be something like
6036     * com.google.app.myapp.CUSTOM_ACTION.
6037     *
6038     * @param action The Intent action, such as ACTION_VIEW.
6039     */
6040    public Intent(String action) {
6041        setAction(action);
6042    }
6043
6044    /**
6045     * Create an intent with a given action and for a given data url.  Note
6046     * that the action <em>must</em> be in a namespace because Intents are
6047     * used globally in the system -- for example the system VIEW action is
6048     * android.intent.action.VIEW; an application's custom action would be
6049     * something like com.google.app.myapp.CUSTOM_ACTION.
6050     *
6051     * <p><em>Note: scheme and host name matching in the Android framework is
6052     * case-sensitive, unlike the formal RFC.  As a result,
6053     * you should always ensure that you write your Uri with these elements
6054     * using lower case letters, and normalize any Uris you receive from
6055     * outside of Android to ensure the scheme and host is lower case.</em></p>
6056     *
6057     * @param action The Intent action, such as ACTION_VIEW.
6058     * @param uri The Intent data URI.
6059     */
6060    public Intent(String action, Uri uri) {
6061        setAction(action);
6062        mData = uri;
6063    }
6064
6065    /**
6066     * Create an intent for a specific component.  All other fields (action, data,
6067     * type, class) are null, though they can be modified later with explicit
6068     * calls.  This provides a convenient way to create an intent that is
6069     * intended to execute a hard-coded class name, rather than relying on the
6070     * system to find an appropriate class for you; see {@link #setComponent}
6071     * for more information on the repercussions of this.
6072     *
6073     * @param packageContext A Context of the application package implementing
6074     * this class.
6075     * @param cls The component class that is to be used for the intent.
6076     *
6077     * @see #setClass
6078     * @see #setComponent
6079     * @see #Intent(String, android.net.Uri , Context, Class)
6080     */
6081    public Intent(Context packageContext, Class<?> cls) {
6082        mComponent = new ComponentName(packageContext, cls);
6083    }
6084
6085    /**
6086     * Create an intent for a specific component with a specified action and data.
6087     * This is equivalent to using {@link #Intent(String, android.net.Uri)} to
6088     * construct the Intent and then calling {@link #setClass} to set its
6089     * class.
6090     *
6091     * <p><em>Note: scheme and host name matching in the Android framework is
6092     * case-sensitive, unlike the formal RFC.  As a result,
6093     * you should always ensure that you write your Uri with these elements
6094     * using lower case letters, and normalize any Uris you receive from
6095     * outside of Android to ensure the scheme and host is lower case.</em></p>
6096     *
6097     * @param action The Intent action, such as ACTION_VIEW.
6098     * @param uri The Intent data URI.
6099     * @param packageContext A Context of the application package implementing
6100     * this class.
6101     * @param cls The component class that is to be used for the intent.
6102     *
6103     * @see #Intent(String, android.net.Uri)
6104     * @see #Intent(Context, Class)
6105     * @see #setClass
6106     * @see #setComponent
6107     */
6108    public Intent(String action, Uri uri,
6109            Context packageContext, Class<?> cls) {
6110        setAction(action);
6111        mData = uri;
6112        mComponent = new ComponentName(packageContext, cls);
6113    }
6114
6115    /**
6116     * Create an intent to launch the main (root) activity of a task.  This
6117     * is the Intent that is started when the application's is launched from
6118     * Home.  For anything else that wants to launch an application in the
6119     * same way, it is important that they use an Intent structured the same
6120     * way, and can use this function to ensure this is the case.
6121     *
6122     * <p>The returned Intent has the given Activity component as its explicit
6123     * component, {@link #ACTION_MAIN} as its action, and includes the
6124     * category {@link #CATEGORY_LAUNCHER}.  This does <em>not</em> have
6125     * {@link #FLAG_ACTIVITY_NEW_TASK} set, though typically you will want
6126     * to do that through {@link #addFlags(int)} on the returned Intent.
6127     *
6128     * @param mainActivity The main activity component that this Intent will
6129     * launch.
6130     * @return Returns a newly created Intent that can be used to launch the
6131     * activity as a main application entry.
6132     *
6133     * @see #setClass
6134     * @see #setComponent
6135     */
6136    public static Intent makeMainActivity(ComponentName mainActivity) {
6137        Intent intent = new Intent(ACTION_MAIN);
6138        intent.setComponent(mainActivity);
6139        intent.addCategory(CATEGORY_LAUNCHER);
6140        return intent;
6141    }
6142
6143    /**
6144     * Make an Intent for the main activity of an application, without
6145     * specifying a specific activity to run but giving a selector to find
6146     * the activity.  This results in a final Intent that is structured
6147     * the same as when the application is launched from
6148     * Home.  For anything else that wants to launch an application in the
6149     * same way, it is important that they use an Intent structured the same
6150     * way, and can use this function to ensure this is the case.
6151     *
6152     * <p>The returned Intent has {@link #ACTION_MAIN} as its action, and includes the
6153     * category {@link #CATEGORY_LAUNCHER}.  This does <em>not</em> have
6154     * {@link #FLAG_ACTIVITY_NEW_TASK} set, though typically you will want
6155     * to do that through {@link #addFlags(int)} on the returned Intent.
6156     *
6157     * @param selectorAction The action name of the Intent's selector.
6158     * @param selectorCategory The name of a category to add to the Intent's
6159     * selector.
6160     * @return Returns a newly created Intent that can be used to launch the
6161     * activity as a main application entry.
6162     *
6163     * @see #setSelector(Intent)
6164     */
6165    public static Intent makeMainSelectorActivity(String selectorAction,
6166            String selectorCategory) {
6167        Intent intent = new Intent(ACTION_MAIN);
6168        intent.addCategory(CATEGORY_LAUNCHER);
6169        Intent selector = new Intent();
6170        selector.setAction(selectorAction);
6171        selector.addCategory(selectorCategory);
6172        intent.setSelector(selector);
6173        return intent;
6174    }
6175
6176    /**
6177     * Make an Intent that can be used to re-launch an application's task
6178     * in its base state.  This is like {@link #makeMainActivity(ComponentName)},
6179     * but also sets the flags {@link #FLAG_ACTIVITY_NEW_TASK} and
6180     * {@link #FLAG_ACTIVITY_CLEAR_TASK}.
6181     *
6182     * @param mainActivity The activity component that is the root of the
6183     * task; this is the activity that has been published in the application's
6184     * manifest as the main launcher icon.
6185     *
6186     * @return Returns a newly created Intent that can be used to relaunch the
6187     * activity's task in its root state.
6188     */
6189    public static Intent makeRestartActivityTask(ComponentName mainActivity) {
6190        Intent intent = makeMainActivity(mainActivity);
6191        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
6192                | Intent.FLAG_ACTIVITY_CLEAR_TASK);
6193        return intent;
6194    }
6195
6196    /**
6197     * Call {@link #parseUri} with 0 flags.
6198     * @deprecated Use {@link #parseUri} instead.
6199     */
6200    @Deprecated
6201    public static Intent getIntent(String uri) throws URISyntaxException {
6202        return parseUri(uri, 0);
6203    }
6204
6205    /**
6206     * Create an intent from a URI.  This URI may encode the action,
6207     * category, and other intent fields, if it was returned by
6208     * {@link #toUri}.  If the Intent was not generate by toUri(), its data
6209     * will be the entire URI and its action will be ACTION_VIEW.
6210     *
6211     * <p>The URI given here must not be relative -- that is, it must include
6212     * the scheme and full path.
6213     *
6214     * @param uri The URI to turn into an Intent.
6215     * @param flags Additional processing flags.
6216     *
6217     * @return Intent The newly created Intent object.
6218     *
6219     * @throws URISyntaxException Throws URISyntaxError if the basic URI syntax
6220     * it bad (as parsed by the Uri class) or the Intent data within the
6221     * URI is invalid.
6222     *
6223     * @see #toUri
6224     */
6225    public static Intent parseUri(String uri, @UriFlags int flags) throws URISyntaxException {
6226        int i = 0;
6227        try {
6228            final boolean androidApp = uri.startsWith("android-app:");
6229
6230            // Validate intent scheme if requested.
6231            if ((flags&(URI_INTENT_SCHEME|URI_ANDROID_APP_SCHEME)) != 0) {
6232                if (!uri.startsWith("intent:") && !androidApp) {
6233                    Intent intent = new Intent(ACTION_VIEW);
6234                    try {
6235                        intent.setData(Uri.parse(uri));
6236                    } catch (IllegalArgumentException e) {
6237                        throw new URISyntaxException(uri, e.getMessage());
6238                    }
6239                    return intent;
6240                }
6241            }
6242
6243            i = uri.lastIndexOf("#");
6244            // simple case
6245            if (i == -1) {
6246                if (!androidApp) {
6247                    return new Intent(ACTION_VIEW, Uri.parse(uri));
6248                }
6249
6250            // old format Intent URI
6251            } else if (!uri.startsWith("#Intent;", i)) {
6252                if (!androidApp) {
6253                    return getIntentOld(uri, flags);
6254                } else {
6255                    i = -1;
6256                }
6257            }
6258
6259            // new format
6260            Intent intent = new Intent(ACTION_VIEW);
6261            Intent baseIntent = intent;
6262            boolean explicitAction = false;
6263            boolean inSelector = false;
6264
6265            // fetch data part, if present
6266            String scheme = null;
6267            String data;
6268            if (i >= 0) {
6269                data = uri.substring(0, i);
6270                i += 8; // length of "#Intent;"
6271            } else {
6272                data = uri;
6273            }
6274
6275            // loop over contents of Intent, all name=value;
6276            while (i >= 0 && !uri.startsWith("end", i)) {
6277                int eq = uri.indexOf('=', i);
6278                if (eq < 0) eq = i-1;
6279                int semi = uri.indexOf(';', i);
6280                String value = eq < semi ? Uri.decode(uri.substring(eq + 1, semi)) : "";
6281
6282                // action
6283                if (uri.startsWith("action=", i)) {
6284                    intent.setAction(value);
6285                    if (!inSelector) {
6286                        explicitAction = true;
6287                    }
6288                }
6289
6290                // categories
6291                else if (uri.startsWith("category=", i)) {
6292                    intent.addCategory(value);
6293                }
6294
6295                // type
6296                else if (uri.startsWith("type=", i)) {
6297                    intent.mType = value;
6298                }
6299
6300                // launch flags
6301                else if (uri.startsWith("launchFlags=", i)) {
6302                    intent.mFlags = Integer.decode(value).intValue();
6303                    if ((flags& URI_ALLOW_UNSAFE) == 0) {
6304                        intent.mFlags &= ~IMMUTABLE_FLAGS;
6305                    }
6306                }
6307
6308                // package
6309                else if (uri.startsWith("package=", i)) {
6310                    intent.mPackage = value;
6311                }
6312
6313                // component
6314                else if (uri.startsWith("component=", i)) {
6315                    intent.mComponent = ComponentName.unflattenFromString(value);
6316                }
6317
6318                // scheme
6319                else if (uri.startsWith("scheme=", i)) {
6320                    if (inSelector) {
6321                        intent.mData = Uri.parse(value + ":");
6322                    } else {
6323                        scheme = value;
6324                    }
6325                }
6326
6327                // source bounds
6328                else if (uri.startsWith("sourceBounds=", i)) {
6329                    intent.mSourceBounds = Rect.unflattenFromString(value);
6330                }
6331
6332                // selector
6333                else if (semi == (i+3) && uri.startsWith("SEL", i)) {
6334                    intent = new Intent();
6335                    inSelector = true;
6336                }
6337
6338                // extra
6339                else {
6340                    String key = Uri.decode(uri.substring(i + 2, eq));
6341                    // create Bundle if it doesn't already exist
6342                    if (intent.mExtras == null) intent.mExtras = new Bundle();
6343                    Bundle b = intent.mExtras;
6344                    // add EXTRA
6345                    if      (uri.startsWith("S.", i)) b.putString(key, value);
6346                    else if (uri.startsWith("B.", i)) b.putBoolean(key, Boolean.parseBoolean(value));
6347                    else if (uri.startsWith("b.", i)) b.putByte(key, Byte.parseByte(value));
6348                    else if (uri.startsWith("c.", i)) b.putChar(key, value.charAt(0));
6349                    else if (uri.startsWith("d.", i)) b.putDouble(key, Double.parseDouble(value));
6350                    else if (uri.startsWith("f.", i)) b.putFloat(key, Float.parseFloat(value));
6351                    else if (uri.startsWith("i.", i)) b.putInt(key, Integer.parseInt(value));
6352                    else if (uri.startsWith("l.", i)) b.putLong(key, Long.parseLong(value));
6353                    else if (uri.startsWith("s.", i)) b.putShort(key, Short.parseShort(value));
6354                    else throw new URISyntaxException(uri, "unknown EXTRA type", i);
6355                }
6356
6357                // move to the next item
6358                i = semi + 1;
6359            }
6360
6361            if (inSelector) {
6362                // The Intent had a selector; fix it up.
6363                if (baseIntent.mPackage == null) {
6364                    baseIntent.setSelector(intent);
6365                }
6366                intent = baseIntent;
6367            }
6368
6369            if (data != null) {
6370                if (data.startsWith("intent:")) {
6371                    data = data.substring(7);
6372                    if (scheme != null) {
6373                        data = scheme + ':' + data;
6374                    }
6375                } else if (data.startsWith("android-app:")) {
6376                    if (data.charAt(12) == '/' && data.charAt(13) == '/') {
6377                        // Correctly formed android-app, first part is package name.
6378                        int end = data.indexOf('/', 14);
6379                        if (end < 0) {
6380                            // All we have is a package name.
6381                            intent.mPackage = data.substring(14);
6382                            if (!explicitAction) {
6383                                intent.setAction(ACTION_MAIN);
6384                            }
6385                            data = "";
6386                        } else {
6387                            // Target the Intent at the given package name always.
6388                            String authority = null;
6389                            intent.mPackage = data.substring(14, end);
6390                            int newEnd;
6391                            if ((end+1) < data.length()) {
6392                                if ((newEnd=data.indexOf('/', end+1)) >= 0) {
6393                                    // Found a scheme, remember it.
6394                                    scheme = data.substring(end+1, newEnd);
6395                                    end = newEnd;
6396                                    if (end < data.length() && (newEnd=data.indexOf('/', end+1)) >= 0) {
6397                                        // Found a authority, remember it.
6398                                        authority = data.substring(end+1, newEnd);
6399                                        end = newEnd;
6400                                    }
6401                                } else {
6402                                    // All we have is a scheme.
6403                                    scheme = data.substring(end+1);
6404                                }
6405                            }
6406                            if (scheme == null) {
6407                                // If there was no scheme, then this just targets the package.
6408                                if (!explicitAction) {
6409                                    intent.setAction(ACTION_MAIN);
6410                                }
6411                                data = "";
6412                            } else if (authority == null) {
6413                                data = scheme + ":";
6414                            } else {
6415                                data = scheme + "://" + authority + data.substring(end);
6416                            }
6417                        }
6418                    } else {
6419                        data = "";
6420                    }
6421                }
6422
6423                if (data.length() > 0) {
6424                    try {
6425                        intent.mData = Uri.parse(data);
6426                    } catch (IllegalArgumentException e) {
6427                        throw new URISyntaxException(uri, e.getMessage());
6428                    }
6429                }
6430            }
6431
6432            return intent;
6433
6434        } catch (IndexOutOfBoundsException e) {
6435            throw new URISyntaxException(uri, "illegal Intent URI format", i);
6436        }
6437    }
6438
6439    public static Intent getIntentOld(String uri) throws URISyntaxException {
6440        return getIntentOld(uri, 0);
6441    }
6442
6443    private static Intent getIntentOld(String uri, int flags) throws URISyntaxException {
6444        Intent intent;
6445
6446        int i = uri.lastIndexOf('#');
6447        if (i >= 0) {
6448            String action = null;
6449            final int intentFragmentStart = i;
6450            boolean isIntentFragment = false;
6451
6452            i++;
6453
6454            if (uri.regionMatches(i, "action(", 0, 7)) {
6455                isIntentFragment = true;
6456                i += 7;
6457                int j = uri.indexOf(')', i);
6458                action = uri.substring(i, j);
6459                i = j + 1;
6460            }
6461
6462            intent = new Intent(action);
6463
6464            if (uri.regionMatches(i, "categories(", 0, 11)) {
6465                isIntentFragment = true;
6466                i += 11;
6467                int j = uri.indexOf(')', i);
6468                while (i < j) {
6469                    int sep = uri.indexOf('!', i);
6470                    if (sep < 0 || sep > j) sep = j;
6471                    if (i < sep) {
6472                        intent.addCategory(uri.substring(i, sep));
6473                    }
6474                    i = sep + 1;
6475                }
6476                i = j + 1;
6477            }
6478
6479            if (uri.regionMatches(i, "type(", 0, 5)) {
6480                isIntentFragment = true;
6481                i += 5;
6482                int j = uri.indexOf(')', i);
6483                intent.mType = uri.substring(i, j);
6484                i = j + 1;
6485            }
6486
6487            if (uri.regionMatches(i, "launchFlags(", 0, 12)) {
6488                isIntentFragment = true;
6489                i += 12;
6490                int j = uri.indexOf(')', i);
6491                intent.mFlags = Integer.decode(uri.substring(i, j)).intValue();
6492                if ((flags& URI_ALLOW_UNSAFE) == 0) {
6493                    intent.mFlags &= ~IMMUTABLE_FLAGS;
6494                }
6495                i = j + 1;
6496            }
6497
6498            if (uri.regionMatches(i, "component(", 0, 10)) {
6499                isIntentFragment = true;
6500                i += 10;
6501                int j = uri.indexOf(')', i);
6502                int sep = uri.indexOf('!', i);
6503                if (sep >= 0 && sep < j) {
6504                    String pkg = uri.substring(i, sep);
6505                    String cls = uri.substring(sep + 1, j);
6506                    intent.mComponent = new ComponentName(pkg, cls);
6507                }
6508                i = j + 1;
6509            }
6510
6511            if (uri.regionMatches(i, "extras(", 0, 7)) {
6512                isIntentFragment = true;
6513                i += 7;
6514
6515                final int closeParen = uri.indexOf(')', i);
6516                if (closeParen == -1) throw new URISyntaxException(uri,
6517                        "EXTRA missing trailing ')'", i);
6518
6519                while (i < closeParen) {
6520                    // fetch the key value
6521                    int j = uri.indexOf('=', i);
6522                    if (j <= i + 1 || i >= closeParen) {
6523                        throw new URISyntaxException(uri, "EXTRA missing '='", i);
6524                    }
6525                    char type = uri.charAt(i);
6526                    i++;
6527                    String key = uri.substring(i, j);
6528                    i = j + 1;
6529
6530                    // get type-value
6531                    j = uri.indexOf('!', i);
6532                    if (j == -1 || j >= closeParen) j = closeParen;
6533                    if (i >= j) throw new URISyntaxException(uri, "EXTRA missing '!'", i);
6534                    String value = uri.substring(i, j);
6535                    i = j;
6536
6537                    // create Bundle if it doesn't already exist
6538                    if (intent.mExtras == null) intent.mExtras = new Bundle();
6539
6540                    // add item to bundle
6541                    try {
6542                        switch (type) {
6543                            case 'S':
6544                                intent.mExtras.putString(key, Uri.decode(value));
6545                                break;
6546                            case 'B':
6547                                intent.mExtras.putBoolean(key, Boolean.parseBoolean(value));
6548                                break;
6549                            case 'b':
6550                                intent.mExtras.putByte(key, Byte.parseByte(value));
6551                                break;
6552                            case 'c':
6553                                intent.mExtras.putChar(key, Uri.decode(value).charAt(0));
6554                                break;
6555                            case 'd':
6556                                intent.mExtras.putDouble(key, Double.parseDouble(value));
6557                                break;
6558                            case 'f':
6559                                intent.mExtras.putFloat(key, Float.parseFloat(value));
6560                                break;
6561                            case 'i':
6562                                intent.mExtras.putInt(key, Integer.parseInt(value));
6563                                break;
6564                            case 'l':
6565                                intent.mExtras.putLong(key, Long.parseLong(value));
6566                                break;
6567                            case 's':
6568                                intent.mExtras.putShort(key, Short.parseShort(value));
6569                                break;
6570                            default:
6571                                throw new URISyntaxException(uri, "EXTRA has unknown type", i);
6572                        }
6573                    } catch (NumberFormatException e) {
6574                        throw new URISyntaxException(uri, "EXTRA value can't be parsed", i);
6575                    }
6576
6577                    char ch = uri.charAt(i);
6578                    if (ch == ')') break;
6579                    if (ch != '!') throw new URISyntaxException(uri, "EXTRA missing '!'", i);
6580                    i++;
6581                }
6582            }
6583
6584            if (isIntentFragment) {
6585                intent.mData = Uri.parse(uri.substring(0, intentFragmentStart));
6586            } else {
6587                intent.mData = Uri.parse(uri);
6588            }
6589
6590            if (intent.mAction == null) {
6591                // By default, if no action is specified, then use VIEW.
6592                intent.mAction = ACTION_VIEW;
6593            }
6594
6595        } else {
6596            intent = new Intent(ACTION_VIEW, Uri.parse(uri));
6597        }
6598
6599        return intent;
6600    }
6601
6602    /** @hide */
6603    public interface CommandOptionHandler {
6604        boolean handleOption(String opt, ShellCommand cmd);
6605    }
6606
6607    /** @hide */
6608    public static Intent parseCommandArgs(ShellCommand cmd, CommandOptionHandler optionHandler)
6609            throws URISyntaxException {
6610        Intent intent = new Intent();
6611        Intent baseIntent = intent;
6612        boolean hasIntentInfo = false;
6613
6614        Uri data = null;
6615        String type = null;
6616
6617        String opt;
6618        while ((opt=cmd.getNextOption()) != null) {
6619            switch (opt) {
6620                case "-a":
6621                    intent.setAction(cmd.getNextArgRequired());
6622                    if (intent == baseIntent) {
6623                        hasIntentInfo = true;
6624                    }
6625                    break;
6626                case "-d":
6627                    data = Uri.parse(cmd.getNextArgRequired());
6628                    if (intent == baseIntent) {
6629                        hasIntentInfo = true;
6630                    }
6631                    break;
6632                case "-t":
6633                    type = cmd.getNextArgRequired();
6634                    if (intent == baseIntent) {
6635                        hasIntentInfo = true;
6636                    }
6637                    break;
6638                case "-c":
6639                    intent.addCategory(cmd.getNextArgRequired());
6640                    if (intent == baseIntent) {
6641                        hasIntentInfo = true;
6642                    }
6643                    break;
6644                case "-e":
6645                case "--es": {
6646                    String key = cmd.getNextArgRequired();
6647                    String value = cmd.getNextArgRequired();
6648                    intent.putExtra(key, value);
6649                }
6650                break;
6651                case "--esn": {
6652                    String key = cmd.getNextArgRequired();
6653                    intent.putExtra(key, (String) null);
6654                }
6655                break;
6656                case "--ei": {
6657                    String key = cmd.getNextArgRequired();
6658                    String value = cmd.getNextArgRequired();
6659                    intent.putExtra(key, Integer.decode(value));
6660                }
6661                break;
6662                case "--eu": {
6663                    String key = cmd.getNextArgRequired();
6664                    String value = cmd.getNextArgRequired();
6665                    intent.putExtra(key, Uri.parse(value));
6666                }
6667                break;
6668                case "--ecn": {
6669                    String key = cmd.getNextArgRequired();
6670                    String value = cmd.getNextArgRequired();
6671                    ComponentName cn = ComponentName.unflattenFromString(value);
6672                    if (cn == null)
6673                        throw new IllegalArgumentException("Bad component name: " + value);
6674                    intent.putExtra(key, cn);
6675                }
6676                break;
6677                case "--eia": {
6678                    String key = cmd.getNextArgRequired();
6679                    String value = cmd.getNextArgRequired();
6680                    String[] strings = value.split(",");
6681                    int[] list = new int[strings.length];
6682                    for (int i = 0; i < strings.length; i++) {
6683                        list[i] = Integer.decode(strings[i]);
6684                    }
6685                    intent.putExtra(key, list);
6686                }
6687                break;
6688                case "--eial": {
6689                    String key = cmd.getNextArgRequired();
6690                    String value = cmd.getNextArgRequired();
6691                    String[] strings = value.split(",");
6692                    ArrayList<Integer> list = new ArrayList<>(strings.length);
6693                    for (int i = 0; i < strings.length; i++) {
6694                        list.add(Integer.decode(strings[i]));
6695                    }
6696                    intent.putExtra(key, list);
6697                }
6698                break;
6699                case "--el": {
6700                    String key = cmd.getNextArgRequired();
6701                    String value = cmd.getNextArgRequired();
6702                    intent.putExtra(key, Long.valueOf(value));
6703                }
6704                break;
6705                case "--ela": {
6706                    String key = cmd.getNextArgRequired();
6707                    String value = cmd.getNextArgRequired();
6708                    String[] strings = value.split(",");
6709                    long[] list = new long[strings.length];
6710                    for (int i = 0; i < strings.length; i++) {
6711                        list[i] = Long.valueOf(strings[i]);
6712                    }
6713                    intent.putExtra(key, list);
6714                    hasIntentInfo = true;
6715                }
6716                break;
6717                case "--elal": {
6718                    String key = cmd.getNextArgRequired();
6719                    String value = cmd.getNextArgRequired();
6720                    String[] strings = value.split(",");
6721                    ArrayList<Long> list = new ArrayList<>(strings.length);
6722                    for (int i = 0; i < strings.length; i++) {
6723                        list.add(Long.valueOf(strings[i]));
6724                    }
6725                    intent.putExtra(key, list);
6726                    hasIntentInfo = true;
6727                }
6728                break;
6729                case "--ef": {
6730                    String key = cmd.getNextArgRequired();
6731                    String value = cmd.getNextArgRequired();
6732                    intent.putExtra(key, Float.valueOf(value));
6733                    hasIntentInfo = true;
6734                }
6735                break;
6736                case "--efa": {
6737                    String key = cmd.getNextArgRequired();
6738                    String value = cmd.getNextArgRequired();
6739                    String[] strings = value.split(",");
6740                    float[] list = new float[strings.length];
6741                    for (int i = 0; i < strings.length; i++) {
6742                        list[i] = Float.valueOf(strings[i]);
6743                    }
6744                    intent.putExtra(key, list);
6745                    hasIntentInfo = true;
6746                }
6747                break;
6748                case "--efal": {
6749                    String key = cmd.getNextArgRequired();
6750                    String value = cmd.getNextArgRequired();
6751                    String[] strings = value.split(",");
6752                    ArrayList<Float> list = new ArrayList<>(strings.length);
6753                    for (int i = 0; i < strings.length; i++) {
6754                        list.add(Float.valueOf(strings[i]));
6755                    }
6756                    intent.putExtra(key, list);
6757                    hasIntentInfo = true;
6758                }
6759                break;
6760                case "--esa": {
6761                    String key = cmd.getNextArgRequired();
6762                    String value = cmd.getNextArgRequired();
6763                    // Split on commas unless they are preceeded by an escape.
6764                    // The escape character must be escaped for the string and
6765                    // again for the regex, thus four escape characters become one.
6766                    String[] strings = value.split("(?<!\\\\),");
6767                    intent.putExtra(key, strings);
6768                    hasIntentInfo = true;
6769                }
6770                break;
6771                case "--esal": {
6772                    String key = cmd.getNextArgRequired();
6773                    String value = cmd.getNextArgRequired();
6774                    // Split on commas unless they are preceeded by an escape.
6775                    // The escape character must be escaped for the string and
6776                    // again for the regex, thus four escape characters become one.
6777                    String[] strings = value.split("(?<!\\\\),");
6778                    ArrayList<String> list = new ArrayList<>(strings.length);
6779                    for (int i = 0; i < strings.length; i++) {
6780                        list.add(strings[i]);
6781                    }
6782                    intent.putExtra(key, list);
6783                    hasIntentInfo = true;
6784                }
6785                break;
6786                case "--ez": {
6787                    String key = cmd.getNextArgRequired();
6788                    String value = cmd.getNextArgRequired().toLowerCase();
6789                    // Boolean.valueOf() results in false for anything that is not "true", which is
6790                    // error-prone in shell commands
6791                    boolean arg;
6792                    if ("true".equals(value) || "t".equals(value)) {
6793                        arg = true;
6794                    } else if ("false".equals(value) || "f".equals(value)) {
6795                        arg = false;
6796                    } else {
6797                        try {
6798                            arg = Integer.decode(value) != 0;
6799                        } catch (NumberFormatException ex) {
6800                            throw new IllegalArgumentException("Invalid boolean value: " + value);
6801                        }
6802                    }
6803
6804                    intent.putExtra(key, arg);
6805                }
6806                break;
6807                case "-n": {
6808                    String str = cmd.getNextArgRequired();
6809                    ComponentName cn = ComponentName.unflattenFromString(str);
6810                    if (cn == null)
6811                        throw new IllegalArgumentException("Bad component name: " + str);
6812                    intent.setComponent(cn);
6813                    if (intent == baseIntent) {
6814                        hasIntentInfo = true;
6815                    }
6816                }
6817                break;
6818                case "-p": {
6819                    String str = cmd.getNextArgRequired();
6820                    intent.setPackage(str);
6821                    if (intent == baseIntent) {
6822                        hasIntentInfo = true;
6823                    }
6824                }
6825                break;
6826                case "-f":
6827                    String str = cmd.getNextArgRequired();
6828                    intent.setFlags(Integer.decode(str).intValue());
6829                    break;
6830                case "--grant-read-uri-permission":
6831                    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
6832                    break;
6833                case "--grant-write-uri-permission":
6834                    intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
6835                    break;
6836                case "--grant-persistable-uri-permission":
6837                    intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
6838                    break;
6839                case "--grant-prefix-uri-permission":
6840                    intent.addFlags(Intent.FLAG_GRANT_PREFIX_URI_PERMISSION);
6841                    break;
6842                case "--exclude-stopped-packages":
6843                    intent.addFlags(Intent.FLAG_EXCLUDE_STOPPED_PACKAGES);
6844                    break;
6845                case "--include-stopped-packages":
6846                    intent.addFlags(Intent.FLAG_INCLUDE_STOPPED_PACKAGES);
6847                    break;
6848                case "--debug-log-resolution":
6849                    intent.addFlags(Intent.FLAG_DEBUG_LOG_RESOLUTION);
6850                    break;
6851                case "--activity-brought-to-front":
6852                    intent.addFlags(Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT);
6853                    break;
6854                case "--activity-clear-top":
6855                    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
6856                    break;
6857                case "--activity-clear-when-task-reset":
6858                    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET);
6859                    break;
6860                case "--activity-exclude-from-recents":
6861                    intent.addFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS);
6862                    break;
6863                case "--activity-launched-from-history":
6864                    intent.addFlags(Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY);
6865                    break;
6866                case "--activity-multiple-task":
6867                    intent.addFlags(Intent.FLAG_ACTIVITY_MULTIPLE_TASK);
6868                    break;
6869                case "--activity-no-animation":
6870                    intent.addFlags(Intent.FLAG_ACTIVITY_NO_ANIMATION);
6871                    break;
6872                case "--activity-no-history":
6873                    intent.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY);
6874                    break;
6875                case "--activity-no-user-action":
6876                    intent.addFlags(Intent.FLAG_ACTIVITY_NO_USER_ACTION);
6877                    break;
6878                case "--activity-previous-is-top":
6879                    intent.addFlags(Intent.FLAG_ACTIVITY_PREVIOUS_IS_TOP);
6880                    break;
6881                case "--activity-reorder-to-front":
6882                    intent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
6883                    break;
6884                case "--activity-reset-task-if-needed":
6885                    intent.addFlags(Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
6886                    break;
6887                case "--activity-single-top":
6888                    intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
6889                    break;
6890                case "--activity-clear-task":
6891                    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK);
6892                    break;
6893                case "--activity-task-on-home":
6894                    intent.addFlags(Intent.FLAG_ACTIVITY_TASK_ON_HOME);
6895                    break;
6896                case "--activity-match-external":
6897                    intent.addFlags(Intent.FLAG_ACTIVITY_MATCH_EXTERNAL);
6898                    break;
6899                case "--receiver-registered-only":
6900                    intent.addFlags(Intent.FLAG_RECEIVER_REGISTERED_ONLY);
6901                    break;
6902                case "--receiver-replace-pending":
6903                    intent.addFlags(Intent.FLAG_RECEIVER_REPLACE_PENDING);
6904                    break;
6905                case "--receiver-foreground":
6906                    intent.addFlags(Intent.FLAG_RECEIVER_FOREGROUND);
6907                    break;
6908                case "--receiver-no-abort":
6909                    intent.addFlags(Intent.FLAG_RECEIVER_NO_ABORT);
6910                    break;
6911                case "--receiver-include-background":
6912                    intent.addFlags(Intent.FLAG_RECEIVER_INCLUDE_BACKGROUND);
6913                    break;
6914                case "--selector":
6915                    intent.setDataAndType(data, type);
6916                    intent = new Intent();
6917                    break;
6918                default:
6919                    if (optionHandler != null && optionHandler.handleOption(opt, cmd)) {
6920                        // Okay, caller handled this option.
6921                    } else {
6922                        throw new IllegalArgumentException("Unknown option: " + opt);
6923                    }
6924                    break;
6925            }
6926        }
6927        intent.setDataAndType(data, type);
6928
6929        final boolean hasSelector = intent != baseIntent;
6930        if (hasSelector) {
6931            // A selector was specified; fix up.
6932            baseIntent.setSelector(intent);
6933            intent = baseIntent;
6934        }
6935
6936        String arg = cmd.getNextArg();
6937        baseIntent = null;
6938        if (arg == null) {
6939            if (hasSelector) {
6940                // If a selector has been specified, and no arguments
6941                // have been supplied for the main Intent, then we can
6942                // assume it is ACTION_MAIN CATEGORY_LAUNCHER; we don't
6943                // need to have a component name specified yet, the
6944                // selector will take care of that.
6945                baseIntent = new Intent(Intent.ACTION_MAIN);
6946                baseIntent.addCategory(Intent.CATEGORY_LAUNCHER);
6947            }
6948        } else if (arg.indexOf(':') >= 0) {
6949            // The argument is a URI.  Fully parse it, and use that result
6950            // to fill in any data not specified so far.
6951            baseIntent = Intent.parseUri(arg, Intent.URI_INTENT_SCHEME
6952                    | Intent.URI_ANDROID_APP_SCHEME | Intent.URI_ALLOW_UNSAFE);
6953        } else if (arg.indexOf('/') >= 0) {
6954            // The argument is a component name.  Build an Intent to launch
6955            // it.
6956            baseIntent = new Intent(Intent.ACTION_MAIN);
6957            baseIntent.addCategory(Intent.CATEGORY_LAUNCHER);
6958            baseIntent.setComponent(ComponentName.unflattenFromString(arg));
6959        } else {
6960            // Assume the argument is a package name.
6961            baseIntent = new Intent(Intent.ACTION_MAIN);
6962            baseIntent.addCategory(Intent.CATEGORY_LAUNCHER);
6963            baseIntent.setPackage(arg);
6964        }
6965        if (baseIntent != null) {
6966            Bundle extras = intent.getExtras();
6967            intent.replaceExtras((Bundle)null);
6968            Bundle uriExtras = baseIntent.getExtras();
6969            baseIntent.replaceExtras((Bundle)null);
6970            if (intent.getAction() != null && baseIntent.getCategories() != null) {
6971                HashSet<String> cats = new HashSet<String>(baseIntent.getCategories());
6972                for (String c : cats) {
6973                    baseIntent.removeCategory(c);
6974                }
6975            }
6976            intent.fillIn(baseIntent, Intent.FILL_IN_COMPONENT | Intent.FILL_IN_SELECTOR);
6977            if (extras == null) {
6978                extras = uriExtras;
6979            } else if (uriExtras != null) {
6980                uriExtras.putAll(extras);
6981                extras = uriExtras;
6982            }
6983            intent.replaceExtras(extras);
6984            hasIntentInfo = true;
6985        }
6986
6987        if (!hasIntentInfo) throw new IllegalArgumentException("No intent supplied");
6988        return intent;
6989    }
6990
6991    /** @hide */
6992    public static void printIntentArgsHelp(PrintWriter pw, String prefix) {
6993        final String[] lines = new String[] {
6994                "<INTENT> specifications include these flags and arguments:",
6995                "    [-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]",
6996                "    [-c <CATEGORY> [-c <CATEGORY>] ...]",
6997                "    [-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]",
6998                "    [--esn <EXTRA_KEY> ...]",
6999                "    [--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]",
7000                "    [--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]",
7001                "    [--el <EXTRA_KEY> <EXTRA_LONG_VALUE> ...]",
7002                "    [--ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE> ...]",
7003                "    [--eu <EXTRA_KEY> <EXTRA_URI_VALUE> ...]",
7004                "    [--ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE>]",
7005                "    [--eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]]",
7006                "        (mutiple extras passed as Integer[])",
7007                "    [--eial <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]]",
7008                "        (mutiple extras passed as List<Integer>)",
7009                "    [--ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]]",
7010                "        (mutiple extras passed as Long[])",
7011                "    [--elal <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]]",
7012                "        (mutiple extras passed as List<Long>)",
7013                "    [--efa <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE...]]",
7014                "        (mutiple extras passed as Float[])",
7015                "    [--efal <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE...]]",
7016                "        (mutiple extras passed as List<Float>)",
7017                "    [--esa <EXTRA_KEY> <EXTRA_STRING_VALUE>[,<EXTRA_STRING_VALUE...]]",
7018                "        (mutiple extras passed as String[]; to embed a comma into a string,",
7019                "         escape it using \"\\,\")",
7020                "    [--esal <EXTRA_KEY> <EXTRA_STRING_VALUE>[,<EXTRA_STRING_VALUE...]]",
7021                "        (mutiple extras passed as List<String>; to embed a comma into a string,",
7022                "         escape it using \"\\,\")",
7023                "    [-f <FLAG>]",
7024                "    [--grant-read-uri-permission] [--grant-write-uri-permission]",
7025                "    [--grant-persistable-uri-permission] [--grant-prefix-uri-permission]",
7026                "    [--debug-log-resolution] [--exclude-stopped-packages]",
7027                "    [--include-stopped-packages]",
7028                "    [--activity-brought-to-front] [--activity-clear-top]",
7029                "    [--activity-clear-when-task-reset] [--activity-exclude-from-recents]",
7030                "    [--activity-launched-from-history] [--activity-multiple-task]",
7031                "    [--activity-no-animation] [--activity-no-history]",
7032                "    [--activity-no-user-action] [--activity-previous-is-top]",
7033                "    [--activity-reorder-to-front] [--activity-reset-task-if-needed]",
7034                "    [--activity-single-top] [--activity-clear-task]",
7035                "    [--activity-task-on-home] [--activity-match-external]",
7036                "    [--receiver-registered-only] [--receiver-replace-pending]",
7037                "    [--receiver-foreground] [--receiver-no-abort]",
7038                "    [--receiver-include-background]",
7039                "    [--selector]",
7040                "    [<URI> | <PACKAGE> | <COMPONENT>]"
7041        };
7042        for (String line : lines) {
7043            pw.print(prefix);
7044            pw.println(line);
7045        }
7046    }
7047
7048    /**
7049     * Retrieve the general action to be performed, such as
7050     * {@link #ACTION_VIEW}.  The action describes the general way the rest of
7051     * the information in the intent should be interpreted -- most importantly,
7052     * what to do with the data returned by {@link #getData}.
7053     *
7054     * @return The action of this intent or null if none is specified.
7055     *
7056     * @see #setAction
7057     */
7058    public @Nullable String getAction() {
7059        return mAction;
7060    }
7061
7062    /**
7063     * Retrieve data this intent is operating on.  This URI specifies the name
7064     * of the data; often it uses the content: scheme, specifying data in a
7065     * content provider.  Other schemes may be handled by specific activities,
7066     * such as http: by the web browser.
7067     *
7068     * @return The URI of the data this intent is targeting or null.
7069     *
7070     * @see #getScheme
7071     * @see #setData
7072     */
7073    public @Nullable Uri getData() {
7074        return mData;
7075    }
7076
7077    /**
7078     * The same as {@link #getData()}, but returns the URI as an encoded
7079     * String.
7080     */
7081    public @Nullable String getDataString() {
7082        return mData != null ? mData.toString() : null;
7083    }
7084
7085    /**
7086     * Return the scheme portion of the intent's data.  If the data is null or
7087     * does not include a scheme, null is returned.  Otherwise, the scheme
7088     * prefix without the final ':' is returned, i.e. "http".
7089     *
7090     * <p>This is the same as calling getData().getScheme() (and checking for
7091     * null data).
7092     *
7093     * @return The scheme of this intent.
7094     *
7095     * @see #getData
7096     */
7097    public @Nullable String getScheme() {
7098        return mData != null ? mData.getScheme() : null;
7099    }
7100
7101    /**
7102     * Retrieve any explicit MIME type included in the intent.  This is usually
7103     * null, as the type is determined by the intent data.
7104     *
7105     * @return If a type was manually set, it is returned; else null is
7106     *         returned.
7107     *
7108     * @see #resolveType(ContentResolver)
7109     * @see #setType
7110     */
7111    public @Nullable String getType() {
7112        return mType;
7113    }
7114
7115    /**
7116     * Return the MIME data type of this intent.  If the type field is
7117     * explicitly set, that is simply returned.  Otherwise, if the data is set,
7118     * the type of that data is returned.  If neither fields are set, a null is
7119     * returned.
7120     *
7121     * @return The MIME type of this intent.
7122     *
7123     * @see #getType
7124     * @see #resolveType(ContentResolver)
7125     */
7126    public @Nullable String resolveType(@NonNull Context context) {
7127        return resolveType(context.getContentResolver());
7128    }
7129
7130    /**
7131     * Return the MIME data type of this intent.  If the type field is
7132     * explicitly set, that is simply returned.  Otherwise, if the data is set,
7133     * the type of that data is returned.  If neither fields are set, a null is
7134     * returned.
7135     *
7136     * @param resolver A ContentResolver that can be used to determine the MIME
7137     *                 type of the intent's data.
7138     *
7139     * @return The MIME type of this intent.
7140     *
7141     * @see #getType
7142     * @see #resolveType(Context)
7143     */
7144    public @Nullable String resolveType(@NonNull ContentResolver resolver) {
7145        if (mType != null) {
7146            return mType;
7147        }
7148        if (mData != null) {
7149            if ("content".equals(mData.getScheme())) {
7150                return resolver.getType(mData);
7151            }
7152        }
7153        return null;
7154    }
7155
7156    /**
7157     * Return the MIME data type of this intent, only if it will be needed for
7158     * intent resolution.  This is not generally useful for application code;
7159     * it is used by the frameworks for communicating with back-end system
7160     * services.
7161     *
7162     * @param resolver A ContentResolver that can be used to determine the MIME
7163     *                 type of the intent's data.
7164     *
7165     * @return The MIME type of this intent, or null if it is unknown or not
7166     *         needed.
7167     */
7168    public @Nullable String resolveTypeIfNeeded(@NonNull ContentResolver resolver) {
7169        if (mComponent != null) {
7170            return mType;
7171        }
7172        return resolveType(resolver);
7173    }
7174
7175    /**
7176     * Check if a category exists in the intent.
7177     *
7178     * @param category The category to check.
7179     *
7180     * @return boolean True if the intent contains the category, else false.
7181     *
7182     * @see #getCategories
7183     * @see #addCategory
7184     */
7185    public boolean hasCategory(String category) {
7186        return mCategories != null && mCategories.contains(category);
7187    }
7188
7189    /**
7190     * Return the set of all categories in the intent.  If there are no categories,
7191     * returns NULL.
7192     *
7193     * @return The set of categories you can examine.  Do not modify!
7194     *
7195     * @see #hasCategory
7196     * @see #addCategory
7197     */
7198    public Set<String> getCategories() {
7199        return mCategories;
7200    }
7201
7202    /**
7203     * Return the specific selector associated with this Intent.  If there is
7204     * none, returns null.  See {@link #setSelector} for more information.
7205     *
7206     * @see #setSelector
7207     */
7208    public @Nullable Intent getSelector() {
7209        return mSelector;
7210    }
7211
7212    /**
7213     * Return the {@link ClipData} associated with this Intent.  If there is
7214     * none, returns null.  See {@link #setClipData} for more information.
7215     *
7216     * @see #setClipData
7217     */
7218    public @Nullable ClipData getClipData() {
7219        return mClipData;
7220    }
7221
7222    /** @hide */
7223    public int getContentUserHint() {
7224        return mContentUserHint;
7225    }
7226
7227    /** @hide */
7228    public String getLaunchToken() {
7229        return mLaunchToken;
7230    }
7231
7232    /** @hide */
7233    public void setLaunchToken(String launchToken) {
7234        mLaunchToken = launchToken;
7235    }
7236
7237    /**
7238     * Sets the ClassLoader that will be used when unmarshalling
7239     * any Parcelable values from the extras of this Intent.
7240     *
7241     * @param loader a ClassLoader, or null to use the default loader
7242     * at the time of unmarshalling.
7243     */
7244    public void setExtrasClassLoader(@Nullable ClassLoader loader) {
7245        if (mExtras != null) {
7246            mExtras.setClassLoader(loader);
7247        }
7248    }
7249
7250    /**
7251     * Returns true if an extra value is associated with the given name.
7252     * @param name the extra's name
7253     * @return true if the given extra is present.
7254     */
7255    public boolean hasExtra(String name) {
7256        return mExtras != null && mExtras.containsKey(name);
7257    }
7258
7259    /**
7260     * Returns true if the Intent's extras contain a parcelled file descriptor.
7261     * @return true if the Intent contains a parcelled file descriptor.
7262     */
7263    public boolean hasFileDescriptors() {
7264        return mExtras != null && mExtras.hasFileDescriptors();
7265    }
7266
7267    /** {@hide} */
7268    public void setAllowFds(boolean allowFds) {
7269        if (mExtras != null) {
7270            mExtras.setAllowFds(allowFds);
7271        }
7272    }
7273
7274    /** {@hide} */
7275    public void setDefusable(boolean defusable) {
7276        if (mExtras != null) {
7277            mExtras.setDefusable(defusable);
7278        }
7279    }
7280
7281    /**
7282     * Retrieve extended data from the intent.
7283     *
7284     * @param name The name of the desired item.
7285     *
7286     * @return the value of an item previously added with putExtra(),
7287     * or null if none was found.
7288     *
7289     * @deprecated
7290     * @hide
7291     */
7292    @Deprecated
7293    public Object getExtra(String name) {
7294        return getExtra(name, null);
7295    }
7296
7297    /**
7298     * Retrieve extended data from the intent.
7299     *
7300     * @param name The name of the desired item.
7301     * @param defaultValue the value to be returned if no value of the desired
7302     * type is stored with the given name.
7303     *
7304     * @return the value of an item previously added with putExtra(),
7305     * or the default value if none was found.
7306     *
7307     * @see #putExtra(String, boolean)
7308     */
7309    public boolean getBooleanExtra(String name, boolean defaultValue) {
7310        return mExtras == null ? defaultValue :
7311            mExtras.getBoolean(name, defaultValue);
7312    }
7313
7314    /**
7315     * Retrieve extended data from the intent.
7316     *
7317     * @param name The name of the desired item.
7318     * @param defaultValue the value to be returned if no value of the desired
7319     * type is stored with the given name.
7320     *
7321     * @return the value of an item previously added with putExtra(),
7322     * or the default value if none was found.
7323     *
7324     * @see #putExtra(String, byte)
7325     */
7326    public byte getByteExtra(String name, byte defaultValue) {
7327        return mExtras == null ? defaultValue :
7328            mExtras.getByte(name, defaultValue);
7329    }
7330
7331    /**
7332     * Retrieve extended data from the intent.
7333     *
7334     * @param name The name of the desired item.
7335     * @param defaultValue the value to be returned if no value of the desired
7336     * type is stored with the given name.
7337     *
7338     * @return the value of an item previously added with putExtra(),
7339     * or the default value if none was found.
7340     *
7341     * @see #putExtra(String, short)
7342     */
7343    public short getShortExtra(String name, short defaultValue) {
7344        return mExtras == null ? defaultValue :
7345            mExtras.getShort(name, defaultValue);
7346    }
7347
7348    /**
7349     * Retrieve extended data from the intent.
7350     *
7351     * @param name The name of the desired item.
7352     * @param defaultValue the value to be returned if no value of the desired
7353     * type is stored with the given name.
7354     *
7355     * @return the value of an item previously added with putExtra(),
7356     * or the default value if none was found.
7357     *
7358     * @see #putExtra(String, char)
7359     */
7360    public char getCharExtra(String name, char defaultValue) {
7361        return mExtras == null ? defaultValue :
7362            mExtras.getChar(name, defaultValue);
7363    }
7364
7365    /**
7366     * Retrieve extended data from the intent.
7367     *
7368     * @param name The name of the desired item.
7369     * @param defaultValue the value to be returned if no value of the desired
7370     * type is stored with the given name.
7371     *
7372     * @return the value of an item previously added with putExtra(),
7373     * or the default value if none was found.
7374     *
7375     * @see #putExtra(String, int)
7376     */
7377    public int getIntExtra(String name, int defaultValue) {
7378        return mExtras == null ? defaultValue :
7379            mExtras.getInt(name, defaultValue);
7380    }
7381
7382    /**
7383     * Retrieve extended data from the intent.
7384     *
7385     * @param name The name of the desired item.
7386     * @param defaultValue the value to be returned if no value of the desired
7387     * type is stored with the given name.
7388     *
7389     * @return the value of an item previously added with putExtra(),
7390     * or the default value if none was found.
7391     *
7392     * @see #putExtra(String, long)
7393     */
7394    public long getLongExtra(String name, long defaultValue) {
7395        return mExtras == null ? defaultValue :
7396            mExtras.getLong(name, defaultValue);
7397    }
7398
7399    /**
7400     * Retrieve extended data from the intent.
7401     *
7402     * @param name The name of the desired item.
7403     * @param defaultValue the value to be returned if no value of the desired
7404     * type is stored with the given name.
7405     *
7406     * @return the value of an item previously added with putExtra(),
7407     * or the default value if no such item is present
7408     *
7409     * @see #putExtra(String, float)
7410     */
7411    public float getFloatExtra(String name, float defaultValue) {
7412        return mExtras == null ? defaultValue :
7413            mExtras.getFloat(name, defaultValue);
7414    }
7415
7416    /**
7417     * Retrieve extended data from the intent.
7418     *
7419     * @param name The name of the desired item.
7420     * @param defaultValue the value to be returned if no value of the desired
7421     * type is stored with the given name.
7422     *
7423     * @return the value of an item previously added with putExtra(),
7424     * or the default value if none was found.
7425     *
7426     * @see #putExtra(String, double)
7427     */
7428    public double getDoubleExtra(String name, double defaultValue) {
7429        return mExtras == null ? defaultValue :
7430            mExtras.getDouble(name, defaultValue);
7431    }
7432
7433    /**
7434     * Retrieve extended data from the intent.
7435     *
7436     * @param name The name of the desired item.
7437     *
7438     * @return the value of an item previously added with putExtra(),
7439     * or null if no String value was found.
7440     *
7441     * @see #putExtra(String, String)
7442     */
7443    public String getStringExtra(String name) {
7444        return mExtras == null ? null : mExtras.getString(name);
7445    }
7446
7447    /**
7448     * Retrieve extended data from the intent.
7449     *
7450     * @param name The name of the desired item.
7451     *
7452     * @return the value of an item previously added with putExtra(),
7453     * or null if no CharSequence value was found.
7454     *
7455     * @see #putExtra(String, CharSequence)
7456     */
7457    public CharSequence getCharSequenceExtra(String name) {
7458        return mExtras == null ? null : mExtras.getCharSequence(name);
7459    }
7460
7461    /**
7462     * Retrieve extended data from the intent.
7463     *
7464     * @param name The name of the desired item.
7465     *
7466     * @return the value of an item previously added with putExtra(),
7467     * or null if no Parcelable value was found.
7468     *
7469     * @see #putExtra(String, Parcelable)
7470     */
7471    public <T extends Parcelable> T getParcelableExtra(String name) {
7472        return mExtras == null ? null : mExtras.<T>getParcelable(name);
7473    }
7474
7475    /**
7476     * Retrieve extended data from the intent.
7477     *
7478     * @param name The name of the desired item.
7479     *
7480     * @return the value of an item previously added with putExtra(),
7481     * or null if no Parcelable[] value was found.
7482     *
7483     * @see #putExtra(String, Parcelable[])
7484     */
7485    public Parcelable[] getParcelableArrayExtra(String name) {
7486        return mExtras == null ? null : mExtras.getParcelableArray(name);
7487    }
7488
7489    /**
7490     * Retrieve extended data from the intent.
7491     *
7492     * @param name The name of the desired item.
7493     *
7494     * @return the value of an item previously added with
7495     * putParcelableArrayListExtra(), or null if no
7496     * ArrayList<Parcelable> value was found.
7497     *
7498     * @see #putParcelableArrayListExtra(String, ArrayList)
7499     */
7500    public <T extends Parcelable> ArrayList<T> getParcelableArrayListExtra(String name) {
7501        return mExtras == null ? null : mExtras.<T>getParcelableArrayList(name);
7502    }
7503
7504    /**
7505     * Retrieve extended data from the intent.
7506     *
7507     * @param name The name of the desired item.
7508     *
7509     * @return the value of an item previously added with putExtra(),
7510     * or null if no Serializable value was found.
7511     *
7512     * @see #putExtra(String, Serializable)
7513     */
7514    public Serializable getSerializableExtra(String name) {
7515        return mExtras == null ? null : mExtras.getSerializable(name);
7516    }
7517
7518    /**
7519     * Retrieve extended data from the intent.
7520     *
7521     * @param name The name of the desired item.
7522     *
7523     * @return the value of an item previously added with
7524     * putIntegerArrayListExtra(), or null if no
7525     * ArrayList<Integer> value was found.
7526     *
7527     * @see #putIntegerArrayListExtra(String, ArrayList)
7528     */
7529    public ArrayList<Integer> getIntegerArrayListExtra(String name) {
7530        return mExtras == null ? null : mExtras.getIntegerArrayList(name);
7531    }
7532
7533    /**
7534     * Retrieve extended data from the intent.
7535     *
7536     * @param name The name of the desired item.
7537     *
7538     * @return the value of an item previously added with
7539     * putStringArrayListExtra(), or null if no
7540     * ArrayList<String> value was found.
7541     *
7542     * @see #putStringArrayListExtra(String, ArrayList)
7543     */
7544    public ArrayList<String> getStringArrayListExtra(String name) {
7545        return mExtras == null ? null : mExtras.getStringArrayList(name);
7546    }
7547
7548    /**
7549     * Retrieve extended data from the intent.
7550     *
7551     * @param name The name of the desired item.
7552     *
7553     * @return the value of an item previously added with
7554     * putCharSequenceArrayListExtra, or null if no
7555     * ArrayList<CharSequence> value was found.
7556     *
7557     * @see #putCharSequenceArrayListExtra(String, ArrayList)
7558     */
7559    public ArrayList<CharSequence> getCharSequenceArrayListExtra(String name) {
7560        return mExtras == null ? null : mExtras.getCharSequenceArrayList(name);
7561    }
7562
7563    /**
7564     * Retrieve extended data from the intent.
7565     *
7566     * @param name The name of the desired item.
7567     *
7568     * @return the value of an item previously added with putExtra(),
7569     * or null if no boolean array value was found.
7570     *
7571     * @see #putExtra(String, boolean[])
7572     */
7573    public boolean[] getBooleanArrayExtra(String name) {
7574        return mExtras == null ? null : mExtras.getBooleanArray(name);
7575    }
7576
7577    /**
7578     * Retrieve extended data from the intent.
7579     *
7580     * @param name The name of the desired item.
7581     *
7582     * @return the value of an item previously added with putExtra(),
7583     * or null if no byte array value was found.
7584     *
7585     * @see #putExtra(String, byte[])
7586     */
7587    public byte[] getByteArrayExtra(String name) {
7588        return mExtras == null ? null : mExtras.getByteArray(name);
7589    }
7590
7591    /**
7592     * Retrieve extended data from the intent.
7593     *
7594     * @param name The name of the desired item.
7595     *
7596     * @return the value of an item previously added with putExtra(),
7597     * or null if no short array value was found.
7598     *
7599     * @see #putExtra(String, short[])
7600     */
7601    public short[] getShortArrayExtra(String name) {
7602        return mExtras == null ? null : mExtras.getShortArray(name);
7603    }
7604
7605    /**
7606     * Retrieve extended data from the intent.
7607     *
7608     * @param name The name of the desired item.
7609     *
7610     * @return the value of an item previously added with putExtra(),
7611     * or null if no char array value was found.
7612     *
7613     * @see #putExtra(String, char[])
7614     */
7615    public char[] getCharArrayExtra(String name) {
7616        return mExtras == null ? null : mExtras.getCharArray(name);
7617    }
7618
7619    /**
7620     * Retrieve extended data from the intent.
7621     *
7622     * @param name The name of the desired item.
7623     *
7624     * @return the value of an item previously added with putExtra(),
7625     * or null if no int array value was found.
7626     *
7627     * @see #putExtra(String, int[])
7628     */
7629    public int[] getIntArrayExtra(String name) {
7630        return mExtras == null ? null : mExtras.getIntArray(name);
7631    }
7632
7633    /**
7634     * Retrieve extended data from the intent.
7635     *
7636     * @param name The name of the desired item.
7637     *
7638     * @return the value of an item previously added with putExtra(),
7639     * or null if no long array value was found.
7640     *
7641     * @see #putExtra(String, long[])
7642     */
7643    public long[] getLongArrayExtra(String name) {
7644        return mExtras == null ? null : mExtras.getLongArray(name);
7645    }
7646
7647    /**
7648     * Retrieve extended data from the intent.
7649     *
7650     * @param name The name of the desired item.
7651     *
7652     * @return the value of an item previously added with putExtra(),
7653     * or null if no float array value was found.
7654     *
7655     * @see #putExtra(String, float[])
7656     */
7657    public float[] getFloatArrayExtra(String name) {
7658        return mExtras == null ? null : mExtras.getFloatArray(name);
7659    }
7660
7661    /**
7662     * Retrieve extended data from the intent.
7663     *
7664     * @param name The name of the desired item.
7665     *
7666     * @return the value of an item previously added with putExtra(),
7667     * or null if no double array value was found.
7668     *
7669     * @see #putExtra(String, double[])
7670     */
7671    public double[] getDoubleArrayExtra(String name) {
7672        return mExtras == null ? null : mExtras.getDoubleArray(name);
7673    }
7674
7675    /**
7676     * Retrieve extended data from the intent.
7677     *
7678     * @param name The name of the desired item.
7679     *
7680     * @return the value of an item previously added with putExtra(),
7681     * or null if no String array value was found.
7682     *
7683     * @see #putExtra(String, String[])
7684     */
7685    public String[] getStringArrayExtra(String name) {
7686        return mExtras == null ? null : mExtras.getStringArray(name);
7687    }
7688
7689    /**
7690     * Retrieve extended data from the intent.
7691     *
7692     * @param name The name of the desired item.
7693     *
7694     * @return the value of an item previously added with putExtra(),
7695     * or null if no CharSequence array value was found.
7696     *
7697     * @see #putExtra(String, CharSequence[])
7698     */
7699    public CharSequence[] getCharSequenceArrayExtra(String name) {
7700        return mExtras == null ? null : mExtras.getCharSequenceArray(name);
7701    }
7702
7703    /**
7704     * Retrieve extended data from the intent.
7705     *
7706     * @param name The name of the desired item.
7707     *
7708     * @return the value of an item previously added with putExtra(),
7709     * or null if no Bundle value was found.
7710     *
7711     * @see #putExtra(String, Bundle)
7712     */
7713    public Bundle getBundleExtra(String name) {
7714        return mExtras == null ? null : mExtras.getBundle(name);
7715    }
7716
7717    /**
7718     * Retrieve extended data from the intent.
7719     *
7720     * @param name The name of the desired item.
7721     *
7722     * @return the value of an item previously added with putExtra(),
7723     * or null if no IBinder value was found.
7724     *
7725     * @see #putExtra(String, IBinder)
7726     *
7727     * @deprecated
7728     * @hide
7729     */
7730    @Deprecated
7731    public IBinder getIBinderExtra(String name) {
7732        return mExtras == null ? null : mExtras.getIBinder(name);
7733    }
7734
7735    /**
7736     * Retrieve extended data from the intent.
7737     *
7738     * @param name The name of the desired item.
7739     * @param defaultValue The default value to return in case no item is
7740     * associated with the key 'name'
7741     *
7742     * @return the value of an item previously added with putExtra(),
7743     * or defaultValue if none was found.
7744     *
7745     * @see #putExtra
7746     *
7747     * @deprecated
7748     * @hide
7749     */
7750    @Deprecated
7751    public Object getExtra(String name, Object defaultValue) {
7752        Object result = defaultValue;
7753        if (mExtras != null) {
7754            Object result2 = mExtras.get(name);
7755            if (result2 != null) {
7756                result = result2;
7757            }
7758        }
7759
7760        return result;
7761    }
7762
7763    /**
7764     * Retrieves a map of extended data from the intent.
7765     *
7766     * @return the map of all extras previously added with putExtra(),
7767     * or null if none have been added.
7768     */
7769    public @Nullable Bundle getExtras() {
7770        return (mExtras != null)
7771                ? new Bundle(mExtras)
7772                : null;
7773    }
7774
7775    /**
7776     * Filter extras to only basic types.
7777     * @hide
7778     */
7779    public void removeUnsafeExtras() {
7780        if (mExtras != null) {
7781            mExtras = mExtras.filterValues();
7782        }
7783    }
7784
7785    /**
7786     * @return Whether {@link #maybeStripForHistory} will return an lightened intent or
7787     * return itself as-is.
7788     * @hide
7789     */
7790    public boolean canStripForHistory() {
7791        return ((mExtras != null) && mExtras.isParcelled()) || (mClipData != null);
7792    }
7793
7794    /**
7795     * Call it when the system needs to keep an intent for logging purposes to remove fields
7796     * that are not needed for logging.
7797     * @hide
7798     */
7799    public Intent maybeStripForHistory() {
7800        // TODO Scan and remove possibly heavy instances like Bitmaps from unparcelled extras?
7801
7802        if (!canStripForHistory()) {
7803            return this;
7804        }
7805        return new Intent(this, COPY_MODE_HISTORY);
7806    }
7807
7808    /**
7809     * Retrieve any special flags associated with this intent.  You will
7810     * normally just set them with {@link #setFlags} and let the system
7811     * take the appropriate action with them.
7812     *
7813     * @return The currently set flags.
7814     * @see #setFlags
7815     * @see #addFlags
7816     * @see #removeFlags
7817     */
7818    public @Flags int getFlags() {
7819        return mFlags;
7820    }
7821
7822    /** @hide */
7823    public boolean isExcludingStopped() {
7824        return (mFlags&(FLAG_EXCLUDE_STOPPED_PACKAGES|FLAG_INCLUDE_STOPPED_PACKAGES))
7825                == FLAG_EXCLUDE_STOPPED_PACKAGES;
7826    }
7827
7828    /**
7829     * Retrieve the application package name this Intent is limited to.  When
7830     * resolving an Intent, if non-null this limits the resolution to only
7831     * components in the given application package.
7832     *
7833     * @return The name of the application package for the Intent.
7834     *
7835     * @see #resolveActivity
7836     * @see #setPackage
7837     */
7838    public @Nullable String getPackage() {
7839        return mPackage;
7840    }
7841
7842    /**
7843     * Retrieve the concrete component associated with the intent.  When receiving
7844     * an intent, this is the component that was found to best handle it (that is,
7845     * yourself) and will always be non-null; in all other cases it will be
7846     * null unless explicitly set.
7847     *
7848     * @return The name of the application component to handle the intent.
7849     *
7850     * @see #resolveActivity
7851     * @see #setComponent
7852     */
7853    public @Nullable ComponentName getComponent() {
7854        return mComponent;
7855    }
7856
7857    /**
7858     * Get the bounds of the sender of this intent, in screen coordinates.  This can be
7859     * used as a hint to the receiver for animations and the like.  Null means that there
7860     * is no source bounds.
7861     */
7862    public @Nullable Rect getSourceBounds() {
7863        return mSourceBounds;
7864    }
7865
7866    /**
7867     * Return the Activity component that should be used to handle this intent.
7868     * The appropriate component is determined based on the information in the
7869     * intent, evaluated as follows:
7870     *
7871     * <p>If {@link #getComponent} returns an explicit class, that is returned
7872     * without any further consideration.
7873     *
7874     * <p>The activity must handle the {@link Intent#CATEGORY_DEFAULT} Intent
7875     * category to be considered.
7876     *
7877     * <p>If {@link #getAction} is non-NULL, the activity must handle this
7878     * action.
7879     *
7880     * <p>If {@link #resolveType} returns non-NULL, the activity must handle
7881     * this type.
7882     *
7883     * <p>If {@link #addCategory} has added any categories, the activity must
7884     * handle ALL of the categories specified.
7885     *
7886     * <p>If {@link #getPackage} is non-NULL, only activity components in
7887     * that application package will be considered.
7888     *
7889     * <p>If there are no activities that satisfy all of these conditions, a
7890     * null string is returned.
7891     *
7892     * <p>If multiple activities are found to satisfy the intent, the one with
7893     * the highest priority will be used.  If there are multiple activities
7894     * with the same priority, the system will either pick the best activity
7895     * based on user preference, or resolve to a system class that will allow
7896     * the user to pick an activity and forward from there.
7897     *
7898     * <p>This method is implemented simply by calling
7899     * {@link PackageManager#resolveActivity} with the "defaultOnly" parameter
7900     * true.</p>
7901     * <p> This API is called for you as part of starting an activity from an
7902     * intent.  You do not normally need to call it yourself.</p>
7903     *
7904     * @param pm The package manager with which to resolve the Intent.
7905     *
7906     * @return Name of the component implementing an activity that can
7907     *         display the intent.
7908     *
7909     * @see #setComponent
7910     * @see #getComponent
7911     * @see #resolveActivityInfo
7912     */
7913    public ComponentName resolveActivity(@NonNull PackageManager pm) {
7914        if (mComponent != null) {
7915            return mComponent;
7916        }
7917
7918        ResolveInfo info = pm.resolveActivity(
7919            this, PackageManager.MATCH_DEFAULT_ONLY);
7920        if (info != null) {
7921            return new ComponentName(
7922                    info.activityInfo.applicationInfo.packageName,
7923                    info.activityInfo.name);
7924        }
7925
7926        return null;
7927    }
7928
7929    /**
7930     * Resolve the Intent into an {@link ActivityInfo}
7931     * describing the activity that should execute the intent.  Resolution
7932     * follows the same rules as described for {@link #resolveActivity}, but
7933     * you get back the completely information about the resolved activity
7934     * instead of just its class name.
7935     *
7936     * @param pm The package manager with which to resolve the Intent.
7937     * @param flags Addition information to retrieve as per
7938     * {@link PackageManager#getActivityInfo(ComponentName, int)
7939     * PackageManager.getActivityInfo()}.
7940     *
7941     * @return PackageManager.ActivityInfo
7942     *
7943     * @see #resolveActivity
7944     */
7945    public ActivityInfo resolveActivityInfo(@NonNull PackageManager pm,
7946            @PackageManager.ComponentInfoFlags int flags) {
7947        ActivityInfo ai = null;
7948        if (mComponent != null) {
7949            try {
7950                ai = pm.getActivityInfo(mComponent, flags);
7951            } catch (PackageManager.NameNotFoundException e) {
7952                // ignore
7953            }
7954        } else {
7955            ResolveInfo info = pm.resolveActivity(
7956                this, PackageManager.MATCH_DEFAULT_ONLY | flags);
7957            if (info != null) {
7958                ai = info.activityInfo;
7959            }
7960        }
7961
7962        return ai;
7963    }
7964
7965    /**
7966     * Special function for use by the system to resolve service
7967     * intents to system apps.  Throws an exception if there are
7968     * multiple potential matches to the Intent.  Returns null if
7969     * there are no matches.
7970     * @hide
7971     */
7972    public @Nullable ComponentName resolveSystemService(@NonNull PackageManager pm,
7973            @PackageManager.ComponentInfoFlags int flags) {
7974        if (mComponent != null) {
7975            return mComponent;
7976        }
7977
7978        List<ResolveInfo> results = pm.queryIntentServices(this, flags);
7979        if (results == null) {
7980            return null;
7981        }
7982        ComponentName comp = null;
7983        for (int i=0; i<results.size(); i++) {
7984            ResolveInfo ri = results.get(i);
7985            if ((ri.serviceInfo.applicationInfo.flags&ApplicationInfo.FLAG_SYSTEM) == 0) {
7986                continue;
7987            }
7988            ComponentName foundComp = new ComponentName(ri.serviceInfo.applicationInfo.packageName,
7989                    ri.serviceInfo.name);
7990            if (comp != null) {
7991                throw new IllegalStateException("Multiple system services handle " + this
7992                        + ": " + comp + ", " + foundComp);
7993            }
7994            comp = foundComp;
7995        }
7996        return comp;
7997    }
7998
7999    /**
8000     * Set the general action to be performed.
8001     *
8002     * @param action An action name, such as ACTION_VIEW.  Application-specific
8003     *               actions should be prefixed with the vendor's package name.
8004     *
8005     * @return Returns the same Intent object, for chaining multiple calls
8006     * into a single statement.
8007     *
8008     * @see #getAction
8009     */
8010    public @NonNull Intent setAction(@Nullable String action) {
8011        mAction = action != null ? action.intern() : null;
8012        return this;
8013    }
8014
8015    /**
8016     * Set the data this intent is operating on.  This method automatically
8017     * clears any type that was previously set by {@link #setType} or
8018     * {@link #setTypeAndNormalize}.
8019     *
8020     * <p><em>Note: scheme matching in the Android framework is
8021     * case-sensitive, unlike the formal RFC. As a result,
8022     * you should always write your Uri with a lower case scheme,
8023     * or use {@link Uri#normalizeScheme} or
8024     * {@link #setDataAndNormalize}
8025     * to ensure that the scheme is converted to lower case.</em>
8026     *
8027     * @param data The Uri of the data this intent is now targeting.
8028     *
8029     * @return Returns the same Intent object, for chaining multiple calls
8030     * into a single statement.
8031     *
8032     * @see #getData
8033     * @see #setDataAndNormalize
8034     * @see android.net.Uri#normalizeScheme()
8035     */
8036    public @NonNull Intent setData(@Nullable Uri data) {
8037        mData = data;
8038        mType = null;
8039        return this;
8040    }
8041
8042    /**
8043     * Normalize and set the data this intent is operating on.
8044     *
8045     * <p>This method automatically clears any type that was
8046     * previously set (for example, by {@link #setType}).
8047     *
8048     * <p>The data Uri is normalized using
8049     * {@link android.net.Uri#normalizeScheme} before it is set,
8050     * so really this is just a convenience method for
8051     * <pre>
8052     * setData(data.normalize())
8053     * </pre>
8054     *
8055     * @param data The Uri of the data this intent is now targeting.
8056     *
8057     * @return Returns the same Intent object, for chaining multiple calls
8058     * into a single statement.
8059     *
8060     * @see #getData
8061     * @see #setType
8062     * @see android.net.Uri#normalizeScheme
8063     */
8064    public @NonNull Intent setDataAndNormalize(@NonNull Uri data) {
8065        return setData(data.normalizeScheme());
8066    }
8067
8068    /**
8069     * Set an explicit MIME data type.
8070     *
8071     * <p>This is used to create intents that only specify a type and not data,
8072     * for example to indicate the type of data to return.
8073     *
8074     * <p>This method automatically clears any data that was
8075     * previously set (for example by {@link #setData}).
8076     *
8077     * <p><em>Note: MIME type matching in the Android framework is
8078     * case-sensitive, unlike formal RFC MIME types.  As a result,
8079     * you should always write your MIME types with lower case letters,
8080     * or use {@link #normalizeMimeType} or {@link #setTypeAndNormalize}
8081     * to ensure that it is converted to lower case.</em>
8082     *
8083     * @param type The MIME type of the data being handled by this intent.
8084     *
8085     * @return Returns the same Intent object, for chaining multiple calls
8086     * into a single statement.
8087     *
8088     * @see #getType
8089     * @see #setTypeAndNormalize
8090     * @see #setDataAndType
8091     * @see #normalizeMimeType
8092     */
8093    public @NonNull Intent setType(@Nullable String type) {
8094        mData = null;
8095        mType = type;
8096        return this;
8097    }
8098
8099    /**
8100     * Normalize and set an explicit MIME data type.
8101     *
8102     * <p>This is used to create intents that only specify a type and not data,
8103     * for example to indicate the type of data to return.
8104     *
8105     * <p>This method automatically clears any data that was
8106     * previously set (for example by {@link #setData}).
8107     *
8108     * <p>The MIME type is normalized using
8109     * {@link #normalizeMimeType} before it is set,
8110     * so really this is just a convenience method for
8111     * <pre>
8112     * setType(Intent.normalizeMimeType(type))
8113     * </pre>
8114     *
8115     * @param type The MIME type of the data being handled by this intent.
8116     *
8117     * @return Returns the same Intent object, for chaining multiple calls
8118     * into a single statement.
8119     *
8120     * @see #getType
8121     * @see #setData
8122     * @see #normalizeMimeType
8123     */
8124    public @NonNull Intent setTypeAndNormalize(@Nullable String type) {
8125        return setType(normalizeMimeType(type));
8126    }
8127
8128    /**
8129     * (Usually optional) Set the data for the intent along with an explicit
8130     * MIME data type.  This method should very rarely be used -- it allows you
8131     * to override the MIME type that would ordinarily be inferred from the
8132     * data with your own type given here.
8133     *
8134     * <p><em>Note: MIME type and Uri scheme matching in the
8135     * Android framework is case-sensitive, unlike the formal RFC definitions.
8136     * As a result, you should always write these elements with lower case letters,
8137     * or use {@link #normalizeMimeType} or {@link android.net.Uri#normalizeScheme} or
8138     * {@link #setDataAndTypeAndNormalize}
8139     * to ensure that they are converted to lower case.</em>
8140     *
8141     * @param data The Uri of the data this intent is now targeting.
8142     * @param type The MIME type of the data being handled by this intent.
8143     *
8144     * @return Returns the same Intent object, for chaining multiple calls
8145     * into a single statement.
8146     *
8147     * @see #setType
8148     * @see #setData
8149     * @see #normalizeMimeType
8150     * @see android.net.Uri#normalizeScheme
8151     * @see #setDataAndTypeAndNormalize
8152     */
8153    public @NonNull Intent setDataAndType(@Nullable Uri data, @Nullable String type) {
8154        mData = data;
8155        mType = type;
8156        return this;
8157    }
8158
8159    /**
8160     * (Usually optional) Normalize and set both the data Uri and an explicit
8161     * MIME data type.  This method should very rarely be used -- it allows you
8162     * to override the MIME type that would ordinarily be inferred from the
8163     * data with your own type given here.
8164     *
8165     * <p>The data Uri and the MIME type are normalize using
8166     * {@link android.net.Uri#normalizeScheme} and {@link #normalizeMimeType}
8167     * before they are set, so really this is just a convenience method for
8168     * <pre>
8169     * setDataAndType(data.normalize(), Intent.normalizeMimeType(type))
8170     * </pre>
8171     *
8172     * @param data The Uri of the data this intent is now targeting.
8173     * @param type The MIME type of the data being handled by this intent.
8174     *
8175     * @return Returns the same Intent object, for chaining multiple calls
8176     * into a single statement.
8177     *
8178     * @see #setType
8179     * @see #setData
8180     * @see #setDataAndType
8181     * @see #normalizeMimeType
8182     * @see android.net.Uri#normalizeScheme
8183     */
8184    public @NonNull Intent setDataAndTypeAndNormalize(@NonNull Uri data, @Nullable String type) {
8185        return setDataAndType(data.normalizeScheme(), normalizeMimeType(type));
8186    }
8187
8188    /**
8189     * Add a new category to the intent.  Categories provide additional detail
8190     * about the action the intent performs.  When resolving an intent, only
8191     * activities that provide <em>all</em> of the requested categories will be
8192     * used.
8193     *
8194     * @param category The desired category.  This can be either one of the
8195     *               predefined Intent categories, or a custom category in your own
8196     *               namespace.
8197     *
8198     * @return Returns the same Intent object, for chaining multiple calls
8199     * into a single statement.
8200     *
8201     * @see #hasCategory
8202     * @see #removeCategory
8203     */
8204    public @NonNull Intent addCategory(String category) {
8205        if (mCategories == null) {
8206            mCategories = new ArraySet<String>();
8207        }
8208        mCategories.add(category.intern());
8209        return this;
8210    }
8211
8212    /**
8213     * Remove a category from an intent.
8214     *
8215     * @param category The category to remove.
8216     *
8217     * @see #addCategory
8218     */
8219    public void removeCategory(String category) {
8220        if (mCategories != null) {
8221            mCategories.remove(category);
8222            if (mCategories.size() == 0) {
8223                mCategories = null;
8224            }
8225        }
8226    }
8227
8228    /**
8229     * Set a selector for this Intent.  This is a modification to the kinds of
8230     * things the Intent will match.  If the selector is set, it will be used
8231     * when trying to find entities that can handle the Intent, instead of the
8232     * main contents of the Intent.  This allows you build an Intent containing
8233     * a generic protocol while targeting it more specifically.
8234     *
8235     * <p>An example of where this may be used is with things like
8236     * {@link #CATEGORY_APP_BROWSER}.  This category allows you to build an
8237     * Intent that will launch the Browser application.  However, the correct
8238     * main entry point of an application is actually {@link #ACTION_MAIN}
8239     * {@link #CATEGORY_LAUNCHER} with {@link #setComponent(ComponentName)}
8240     * used to specify the actual Activity to launch.  If you launch the browser
8241     * with something different, undesired behavior may happen if the user has
8242     * previously or later launches it the normal way, since they do not match.
8243     * Instead, you can build an Intent with the MAIN action (but no ComponentName
8244     * yet specified) and set a selector with {@link #ACTION_MAIN} and
8245     * {@link #CATEGORY_APP_BROWSER} to point it specifically to the browser activity.
8246     *
8247     * <p>Setting a selector does not impact the behavior of
8248     * {@link #filterEquals(Intent)} and {@link #filterHashCode()}.  This is part of the
8249     * desired behavior of a selector -- it does not impact the base meaning
8250     * of the Intent, just what kinds of things will be matched against it
8251     * when determining who can handle it.</p>
8252     *
8253     * <p>You can not use both a selector and {@link #setPackage(String)} on
8254     * the same base Intent.</p>
8255     *
8256     * @param selector The desired selector Intent; set to null to not use
8257     * a special selector.
8258     */
8259    public void setSelector(@Nullable Intent selector) {
8260        if (selector == this) {
8261            throw new IllegalArgumentException(
8262                    "Intent being set as a selector of itself");
8263        }
8264        if (selector != null && mPackage != null) {
8265            throw new IllegalArgumentException(
8266                    "Can't set selector when package name is already set");
8267        }
8268        mSelector = selector;
8269    }
8270
8271    /**
8272     * Set a {@link ClipData} associated with this Intent.  This replaces any
8273     * previously set ClipData.
8274     *
8275     * <p>The ClipData in an intent is not used for Intent matching or other
8276     * such operations.  Semantically it is like extras, used to transmit
8277     * additional data with the Intent.  The main feature of using this over
8278     * the extras for data is that {@link #FLAG_GRANT_READ_URI_PERMISSION}
8279     * and {@link #FLAG_GRANT_WRITE_URI_PERMISSION} will operate on any URI
8280     * items included in the clip data.  This is useful, in particular, if
8281     * you want to transmit an Intent containing multiple <code>content:</code>
8282     * URIs for which the recipient may not have global permission to access the
8283     * content provider.
8284     *
8285     * <p>If the ClipData contains items that are themselves Intents, any
8286     * grant flags in those Intents will be ignored.  Only the top-level flags
8287     * of the main Intent are respected, and will be applied to all Uri or
8288     * Intent items in the clip (or sub-items of the clip).
8289     *
8290     * <p>The MIME type, label, and icon in the ClipData object are not
8291     * directly used by Intent.  Applications should generally rely on the
8292     * MIME type of the Intent itself, not what it may find in the ClipData.
8293     * A common practice is to construct a ClipData for use with an Intent
8294     * with a MIME type of "*&#47;*".
8295     *
8296     * @param clip The new clip to set.  May be null to clear the current clip.
8297     */
8298    public void setClipData(@Nullable ClipData clip) {
8299        mClipData = clip;
8300    }
8301
8302    /**
8303     * This is NOT a secure mechanism to identify the user who sent the intent.
8304     * When the intent is sent to a different user, it is used to fix uris by adding the userId
8305     * who sent the intent.
8306     * @hide
8307     */
8308    public void prepareToLeaveUser(int userId) {
8309        // If mContentUserHint is not UserHandle.USER_CURRENT, the intent has already left a user.
8310        // We want mContentUserHint to refer to the original user, so don't do anything.
8311        if (mContentUserHint == UserHandle.USER_CURRENT) {
8312            mContentUserHint = userId;
8313        }
8314    }
8315
8316    /**
8317     * Add extended data to the intent.  The name must include a package
8318     * prefix, for example the app com.android.contacts would use names
8319     * like "com.android.contacts.ShowAll".
8320     *
8321     * @param name The name of the extra data, with package prefix.
8322     * @param value The boolean data value.
8323     *
8324     * @return Returns the same Intent object, for chaining multiple calls
8325     * into a single statement.
8326     *
8327     * @see #putExtras
8328     * @see #removeExtra
8329     * @see #getBooleanExtra(String, boolean)
8330     */
8331    public @NonNull Intent putExtra(String name, boolean value) {
8332        if (mExtras == null) {
8333            mExtras = new Bundle();
8334        }
8335        mExtras.putBoolean(name, value);
8336        return this;
8337    }
8338
8339    /**
8340     * Add extended data to the intent.  The name must include a package
8341     * prefix, for example the app com.android.contacts would use names
8342     * like "com.android.contacts.ShowAll".
8343     *
8344     * @param name The name of the extra data, with package prefix.
8345     * @param value The byte data value.
8346     *
8347     * @return Returns the same Intent object, for chaining multiple calls
8348     * into a single statement.
8349     *
8350     * @see #putExtras
8351     * @see #removeExtra
8352     * @see #getByteExtra(String, byte)
8353     */
8354    public @NonNull Intent putExtra(String name, byte value) {
8355        if (mExtras == null) {
8356            mExtras = new Bundle();
8357        }
8358        mExtras.putByte(name, value);
8359        return this;
8360    }
8361
8362    /**
8363     * Add extended data to the intent.  The name must include a package
8364     * prefix, for example the app com.android.contacts would use names
8365     * like "com.android.contacts.ShowAll".
8366     *
8367     * @param name The name of the extra data, with package prefix.
8368     * @param value The char data value.
8369     *
8370     * @return Returns the same Intent object, for chaining multiple calls
8371     * into a single statement.
8372     *
8373     * @see #putExtras
8374     * @see #removeExtra
8375     * @see #getCharExtra(String, char)
8376     */
8377    public @NonNull Intent putExtra(String name, char value) {
8378        if (mExtras == null) {
8379            mExtras = new Bundle();
8380        }
8381        mExtras.putChar(name, value);
8382        return this;
8383    }
8384
8385    /**
8386     * Add extended data to the intent.  The name must include a package
8387     * prefix, for example the app com.android.contacts would use names
8388     * like "com.android.contacts.ShowAll".
8389     *
8390     * @param name The name of the extra data, with package prefix.
8391     * @param value The short data value.
8392     *
8393     * @return Returns the same Intent object, for chaining multiple calls
8394     * into a single statement.
8395     *
8396     * @see #putExtras
8397     * @see #removeExtra
8398     * @see #getShortExtra(String, short)
8399     */
8400    public @NonNull Intent putExtra(String name, short value) {
8401        if (mExtras == null) {
8402            mExtras = new Bundle();
8403        }
8404        mExtras.putShort(name, value);
8405        return this;
8406    }
8407
8408    /**
8409     * Add extended data to the intent.  The name must include a package
8410     * prefix, for example the app com.android.contacts would use names
8411     * like "com.android.contacts.ShowAll".
8412     *
8413     * @param name The name of the extra data, with package prefix.
8414     * @param value The integer data value.
8415     *
8416     * @return Returns the same Intent object, for chaining multiple calls
8417     * into a single statement.
8418     *
8419     * @see #putExtras
8420     * @see #removeExtra
8421     * @see #getIntExtra(String, int)
8422     */
8423    public @NonNull Intent putExtra(String name, int value) {
8424        if (mExtras == null) {
8425            mExtras = new Bundle();
8426        }
8427        mExtras.putInt(name, value);
8428        return this;
8429    }
8430
8431    /**
8432     * Add extended data to the intent.  The name must include a package
8433     * prefix, for example the app com.android.contacts would use names
8434     * like "com.android.contacts.ShowAll".
8435     *
8436     * @param name The name of the extra data, with package prefix.
8437     * @param value The long data value.
8438     *
8439     * @return Returns the same Intent object, for chaining multiple calls
8440     * into a single statement.
8441     *
8442     * @see #putExtras
8443     * @see #removeExtra
8444     * @see #getLongExtra(String, long)
8445     */
8446    public @NonNull Intent putExtra(String name, long value) {
8447        if (mExtras == null) {
8448            mExtras = new Bundle();
8449        }
8450        mExtras.putLong(name, value);
8451        return this;
8452    }
8453
8454    /**
8455     * Add extended data to the intent.  The name must include a package
8456     * prefix, for example the app com.android.contacts would use names
8457     * like "com.android.contacts.ShowAll".
8458     *
8459     * @param name The name of the extra data, with package prefix.
8460     * @param value The float data value.
8461     *
8462     * @return Returns the same Intent object, for chaining multiple calls
8463     * into a single statement.
8464     *
8465     * @see #putExtras
8466     * @see #removeExtra
8467     * @see #getFloatExtra(String, float)
8468     */
8469    public @NonNull Intent putExtra(String name, float value) {
8470        if (mExtras == null) {
8471            mExtras = new Bundle();
8472        }
8473        mExtras.putFloat(name, value);
8474        return this;
8475    }
8476
8477    /**
8478     * Add extended data to the intent.  The name must include a package
8479     * prefix, for example the app com.android.contacts would use names
8480     * like "com.android.contacts.ShowAll".
8481     *
8482     * @param name The name of the extra data, with package prefix.
8483     * @param value The double data value.
8484     *
8485     * @return Returns the same Intent object, for chaining multiple calls
8486     * into a single statement.
8487     *
8488     * @see #putExtras
8489     * @see #removeExtra
8490     * @see #getDoubleExtra(String, double)
8491     */
8492    public @NonNull Intent putExtra(String name, double value) {
8493        if (mExtras == null) {
8494            mExtras = new Bundle();
8495        }
8496        mExtras.putDouble(name, value);
8497        return this;
8498    }
8499
8500    /**
8501     * Add extended data to the intent.  The name must include a package
8502     * prefix, for example the app com.android.contacts would use names
8503     * like "com.android.contacts.ShowAll".
8504     *
8505     * @param name The name of the extra data, with package prefix.
8506     * @param value The String data value.
8507     *
8508     * @return Returns the same Intent object, for chaining multiple calls
8509     * into a single statement.
8510     *
8511     * @see #putExtras
8512     * @see #removeExtra
8513     * @see #getStringExtra(String)
8514     */
8515    public @NonNull Intent putExtra(String name, String value) {
8516        if (mExtras == null) {
8517            mExtras = new Bundle();
8518        }
8519        mExtras.putString(name, value);
8520        return this;
8521    }
8522
8523    /**
8524     * Add extended data to the intent.  The name must include a package
8525     * prefix, for example the app com.android.contacts would use names
8526     * like "com.android.contacts.ShowAll".
8527     *
8528     * @param name The name of the extra data, with package prefix.
8529     * @param value The CharSequence data value.
8530     *
8531     * @return Returns the same Intent object, for chaining multiple calls
8532     * into a single statement.
8533     *
8534     * @see #putExtras
8535     * @see #removeExtra
8536     * @see #getCharSequenceExtra(String)
8537     */
8538    public @NonNull Intent putExtra(String name, CharSequence value) {
8539        if (mExtras == null) {
8540            mExtras = new Bundle();
8541        }
8542        mExtras.putCharSequence(name, value);
8543        return this;
8544    }
8545
8546    /**
8547     * Add extended data to the intent.  The name must include a package
8548     * prefix, for example the app com.android.contacts would use names
8549     * like "com.android.contacts.ShowAll".
8550     *
8551     * @param name The name of the extra data, with package prefix.
8552     * @param value The Parcelable data value.
8553     *
8554     * @return Returns the same Intent object, for chaining multiple calls
8555     * into a single statement.
8556     *
8557     * @see #putExtras
8558     * @see #removeExtra
8559     * @see #getParcelableExtra(String)
8560     */
8561    public @NonNull Intent putExtra(String name, Parcelable value) {
8562        if (mExtras == null) {
8563            mExtras = new Bundle();
8564        }
8565        mExtras.putParcelable(name, value);
8566        return this;
8567    }
8568
8569    /**
8570     * Add extended data to the intent.  The name must include a package
8571     * prefix, for example the app com.android.contacts would use names
8572     * like "com.android.contacts.ShowAll".
8573     *
8574     * @param name The name of the extra data, with package prefix.
8575     * @param value The Parcelable[] data value.
8576     *
8577     * @return Returns the same Intent object, for chaining multiple calls
8578     * into a single statement.
8579     *
8580     * @see #putExtras
8581     * @see #removeExtra
8582     * @see #getParcelableArrayExtra(String)
8583     */
8584    public @NonNull Intent putExtra(String name, Parcelable[] value) {
8585        if (mExtras == null) {
8586            mExtras = new Bundle();
8587        }
8588        mExtras.putParcelableArray(name, value);
8589        return this;
8590    }
8591
8592    /**
8593     * Add extended data to the intent.  The name must include a package
8594     * prefix, for example the app com.android.contacts would use names
8595     * like "com.android.contacts.ShowAll".
8596     *
8597     * @param name The name of the extra data, with package prefix.
8598     * @param value The ArrayList<Parcelable> data value.
8599     *
8600     * @return Returns the same Intent object, for chaining multiple calls
8601     * into a single statement.
8602     *
8603     * @see #putExtras
8604     * @see #removeExtra
8605     * @see #getParcelableArrayListExtra(String)
8606     */
8607    public @NonNull Intent putParcelableArrayListExtra(String name,
8608            ArrayList<? extends Parcelable> value) {
8609        if (mExtras == null) {
8610            mExtras = new Bundle();
8611        }
8612        mExtras.putParcelableArrayList(name, value);
8613        return this;
8614    }
8615
8616    /**
8617     * Add extended data to the intent.  The name must include a package
8618     * prefix, for example the app com.android.contacts would use names
8619     * like "com.android.contacts.ShowAll".
8620     *
8621     * @param name The name of the extra data, with package prefix.
8622     * @param value The ArrayList<Integer> data value.
8623     *
8624     * @return Returns the same Intent object, for chaining multiple calls
8625     * into a single statement.
8626     *
8627     * @see #putExtras
8628     * @see #removeExtra
8629     * @see #getIntegerArrayListExtra(String)
8630     */
8631    public @NonNull Intent putIntegerArrayListExtra(String name, ArrayList<Integer> value) {
8632        if (mExtras == null) {
8633            mExtras = new Bundle();
8634        }
8635        mExtras.putIntegerArrayList(name, value);
8636        return this;
8637    }
8638
8639    /**
8640     * Add extended data to the intent.  The name must include a package
8641     * prefix, for example the app com.android.contacts would use names
8642     * like "com.android.contacts.ShowAll".
8643     *
8644     * @param name The name of the extra data, with package prefix.
8645     * @param value The ArrayList<String> data value.
8646     *
8647     * @return Returns the same Intent object, for chaining multiple calls
8648     * into a single statement.
8649     *
8650     * @see #putExtras
8651     * @see #removeExtra
8652     * @see #getStringArrayListExtra(String)
8653     */
8654    public @NonNull Intent putStringArrayListExtra(String name, ArrayList<String> value) {
8655        if (mExtras == null) {
8656            mExtras = new Bundle();
8657        }
8658        mExtras.putStringArrayList(name, value);
8659        return this;
8660    }
8661
8662    /**
8663     * Add extended data to the intent.  The name must include a package
8664     * prefix, for example the app com.android.contacts would use names
8665     * like "com.android.contacts.ShowAll".
8666     *
8667     * @param name The name of the extra data, with package prefix.
8668     * @param value The ArrayList<CharSequence> data value.
8669     *
8670     * @return Returns the same Intent object, for chaining multiple calls
8671     * into a single statement.
8672     *
8673     * @see #putExtras
8674     * @see #removeExtra
8675     * @see #getCharSequenceArrayListExtra(String)
8676     */
8677    public @NonNull Intent putCharSequenceArrayListExtra(String name,
8678            ArrayList<CharSequence> value) {
8679        if (mExtras == null) {
8680            mExtras = new Bundle();
8681        }
8682        mExtras.putCharSequenceArrayList(name, value);
8683        return this;
8684    }
8685
8686    /**
8687     * Add extended data to the intent.  The name must include a package
8688     * prefix, for example the app com.android.contacts would use names
8689     * like "com.android.contacts.ShowAll".
8690     *
8691     * @param name The name of the extra data, with package prefix.
8692     * @param value The Serializable data value.
8693     *
8694     * @return Returns the same Intent object, for chaining multiple calls
8695     * into a single statement.
8696     *
8697     * @see #putExtras
8698     * @see #removeExtra
8699     * @see #getSerializableExtra(String)
8700     */
8701    public @NonNull Intent putExtra(String name, Serializable value) {
8702        if (mExtras == null) {
8703            mExtras = new Bundle();
8704        }
8705        mExtras.putSerializable(name, value);
8706        return this;
8707    }
8708
8709    /**
8710     * Add extended data to the intent.  The name must include a package
8711     * prefix, for example the app com.android.contacts would use names
8712     * like "com.android.contacts.ShowAll".
8713     *
8714     * @param name The name of the extra data, with package prefix.
8715     * @param value The boolean array data value.
8716     *
8717     * @return Returns the same Intent object, for chaining multiple calls
8718     * into a single statement.
8719     *
8720     * @see #putExtras
8721     * @see #removeExtra
8722     * @see #getBooleanArrayExtra(String)
8723     */
8724    public @NonNull Intent putExtra(String name, boolean[] value) {
8725        if (mExtras == null) {
8726            mExtras = new Bundle();
8727        }
8728        mExtras.putBooleanArray(name, value);
8729        return this;
8730    }
8731
8732    /**
8733     * Add extended data to the intent.  The name must include a package
8734     * prefix, for example the app com.android.contacts would use names
8735     * like "com.android.contacts.ShowAll".
8736     *
8737     * @param name The name of the extra data, with package prefix.
8738     * @param value The byte array data value.
8739     *
8740     * @return Returns the same Intent object, for chaining multiple calls
8741     * into a single statement.
8742     *
8743     * @see #putExtras
8744     * @see #removeExtra
8745     * @see #getByteArrayExtra(String)
8746     */
8747    public @NonNull Intent putExtra(String name, byte[] value) {
8748        if (mExtras == null) {
8749            mExtras = new Bundle();
8750        }
8751        mExtras.putByteArray(name, value);
8752        return this;
8753    }
8754
8755    /**
8756     * Add extended data to the intent.  The name must include a package
8757     * prefix, for example the app com.android.contacts would use names
8758     * like "com.android.contacts.ShowAll".
8759     *
8760     * @param name The name of the extra data, with package prefix.
8761     * @param value The short array data value.
8762     *
8763     * @return Returns the same Intent object, for chaining multiple calls
8764     * into a single statement.
8765     *
8766     * @see #putExtras
8767     * @see #removeExtra
8768     * @see #getShortArrayExtra(String)
8769     */
8770    public @NonNull Intent putExtra(String name, short[] value) {
8771        if (mExtras == null) {
8772            mExtras = new Bundle();
8773        }
8774        mExtras.putShortArray(name, value);
8775        return this;
8776    }
8777
8778    /**
8779     * Add extended data to the intent.  The name must include a package
8780     * prefix, for example the app com.android.contacts would use names
8781     * like "com.android.contacts.ShowAll".
8782     *
8783     * @param name The name of the extra data, with package prefix.
8784     * @param value The char array data value.
8785     *
8786     * @return Returns the same Intent object, for chaining multiple calls
8787     * into a single statement.
8788     *
8789     * @see #putExtras
8790     * @see #removeExtra
8791     * @see #getCharArrayExtra(String)
8792     */
8793    public @NonNull Intent putExtra(String name, char[] value) {
8794        if (mExtras == null) {
8795            mExtras = new Bundle();
8796        }
8797        mExtras.putCharArray(name, value);
8798        return this;
8799    }
8800
8801    /**
8802     * Add extended data to the intent.  The name must include a package
8803     * prefix, for example the app com.android.contacts would use names
8804     * like "com.android.contacts.ShowAll".
8805     *
8806     * @param name The name of the extra data, with package prefix.
8807     * @param value The int array data value.
8808     *
8809     * @return Returns the same Intent object, for chaining multiple calls
8810     * into a single statement.
8811     *
8812     * @see #putExtras
8813     * @see #removeExtra
8814     * @see #getIntArrayExtra(String)
8815     */
8816    public @NonNull Intent putExtra(String name, int[] value) {
8817        if (mExtras == null) {
8818            mExtras = new Bundle();
8819        }
8820        mExtras.putIntArray(name, value);
8821        return this;
8822    }
8823
8824    /**
8825     * Add extended data to the intent.  The name must include a package
8826     * prefix, for example the app com.android.contacts would use names
8827     * like "com.android.contacts.ShowAll".
8828     *
8829     * @param name The name of the extra data, with package prefix.
8830     * @param value The byte array data value.
8831     *
8832     * @return Returns the same Intent object, for chaining multiple calls
8833     * into a single statement.
8834     *
8835     * @see #putExtras
8836     * @see #removeExtra
8837     * @see #getLongArrayExtra(String)
8838     */
8839    public @NonNull Intent putExtra(String name, long[] value) {
8840        if (mExtras == null) {
8841            mExtras = new Bundle();
8842        }
8843        mExtras.putLongArray(name, value);
8844        return this;
8845    }
8846
8847    /**
8848     * Add extended data to the intent.  The name must include a package
8849     * prefix, for example the app com.android.contacts would use names
8850     * like "com.android.contacts.ShowAll".
8851     *
8852     * @param name The name of the extra data, with package prefix.
8853     * @param value The float array data value.
8854     *
8855     * @return Returns the same Intent object, for chaining multiple calls
8856     * into a single statement.
8857     *
8858     * @see #putExtras
8859     * @see #removeExtra
8860     * @see #getFloatArrayExtra(String)
8861     */
8862    public @NonNull Intent putExtra(String name, float[] value) {
8863        if (mExtras == null) {
8864            mExtras = new Bundle();
8865        }
8866        mExtras.putFloatArray(name, value);
8867        return this;
8868    }
8869
8870    /**
8871     * Add extended data to the intent.  The name must include a package
8872     * prefix, for example the app com.android.contacts would use names
8873     * like "com.android.contacts.ShowAll".
8874     *
8875     * @param name The name of the extra data, with package prefix.
8876     * @param value The double array data value.
8877     *
8878     * @return Returns the same Intent object, for chaining multiple calls
8879     * into a single statement.
8880     *
8881     * @see #putExtras
8882     * @see #removeExtra
8883     * @see #getDoubleArrayExtra(String)
8884     */
8885    public @NonNull Intent putExtra(String name, double[] value) {
8886        if (mExtras == null) {
8887            mExtras = new Bundle();
8888        }
8889        mExtras.putDoubleArray(name, value);
8890        return this;
8891    }
8892
8893    /**
8894     * Add extended data to the intent.  The name must include a package
8895     * prefix, for example the app com.android.contacts would use names
8896     * like "com.android.contacts.ShowAll".
8897     *
8898     * @param name The name of the extra data, with package prefix.
8899     * @param value The String array data value.
8900     *
8901     * @return Returns the same Intent object, for chaining multiple calls
8902     * into a single statement.
8903     *
8904     * @see #putExtras
8905     * @see #removeExtra
8906     * @see #getStringArrayExtra(String)
8907     */
8908    public @NonNull Intent putExtra(String name, String[] value) {
8909        if (mExtras == null) {
8910            mExtras = new Bundle();
8911        }
8912        mExtras.putStringArray(name, value);
8913        return this;
8914    }
8915
8916    /**
8917     * Add extended data to the intent.  The name must include a package
8918     * prefix, for example the app com.android.contacts would use names
8919     * like "com.android.contacts.ShowAll".
8920     *
8921     * @param name The name of the extra data, with package prefix.
8922     * @param value The CharSequence array data value.
8923     *
8924     * @return Returns the same Intent object, for chaining multiple calls
8925     * into a single statement.
8926     *
8927     * @see #putExtras
8928     * @see #removeExtra
8929     * @see #getCharSequenceArrayExtra(String)
8930     */
8931    public @NonNull Intent putExtra(String name, CharSequence[] value) {
8932        if (mExtras == null) {
8933            mExtras = new Bundle();
8934        }
8935        mExtras.putCharSequenceArray(name, value);
8936        return this;
8937    }
8938
8939    /**
8940     * Add extended data to the intent.  The name must include a package
8941     * prefix, for example the app com.android.contacts would use names
8942     * like "com.android.contacts.ShowAll".
8943     *
8944     * @param name The name of the extra data, with package prefix.
8945     * @param value The Bundle data value.
8946     *
8947     * @return Returns the same Intent object, for chaining multiple calls
8948     * into a single statement.
8949     *
8950     * @see #putExtras
8951     * @see #removeExtra
8952     * @see #getBundleExtra(String)
8953     */
8954    public @NonNull Intent putExtra(String name, Bundle value) {
8955        if (mExtras == null) {
8956            mExtras = new Bundle();
8957        }
8958        mExtras.putBundle(name, value);
8959        return this;
8960    }
8961
8962    /**
8963     * Add extended data to the intent.  The name must include a package
8964     * prefix, for example the app com.android.contacts would use names
8965     * like "com.android.contacts.ShowAll".
8966     *
8967     * @param name The name of the extra data, with package prefix.
8968     * @param value The IBinder data value.
8969     *
8970     * @return Returns the same Intent object, for chaining multiple calls
8971     * into a single statement.
8972     *
8973     * @see #putExtras
8974     * @see #removeExtra
8975     * @see #getIBinderExtra(String)
8976     *
8977     * @deprecated
8978     * @hide
8979     */
8980    @Deprecated
8981    public @NonNull Intent putExtra(String name, IBinder value) {
8982        if (mExtras == null) {
8983            mExtras = new Bundle();
8984        }
8985        mExtras.putIBinder(name, value);
8986        return this;
8987    }
8988
8989    /**
8990     * Copy all extras in 'src' in to this intent.
8991     *
8992     * @param src Contains the extras to copy.
8993     *
8994     * @see #putExtra
8995     */
8996    public @NonNull Intent putExtras(@NonNull Intent src) {
8997        if (src.mExtras != null) {
8998            if (mExtras == null) {
8999                mExtras = new Bundle(src.mExtras);
9000            } else {
9001                mExtras.putAll(src.mExtras);
9002            }
9003        }
9004        return this;
9005    }
9006
9007    /**
9008     * Add a set of extended data to the intent.  The keys must include a package
9009     * prefix, for example the app com.android.contacts would use names
9010     * like "com.android.contacts.ShowAll".
9011     *
9012     * @param extras The Bundle of extras to add to this intent.
9013     *
9014     * @see #putExtra
9015     * @see #removeExtra
9016     */
9017    public @NonNull Intent putExtras(@NonNull Bundle extras) {
9018        if (mExtras == null) {
9019            mExtras = new Bundle();
9020        }
9021        mExtras.putAll(extras);
9022        return this;
9023    }
9024
9025    /**
9026     * Completely replace the extras in the Intent with the extras in the
9027     * given Intent.
9028     *
9029     * @param src The exact extras contained in this Intent are copied
9030     * into the target intent, replacing any that were previously there.
9031     */
9032    public @NonNull Intent replaceExtras(@NonNull Intent src) {
9033        mExtras = src.mExtras != null ? new Bundle(src.mExtras) : null;
9034        return this;
9035    }
9036
9037    /**
9038     * Completely replace the extras in the Intent with the given Bundle of
9039     * extras.
9040     *
9041     * @param extras The new set of extras in the Intent, or null to erase
9042     * all extras.
9043     */
9044    public @NonNull Intent replaceExtras(@NonNull Bundle extras) {
9045        mExtras = extras != null ? new Bundle(extras) : null;
9046        return this;
9047    }
9048
9049    /**
9050     * Remove extended data from the intent.
9051     *
9052     * @see #putExtra
9053     */
9054    public void removeExtra(String name) {
9055        if (mExtras != null) {
9056            mExtras.remove(name);
9057            if (mExtras.size() == 0) {
9058                mExtras = null;
9059            }
9060        }
9061    }
9062
9063    /**
9064     * Set special flags controlling how this intent is handled.  Most values
9065     * here depend on the type of component being executed by the Intent,
9066     * specifically the FLAG_ACTIVITY_* flags are all for use with
9067     * {@link Context#startActivity Context.startActivity()} and the
9068     * FLAG_RECEIVER_* flags are all for use with
9069     * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}.
9070     *
9071     * <p>See the
9072     * <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back
9073     * Stack</a> documentation for important information on how some of these options impact
9074     * the behavior of your application.
9075     *
9076     * @param flags The desired flags.
9077     * @return Returns the same Intent object, for chaining multiple calls
9078     * into a single statement.
9079     * @see #getFlags
9080     * @see #addFlags
9081     * @see #removeFlags
9082     */
9083    public @NonNull Intent setFlags(@Flags int flags) {
9084        mFlags = flags;
9085        return this;
9086    }
9087
9088    /**
9089     * Add additional flags to the intent (or with existing flags value).
9090     *
9091     * @param flags The new flags to set.
9092     * @return Returns the same Intent object, for chaining multiple calls into
9093     *         a single statement.
9094     * @see #setFlags
9095     * @see #getFlags
9096     * @see #removeFlags
9097     */
9098    public @NonNull Intent addFlags(@Flags int flags) {
9099        mFlags |= flags;
9100        return this;
9101    }
9102
9103    /**
9104     * Remove these flags from the intent.
9105     *
9106     * @param flags The flags to remove.
9107     * @see #setFlags
9108     * @see #getFlags
9109     * @see #addFlags
9110     */
9111    public void removeFlags(@Flags int flags) {
9112        mFlags &= ~flags;
9113    }
9114
9115    /**
9116     * (Usually optional) Set an explicit application package name that limits
9117     * the components this Intent will resolve to.  If left to the default
9118     * value of null, all components in all applications will considered.
9119     * If non-null, the Intent can only match the components in the given
9120     * application package.
9121     *
9122     * @param packageName The name of the application package to handle the
9123     * intent, or null to allow any application package.
9124     *
9125     * @return Returns the same Intent object, for chaining multiple calls
9126     * into a single statement.
9127     *
9128     * @see #getPackage
9129     * @see #resolveActivity
9130     */
9131    public @NonNull Intent setPackage(@Nullable String packageName) {
9132        if (packageName != null && mSelector != null) {
9133            throw new IllegalArgumentException(
9134                    "Can't set package name when selector is already set");
9135        }
9136        mPackage = packageName;
9137        return this;
9138    }
9139
9140    /**
9141     * (Usually optional) Explicitly set the component to handle the intent.
9142     * If left with the default value of null, the system will determine the
9143     * appropriate class to use based on the other fields (action, data,
9144     * type, categories) in the Intent.  If this class is defined, the
9145     * specified class will always be used regardless of the other fields.  You
9146     * should only set this value when you know you absolutely want a specific
9147     * class to be used; otherwise it is better to let the system find the
9148     * appropriate class so that you will respect the installed applications
9149     * and user preferences.
9150     *
9151     * @param component The name of the application component to handle the
9152     * intent, or null to let the system find one for you.
9153     *
9154     * @return Returns the same Intent object, for chaining multiple calls
9155     * into a single statement.
9156     *
9157     * @see #setClass
9158     * @see #setClassName(Context, String)
9159     * @see #setClassName(String, String)
9160     * @see #getComponent
9161     * @see #resolveActivity
9162     */
9163    public @NonNull Intent setComponent(@Nullable ComponentName component) {
9164        mComponent = component;
9165        return this;
9166    }
9167
9168    /**
9169     * Convenience for calling {@link #setComponent} with an
9170     * explicit class name.
9171     *
9172     * @param packageContext A Context of the application package implementing
9173     * this class.
9174     * @param className The name of a class inside of the application package
9175     * that will be used as the component for this Intent.
9176     *
9177     * @return Returns the same Intent object, for chaining multiple calls
9178     * into a single statement.
9179     *
9180     * @see #setComponent
9181     * @see #setClass
9182     */
9183    public @NonNull Intent setClassName(@NonNull Context packageContext,
9184            @NonNull String className) {
9185        mComponent = new ComponentName(packageContext, className);
9186        return this;
9187    }
9188
9189    /**
9190     * Convenience for calling {@link #setComponent} with an
9191     * explicit application package name and class name.
9192     *
9193     * @param packageName The name of the package implementing the desired
9194     * component.
9195     * @param className The name of a class inside of the application package
9196     * that will be used as the component for this Intent.
9197     *
9198     * @return Returns the same Intent object, for chaining multiple calls
9199     * into a single statement.
9200     *
9201     * @see #setComponent
9202     * @see #setClass
9203     */
9204    public @NonNull Intent setClassName(@NonNull String packageName, @NonNull String className) {
9205        mComponent = new ComponentName(packageName, className);
9206        return this;
9207    }
9208
9209    /**
9210     * Convenience for calling {@link #setComponent(ComponentName)} with the
9211     * name returned by a {@link Class} object.
9212     *
9213     * @param packageContext A Context of the application package implementing
9214     * this class.
9215     * @param cls The class name to set, equivalent to
9216     *            <code>setClassName(context, cls.getName())</code>.
9217     *
9218     * @return Returns the same Intent object, for chaining multiple calls
9219     * into a single statement.
9220     *
9221     * @see #setComponent
9222     */
9223    public @NonNull Intent setClass(@NonNull Context packageContext, @NonNull Class<?> cls) {
9224        mComponent = new ComponentName(packageContext, cls);
9225        return this;
9226    }
9227
9228    /**
9229     * Set the bounds of the sender of this intent, in screen coordinates.  This can be
9230     * used as a hint to the receiver for animations and the like.  Null means that there
9231     * is no source bounds.
9232     */
9233    public void setSourceBounds(@Nullable Rect r) {
9234        if (r != null) {
9235            mSourceBounds = new Rect(r);
9236        } else {
9237            mSourceBounds = null;
9238        }
9239    }
9240
9241    /** @hide */
9242    @IntDef(flag = true, prefix = { "FILL_IN_" }, value = {
9243            FILL_IN_ACTION,
9244            FILL_IN_DATA,
9245            FILL_IN_CATEGORIES,
9246            FILL_IN_COMPONENT,
9247            FILL_IN_PACKAGE,
9248            FILL_IN_SOURCE_BOUNDS,
9249            FILL_IN_SELECTOR,
9250            FILL_IN_CLIP_DATA
9251    })
9252    @Retention(RetentionPolicy.SOURCE)
9253    public @interface FillInFlags {}
9254
9255    /**
9256     * Use with {@link #fillIn} to allow the current action value to be
9257     * overwritten, even if it is already set.
9258     */
9259    public static final int FILL_IN_ACTION = 1<<0;
9260
9261    /**
9262     * Use with {@link #fillIn} to allow the current data or type value
9263     * overwritten, even if it is already set.
9264     */
9265    public static final int FILL_IN_DATA = 1<<1;
9266
9267    /**
9268     * Use with {@link #fillIn} to allow the current categories to be
9269     * overwritten, even if they are already set.
9270     */
9271    public static final int FILL_IN_CATEGORIES = 1<<2;
9272
9273    /**
9274     * Use with {@link #fillIn} to allow the current component value to be
9275     * overwritten, even if it is already set.
9276     */
9277    public static final int FILL_IN_COMPONENT = 1<<3;
9278
9279    /**
9280     * Use with {@link #fillIn} to allow the current package value to be
9281     * overwritten, even if it is already set.
9282     */
9283    public static final int FILL_IN_PACKAGE = 1<<4;
9284
9285    /**
9286     * Use with {@link #fillIn} to allow the current bounds rectangle to be
9287     * overwritten, even if it is already set.
9288     */
9289    public static final int FILL_IN_SOURCE_BOUNDS = 1<<5;
9290
9291    /**
9292     * Use with {@link #fillIn} to allow the current selector to be
9293     * overwritten, even if it is already set.
9294     */
9295    public static final int FILL_IN_SELECTOR = 1<<6;
9296
9297    /**
9298     * Use with {@link #fillIn} to allow the current ClipData to be
9299     * overwritten, even if it is already set.
9300     */
9301    public static final int FILL_IN_CLIP_DATA = 1<<7;
9302
9303    /**
9304     * Copy the contents of <var>other</var> in to this object, but only
9305     * where fields are not defined by this object.  For purposes of a field
9306     * being defined, the following pieces of data in the Intent are
9307     * considered to be separate fields:
9308     *
9309     * <ul>
9310     * <li> action, as set by {@link #setAction}.
9311     * <li> data Uri and MIME type, as set by {@link #setData(Uri)},
9312     * {@link #setType(String)}, or {@link #setDataAndType(Uri, String)}.
9313     * <li> categories, as set by {@link #addCategory}.
9314     * <li> package, as set by {@link #setPackage}.
9315     * <li> component, as set by {@link #setComponent(ComponentName)} or
9316     * related methods.
9317     * <li> source bounds, as set by {@link #setSourceBounds}.
9318     * <li> selector, as set by {@link #setSelector(Intent)}.
9319     * <li> clip data, as set by {@link #setClipData(ClipData)}.
9320     * <li> each top-level name in the associated extras.
9321     * </ul>
9322     *
9323     * <p>In addition, you can use the {@link #FILL_IN_ACTION},
9324     * {@link #FILL_IN_DATA}, {@link #FILL_IN_CATEGORIES}, {@link #FILL_IN_PACKAGE},
9325     * {@link #FILL_IN_COMPONENT}, {@link #FILL_IN_SOURCE_BOUNDS},
9326     * {@link #FILL_IN_SELECTOR}, and {@link #FILL_IN_CLIP_DATA} to override
9327     * the restriction where the corresponding field will not be replaced if
9328     * it is already set.
9329     *
9330     * <p>Note: The component field will only be copied if {@link #FILL_IN_COMPONENT}
9331     * is explicitly specified.  The selector will only be copied if
9332     * {@link #FILL_IN_SELECTOR} is explicitly specified.
9333     *
9334     * <p>For example, consider Intent A with {data="foo", categories="bar"}
9335     * and Intent B with {action="gotit", data-type="some/thing",
9336     * categories="one","two"}.
9337     *
9338     * <p>Calling A.fillIn(B, Intent.FILL_IN_DATA) will result in A now
9339     * containing: {action="gotit", data-type="some/thing",
9340     * categories="bar"}.
9341     *
9342     * @param other Another Intent whose values are to be used to fill in
9343     * the current one.
9344     * @param flags Options to control which fields can be filled in.
9345     *
9346     * @return Returns a bit mask of {@link #FILL_IN_ACTION},
9347     * {@link #FILL_IN_DATA}, {@link #FILL_IN_CATEGORIES}, {@link #FILL_IN_PACKAGE},
9348     * {@link #FILL_IN_COMPONENT}, {@link #FILL_IN_SOURCE_BOUNDS},
9349     * {@link #FILL_IN_SELECTOR} and {@link #FILL_IN_CLIP_DATA} indicating which fields were
9350     * changed.
9351     */
9352    @FillInFlags
9353    public int fillIn(@NonNull Intent other, @FillInFlags int flags) {
9354        int changes = 0;
9355        boolean mayHaveCopiedUris = false;
9356        if (other.mAction != null
9357                && (mAction == null || (flags&FILL_IN_ACTION) != 0)) {
9358            mAction = other.mAction;
9359            changes |= FILL_IN_ACTION;
9360        }
9361        if ((other.mData != null || other.mType != null)
9362                && ((mData == null && mType == null)
9363                        || (flags&FILL_IN_DATA) != 0)) {
9364            mData = other.mData;
9365            mType = other.mType;
9366            changes |= FILL_IN_DATA;
9367            mayHaveCopiedUris = true;
9368        }
9369        if (other.mCategories != null
9370                && (mCategories == null || (flags&FILL_IN_CATEGORIES) != 0)) {
9371            if (other.mCategories != null) {
9372                mCategories = new ArraySet<String>(other.mCategories);
9373            }
9374            changes |= FILL_IN_CATEGORIES;
9375        }
9376        if (other.mPackage != null
9377                && (mPackage == null || (flags&FILL_IN_PACKAGE) != 0)) {
9378            // Only do this if mSelector is not set.
9379            if (mSelector == null) {
9380                mPackage = other.mPackage;
9381                changes |= FILL_IN_PACKAGE;
9382            }
9383        }
9384        // Selector is special: it can only be set if explicitly allowed,
9385        // for the same reason as the component name.
9386        if (other.mSelector != null && (flags&FILL_IN_SELECTOR) != 0) {
9387            if (mPackage == null) {
9388                mSelector = new Intent(other.mSelector);
9389                mPackage = null;
9390                changes |= FILL_IN_SELECTOR;
9391            }
9392        }
9393        if (other.mClipData != null
9394                && (mClipData == null || (flags&FILL_IN_CLIP_DATA) != 0)) {
9395            mClipData = other.mClipData;
9396            changes |= FILL_IN_CLIP_DATA;
9397            mayHaveCopiedUris = true;
9398        }
9399        // Component is special: it can -only- be set if explicitly allowed,
9400        // since otherwise the sender could force the intent somewhere the
9401        // originator didn't intend.
9402        if (other.mComponent != null && (flags&FILL_IN_COMPONENT) != 0) {
9403            mComponent = other.mComponent;
9404            changes |= FILL_IN_COMPONENT;
9405        }
9406        mFlags |= other.mFlags;
9407        if (other.mSourceBounds != null
9408                && (mSourceBounds == null || (flags&FILL_IN_SOURCE_BOUNDS) != 0)) {
9409            mSourceBounds = new Rect(other.mSourceBounds);
9410            changes |= FILL_IN_SOURCE_BOUNDS;
9411        }
9412        if (mExtras == null) {
9413            if (other.mExtras != null) {
9414                mExtras = new Bundle(other.mExtras);
9415                mayHaveCopiedUris = true;
9416            }
9417        } else if (other.mExtras != null) {
9418            try {
9419                Bundle newb = new Bundle(other.mExtras);
9420                newb.putAll(mExtras);
9421                mExtras = newb;
9422                mayHaveCopiedUris = true;
9423            } catch (RuntimeException e) {
9424                // Modifying the extras can cause us to unparcel the contents
9425                // of the bundle, and if we do this in the system process that
9426                // may fail.  We really should handle this (i.e., the Bundle
9427                // impl shouldn't be on top of a plain map), but for now just
9428                // ignore it and keep the original contents. :(
9429                Log.w("Intent", "Failure filling in extras", e);
9430            }
9431        }
9432        if (mayHaveCopiedUris && mContentUserHint == UserHandle.USER_CURRENT
9433                && other.mContentUserHint != UserHandle.USER_CURRENT) {
9434            mContentUserHint = other.mContentUserHint;
9435        }
9436        return changes;
9437    }
9438
9439    /**
9440     * Wrapper class holding an Intent and implementing comparisons on it for
9441     * the purpose of filtering.  The class implements its
9442     * {@link #equals equals()} and {@link #hashCode hashCode()} methods as
9443     * simple calls to {@link Intent#filterEquals(Intent)}  filterEquals()} and
9444     * {@link android.content.Intent#filterHashCode()}  filterHashCode()}
9445     * on the wrapped Intent.
9446     */
9447    public static final class FilterComparison {
9448        private final Intent mIntent;
9449        private final int mHashCode;
9450
9451        public FilterComparison(Intent intent) {
9452            mIntent = intent;
9453            mHashCode = intent.filterHashCode();
9454        }
9455
9456        /**
9457         * Return the Intent that this FilterComparison represents.
9458         * @return Returns the Intent held by the FilterComparison.  Do
9459         * not modify!
9460         */
9461        public Intent getIntent() {
9462            return mIntent;
9463        }
9464
9465        @Override
9466        public boolean equals(Object obj) {
9467            if (obj instanceof FilterComparison) {
9468                Intent other = ((FilterComparison)obj).mIntent;
9469                return mIntent.filterEquals(other);
9470            }
9471            return false;
9472        }
9473
9474        @Override
9475        public int hashCode() {
9476            return mHashCode;
9477        }
9478    }
9479
9480    /**
9481     * Determine if two intents are the same for the purposes of intent
9482     * resolution (filtering). That is, if their action, data, type,
9483     * class, and categories are the same.  This does <em>not</em> compare
9484     * any extra data included in the intents.
9485     *
9486     * @param other The other Intent to compare against.
9487     *
9488     * @return Returns true if action, data, type, class, and categories
9489     *         are the same.
9490     */
9491    public boolean filterEquals(Intent other) {
9492        if (other == null) {
9493            return false;
9494        }
9495        if (!Objects.equals(this.mAction, other.mAction)) return false;
9496        if (!Objects.equals(this.mData, other.mData)) return false;
9497        if (!Objects.equals(this.mType, other.mType)) return false;
9498        if (!Objects.equals(this.mPackage, other.mPackage)) return false;
9499        if (!Objects.equals(this.mComponent, other.mComponent)) return false;
9500        if (!Objects.equals(this.mCategories, other.mCategories)) return false;
9501
9502        return true;
9503    }
9504
9505    /**
9506     * Generate hash code that matches semantics of filterEquals().
9507     *
9508     * @return Returns the hash value of the action, data, type, class, and
9509     *         categories.
9510     *
9511     * @see #filterEquals
9512     */
9513    public int filterHashCode() {
9514        int code = 0;
9515        if (mAction != null) {
9516            code += mAction.hashCode();
9517        }
9518        if (mData != null) {
9519            code += mData.hashCode();
9520        }
9521        if (mType != null) {
9522            code += mType.hashCode();
9523        }
9524        if (mPackage != null) {
9525            code += mPackage.hashCode();
9526        }
9527        if (mComponent != null) {
9528            code += mComponent.hashCode();
9529        }
9530        if (mCategories != null) {
9531            code += mCategories.hashCode();
9532        }
9533        return code;
9534    }
9535
9536    @Override
9537    public String toString() {
9538        StringBuilder b = new StringBuilder(128);
9539
9540        b.append("Intent { ");
9541        toShortString(b, true, true, true, false);
9542        b.append(" }");
9543
9544        return b.toString();
9545    }
9546
9547    /** @hide */
9548    public String toInsecureString() {
9549        StringBuilder b = new StringBuilder(128);
9550
9551        b.append("Intent { ");
9552        toShortString(b, false, true, true, false);
9553        b.append(" }");
9554
9555        return b.toString();
9556    }
9557
9558    /** @hide */
9559    public String toInsecureStringWithClip() {
9560        StringBuilder b = new StringBuilder(128);
9561
9562        b.append("Intent { ");
9563        toShortString(b, false, true, true, true);
9564        b.append(" }");
9565
9566        return b.toString();
9567    }
9568
9569    /** @hide */
9570    public String toShortString(boolean secure, boolean comp, boolean extras, boolean clip) {
9571        StringBuilder b = new StringBuilder(128);
9572        toShortString(b, secure, comp, extras, clip);
9573        return b.toString();
9574    }
9575
9576    /** @hide */
9577    public void toShortString(StringBuilder b, boolean secure, boolean comp, boolean extras,
9578            boolean clip) {
9579        boolean first = true;
9580        if (mAction != null) {
9581            b.append("act=").append(mAction);
9582            first = false;
9583        }
9584        if (mCategories != null) {
9585            if (!first) {
9586                b.append(' ');
9587            }
9588            first = false;
9589            b.append("cat=[");
9590            for (int i=0; i<mCategories.size(); i++) {
9591                if (i > 0) b.append(',');
9592                b.append(mCategories.valueAt(i));
9593            }
9594            b.append("]");
9595        }
9596        if (mData != null) {
9597            if (!first) {
9598                b.append(' ');
9599            }
9600            first = false;
9601            b.append("dat=");
9602            if (secure) {
9603                b.append(mData.toSafeString());
9604            } else {
9605                b.append(mData);
9606            }
9607        }
9608        if (mType != null) {
9609            if (!first) {
9610                b.append(' ');
9611            }
9612            first = false;
9613            b.append("typ=").append(mType);
9614        }
9615        if (mFlags != 0) {
9616            if (!first) {
9617                b.append(' ');
9618            }
9619            first = false;
9620            b.append("flg=0x").append(Integer.toHexString(mFlags));
9621        }
9622        if (mPackage != null) {
9623            if (!first) {
9624                b.append(' ');
9625            }
9626            first = false;
9627            b.append("pkg=").append(mPackage);
9628        }
9629        if (comp && mComponent != null) {
9630            if (!first) {
9631                b.append(' ');
9632            }
9633            first = false;
9634            b.append("cmp=").append(mComponent.flattenToShortString());
9635        }
9636        if (mSourceBounds != null) {
9637            if (!first) {
9638                b.append(' ');
9639            }
9640            first = false;
9641            b.append("bnds=").append(mSourceBounds.toShortString());
9642        }
9643        if (mClipData != null) {
9644            if (!first) {
9645                b.append(' ');
9646            }
9647            b.append("clip={");
9648            if (clip) {
9649                mClipData.toShortString(b);
9650            } else {
9651                if (mClipData.getDescription() != null) {
9652                    first = !mClipData.getDescription().toShortStringTypesOnly(b);
9653                } else {
9654                    first = true;
9655                }
9656                mClipData.toShortStringShortItems(b, first);
9657            }
9658            first = false;
9659            b.append('}');
9660        }
9661        if (extras && mExtras != null) {
9662            if (!first) {
9663                b.append(' ');
9664            }
9665            first = false;
9666            b.append("(has extras)");
9667        }
9668        if (mContentUserHint != UserHandle.USER_CURRENT) {
9669            if (!first) {
9670                b.append(' ');
9671            }
9672            first = false;
9673            b.append("u=").append(mContentUserHint);
9674        }
9675        if (mSelector != null) {
9676            b.append(" sel=");
9677            mSelector.toShortString(b, secure, comp, extras, clip);
9678            b.append("}");
9679        }
9680    }
9681
9682    /** @hide */
9683    public void writeToProto(ProtoOutputStream proto, long fieldId) {
9684        // Same input parameters that toString() gives to toShortString().
9685        writeToProto(proto, fieldId, true, true, true, false);
9686    }
9687
9688    /** @hide */
9689    public void writeToProto(ProtoOutputStream proto, long fieldId, boolean secure, boolean comp,
9690            boolean extras, boolean clip) {
9691        long token = proto.start(fieldId);
9692        if (mAction != null) {
9693            proto.write(IntentProto.ACTION, mAction);
9694        }
9695        if (mCategories != null)  {
9696            for (String category : mCategories) {
9697                proto.write(IntentProto.CATEGORIES, category);
9698            }
9699        }
9700        if (mData != null) {
9701            proto.write(IntentProto.DATA, secure ? mData.toSafeString() : mData.toString());
9702        }
9703        if (mType != null) {
9704            proto.write(IntentProto.TYPE, mType);
9705        }
9706        if (mFlags != 0) {
9707            proto.write(IntentProto.FLAG, "0x" + Integer.toHexString(mFlags));
9708        }
9709        if (mPackage != null) {
9710            proto.write(IntentProto.PACKAGE, mPackage);
9711        }
9712        if (comp && mComponent != null) {
9713            mComponent.writeToProto(proto, IntentProto.COMPONENT);
9714        }
9715        if (mSourceBounds != null) {
9716            proto.write(IntentProto.SOURCE_BOUNDS, mSourceBounds.toShortString());
9717        }
9718        if (mClipData != null) {
9719            StringBuilder b = new StringBuilder();
9720            if (clip) {
9721                mClipData.toShortString(b);
9722            } else {
9723                mClipData.toShortStringShortItems(b, false);
9724            }
9725            proto.write(IntentProto.CLIP_DATA, b.toString());
9726        }
9727        if (extras && mExtras != null) {
9728            proto.write(IntentProto.EXTRAS, mExtras.toShortString());
9729        }
9730        if (mContentUserHint != 0) {
9731            proto.write(IntentProto.CONTENT_USER_HINT, mContentUserHint);
9732        }
9733        if (mSelector != null) {
9734            proto.write(IntentProto.SELECTOR, mSelector.toShortString(secure, comp, extras, clip));
9735        }
9736        proto.end(token);
9737    }
9738
9739    /**
9740     * Call {@link #toUri} with 0 flags.
9741     * @deprecated Use {@link #toUri} instead.
9742     */
9743    @Deprecated
9744    public String toURI() {
9745        return toUri(0);
9746    }
9747
9748    /**
9749     * Convert this Intent into a String holding a URI representation of it.
9750     * The returned URI string has been properly URI encoded, so it can be
9751     * used with {@link Uri#parse Uri.parse(String)}.  The URI contains the
9752     * Intent's data as the base URI, with an additional fragment describing
9753     * the action, categories, type, flags, package, component, and extras.
9754     *
9755     * <p>You can convert the returned string back to an Intent with
9756     * {@link #getIntent}.
9757     *
9758     * @param flags Additional operating flags.
9759     *
9760     * @return Returns a URI encoding URI string describing the entire contents
9761     * of the Intent.
9762     */
9763    public String toUri(@UriFlags int flags) {
9764        StringBuilder uri = new StringBuilder(128);
9765        if ((flags&URI_ANDROID_APP_SCHEME) != 0) {
9766            if (mPackage == null) {
9767                throw new IllegalArgumentException(
9768                        "Intent must include an explicit package name to build an android-app: "
9769                        + this);
9770            }
9771            uri.append("android-app://");
9772            uri.append(mPackage);
9773            String scheme = null;
9774            if (mData != null) {
9775                scheme = mData.getScheme();
9776                if (scheme != null) {
9777                    uri.append('/');
9778                    uri.append(scheme);
9779                    String authority = mData.getEncodedAuthority();
9780                    if (authority != null) {
9781                        uri.append('/');
9782                        uri.append(authority);
9783                        String path = mData.getEncodedPath();
9784                        if (path != null) {
9785                            uri.append(path);
9786                        }
9787                        String queryParams = mData.getEncodedQuery();
9788                        if (queryParams != null) {
9789                            uri.append('?');
9790                            uri.append(queryParams);
9791                        }
9792                        String fragment = mData.getEncodedFragment();
9793                        if (fragment != null) {
9794                            uri.append('#');
9795                            uri.append(fragment);
9796                        }
9797                    }
9798                }
9799            }
9800            toUriFragment(uri, null, scheme == null ? Intent.ACTION_MAIN : Intent.ACTION_VIEW,
9801                    mPackage, flags);
9802            return uri.toString();
9803        }
9804        String scheme = null;
9805        if (mData != null) {
9806            String data = mData.toString();
9807            if ((flags&URI_INTENT_SCHEME) != 0) {
9808                final int N = data.length();
9809                for (int i=0; i<N; i++) {
9810                    char c = data.charAt(i);
9811                    if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')
9812                            || (c >= '0' && c <= '9') || c == '.' || c == '-' || c == '+') {
9813                        continue;
9814                    }
9815                    if (c == ':' && i > 0) {
9816                        // Valid scheme.
9817                        scheme = data.substring(0, i);
9818                        uri.append("intent:");
9819                        data = data.substring(i+1);
9820                        break;
9821                    }
9822
9823                    // No scheme.
9824                    break;
9825                }
9826            }
9827            uri.append(data);
9828
9829        } else if ((flags&URI_INTENT_SCHEME) != 0) {
9830            uri.append("intent:");
9831        }
9832
9833        toUriFragment(uri, scheme, Intent.ACTION_VIEW, null, flags);
9834
9835        return uri.toString();
9836    }
9837
9838    private void toUriFragment(StringBuilder uri, String scheme, String defAction,
9839            String defPackage, int flags) {
9840        StringBuilder frag = new StringBuilder(128);
9841
9842        toUriInner(frag, scheme, defAction, defPackage, flags);
9843        if (mSelector != null) {
9844            frag.append("SEL;");
9845            // Note that for now we are not going to try to handle the
9846            // data part; not clear how to represent this as a URI, and
9847            // not much utility in it.
9848            mSelector.toUriInner(frag, mSelector.mData != null ? mSelector.mData.getScheme() : null,
9849                    null, null, flags);
9850        }
9851
9852        if (frag.length() > 0) {
9853            uri.append("#Intent;");
9854            uri.append(frag);
9855            uri.append("end");
9856        }
9857    }
9858
9859    private void toUriInner(StringBuilder uri, String scheme, String defAction,
9860            String defPackage, int flags) {
9861        if (scheme != null) {
9862            uri.append("scheme=").append(scheme).append(';');
9863        }
9864        if (mAction != null && !mAction.equals(defAction)) {
9865            uri.append("action=").append(Uri.encode(mAction)).append(';');
9866        }
9867        if (mCategories != null) {
9868            for (int i=0; i<mCategories.size(); i++) {
9869                uri.append("category=").append(Uri.encode(mCategories.valueAt(i))).append(';');
9870            }
9871        }
9872        if (mType != null) {
9873            uri.append("type=").append(Uri.encode(mType, "/")).append(';');
9874        }
9875        if (mFlags != 0) {
9876            uri.append("launchFlags=0x").append(Integer.toHexString(mFlags)).append(';');
9877        }
9878        if (mPackage != null && !mPackage.equals(defPackage)) {
9879            uri.append("package=").append(Uri.encode(mPackage)).append(';');
9880        }
9881        if (mComponent != null) {
9882            uri.append("component=").append(Uri.encode(
9883                    mComponent.flattenToShortString(), "/")).append(';');
9884        }
9885        if (mSourceBounds != null) {
9886            uri.append("sourceBounds=")
9887                    .append(Uri.encode(mSourceBounds.flattenToString()))
9888                    .append(';');
9889        }
9890        if (mExtras != null) {
9891            for (String key : mExtras.keySet()) {
9892                final Object value = mExtras.get(key);
9893                char entryType =
9894                        value instanceof String    ? 'S' :
9895                        value instanceof Boolean   ? 'B' :
9896                        value instanceof Byte      ? 'b' :
9897                        value instanceof Character ? 'c' :
9898                        value instanceof Double    ? 'd' :
9899                        value instanceof Float     ? 'f' :
9900                        value instanceof Integer   ? 'i' :
9901                        value instanceof Long      ? 'l' :
9902                        value instanceof Short     ? 's' :
9903                        '\0';
9904
9905                if (entryType != '\0') {
9906                    uri.append(entryType);
9907                    uri.append('.');
9908                    uri.append(Uri.encode(key));
9909                    uri.append('=');
9910                    uri.append(Uri.encode(value.toString()));
9911                    uri.append(';');
9912                }
9913            }
9914        }
9915    }
9916
9917    public int describeContents() {
9918        return (mExtras != null) ? mExtras.describeContents() : 0;
9919    }
9920
9921    public void writeToParcel(Parcel out, int flags) {
9922        out.writeString(mAction);
9923        Uri.writeToParcel(out, mData);
9924        out.writeString(mType);
9925        out.writeInt(mFlags);
9926        out.writeString(mPackage);
9927        ComponentName.writeToParcel(mComponent, out);
9928
9929        if (mSourceBounds != null) {
9930            out.writeInt(1);
9931            mSourceBounds.writeToParcel(out, flags);
9932        } else {
9933            out.writeInt(0);
9934        }
9935
9936        if (mCategories != null) {
9937            final int N = mCategories.size();
9938            out.writeInt(N);
9939            for (int i=0; i<N; i++) {
9940                out.writeString(mCategories.valueAt(i));
9941            }
9942        } else {
9943            out.writeInt(0);
9944        }
9945
9946        if (mSelector != null) {
9947            out.writeInt(1);
9948            mSelector.writeToParcel(out, flags);
9949        } else {
9950            out.writeInt(0);
9951        }
9952
9953        if (mClipData != null) {
9954            out.writeInt(1);
9955            mClipData.writeToParcel(out, flags);
9956        } else {
9957            out.writeInt(0);
9958        }
9959        out.writeInt(mContentUserHint);
9960        out.writeBundle(mExtras);
9961    }
9962
9963    public static final Parcelable.Creator<Intent> CREATOR
9964            = new Parcelable.Creator<Intent>() {
9965        public Intent createFromParcel(Parcel in) {
9966            return new Intent(in);
9967        }
9968        public Intent[] newArray(int size) {
9969            return new Intent[size];
9970        }
9971    };
9972
9973    /** @hide */
9974    protected Intent(Parcel in) {
9975        readFromParcel(in);
9976    }
9977
9978    public void readFromParcel(Parcel in) {
9979        setAction(in.readString());
9980        mData = Uri.CREATOR.createFromParcel(in);
9981        mType = in.readString();
9982        mFlags = in.readInt();
9983        mPackage = in.readString();
9984        mComponent = ComponentName.readFromParcel(in);
9985
9986        if (in.readInt() != 0) {
9987            mSourceBounds = Rect.CREATOR.createFromParcel(in);
9988        }
9989
9990        int N = in.readInt();
9991        if (N > 0) {
9992            mCategories = new ArraySet<String>();
9993            int i;
9994            for (i=0; i<N; i++) {
9995                mCategories.add(in.readString().intern());
9996            }
9997        } else {
9998            mCategories = null;
9999        }
10000
10001        if (in.readInt() != 0) {
10002            mSelector = new Intent(in);
10003        }
10004
10005        if (in.readInt() != 0) {
10006            mClipData = new ClipData(in);
10007        }
10008        mContentUserHint = in.readInt();
10009        mExtras = in.readBundle();
10010    }
10011
10012    /**
10013     * Parses the "intent" element (and its children) from XML and instantiates
10014     * an Intent object.  The given XML parser should be located at the tag
10015     * where parsing should start (often named "intent"), from which the
10016     * basic action, data, type, and package and class name will be
10017     * retrieved.  The function will then parse in to any child elements,
10018     * looking for <category android:name="xxx"> tags to add categories and
10019     * <extra android:name="xxx" android:value="yyy"> to attach extra data
10020     * to the intent.
10021     *
10022     * @param resources The Resources to use when inflating resources.
10023     * @param parser The XML parser pointing at an "intent" tag.
10024     * @param attrs The AttributeSet interface for retrieving extended
10025     * attribute data at the current <var>parser</var> location.
10026     * @return An Intent object matching the XML data.
10027     * @throws XmlPullParserException If there was an XML parsing error.
10028     * @throws IOException If there was an I/O error.
10029     */
10030    public static @NonNull Intent parseIntent(@NonNull Resources resources,
10031            @NonNull XmlPullParser parser, AttributeSet attrs)
10032            throws XmlPullParserException, IOException {
10033        Intent intent = new Intent();
10034
10035        TypedArray sa = resources.obtainAttributes(attrs,
10036                com.android.internal.R.styleable.Intent);
10037
10038        intent.setAction(sa.getString(com.android.internal.R.styleable.Intent_action));
10039
10040        String data = sa.getString(com.android.internal.R.styleable.Intent_data);
10041        String mimeType = sa.getString(com.android.internal.R.styleable.Intent_mimeType);
10042        intent.setDataAndType(data != null ? Uri.parse(data) : null, mimeType);
10043
10044        String packageName = sa.getString(com.android.internal.R.styleable.Intent_targetPackage);
10045        String className = sa.getString(com.android.internal.R.styleable.Intent_targetClass);
10046        if (packageName != null && className != null) {
10047            intent.setComponent(new ComponentName(packageName, className));
10048        }
10049
10050        sa.recycle();
10051
10052        int outerDepth = parser.getDepth();
10053        int type;
10054        while ((type=parser.next()) != XmlPullParser.END_DOCUMENT
10055               && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) {
10056            if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) {
10057                continue;
10058            }
10059
10060            String nodeName = parser.getName();
10061            if (nodeName.equals(TAG_CATEGORIES)) {
10062                sa = resources.obtainAttributes(attrs,
10063                        com.android.internal.R.styleable.IntentCategory);
10064                String cat = sa.getString(com.android.internal.R.styleable.IntentCategory_name);
10065                sa.recycle();
10066
10067                if (cat != null) {
10068                    intent.addCategory(cat);
10069                }
10070                XmlUtils.skipCurrentTag(parser);
10071
10072            } else if (nodeName.equals(TAG_EXTRA)) {
10073                if (intent.mExtras == null) {
10074                    intent.mExtras = new Bundle();
10075                }
10076                resources.parseBundleExtra(TAG_EXTRA, attrs, intent.mExtras);
10077                XmlUtils.skipCurrentTag(parser);
10078
10079            } else {
10080                XmlUtils.skipCurrentTag(parser);
10081            }
10082        }
10083
10084        return intent;
10085    }
10086
10087    /** @hide */
10088    public void saveToXml(XmlSerializer out) throws IOException {
10089        if (mAction != null) {
10090            out.attribute(null, ATTR_ACTION, mAction);
10091        }
10092        if (mData != null) {
10093            out.attribute(null, ATTR_DATA, mData.toString());
10094        }
10095        if (mType != null) {
10096            out.attribute(null, ATTR_TYPE, mType);
10097        }
10098        if (mComponent != null) {
10099            out.attribute(null, ATTR_COMPONENT, mComponent.flattenToShortString());
10100        }
10101        out.attribute(null, ATTR_FLAGS, Integer.toHexString(getFlags()));
10102
10103        if (mCategories != null) {
10104            out.startTag(null, TAG_CATEGORIES);
10105            for (int categoryNdx = mCategories.size() - 1; categoryNdx >= 0; --categoryNdx) {
10106                out.attribute(null, ATTR_CATEGORY, mCategories.valueAt(categoryNdx));
10107            }
10108            out.endTag(null, TAG_CATEGORIES);
10109        }
10110    }
10111
10112    /** @hide */
10113    public static Intent restoreFromXml(XmlPullParser in) throws IOException,
10114            XmlPullParserException {
10115        Intent intent = new Intent();
10116        final int outerDepth = in.getDepth();
10117
10118        int attrCount = in.getAttributeCount();
10119        for (int attrNdx = attrCount - 1; attrNdx >= 0; --attrNdx) {
10120            final String attrName = in.getAttributeName(attrNdx);
10121            final String attrValue = in.getAttributeValue(attrNdx);
10122            if (ATTR_ACTION.equals(attrName)) {
10123                intent.setAction(attrValue);
10124            } else if (ATTR_DATA.equals(attrName)) {
10125                intent.setData(Uri.parse(attrValue));
10126            } else if (ATTR_TYPE.equals(attrName)) {
10127                intent.setType(attrValue);
10128            } else if (ATTR_COMPONENT.equals(attrName)) {
10129                intent.setComponent(ComponentName.unflattenFromString(attrValue));
10130            } else if (ATTR_FLAGS.equals(attrName)) {
10131                intent.setFlags(Integer.parseInt(attrValue, 16));
10132            } else {
10133                Log.e("Intent", "restoreFromXml: unknown attribute=" + attrName);
10134            }
10135        }
10136
10137        int event;
10138        String name;
10139        while (((event = in.next()) != XmlPullParser.END_DOCUMENT) &&
10140                (event != XmlPullParser.END_TAG || in.getDepth() < outerDepth)) {
10141            if (event == XmlPullParser.START_TAG) {
10142                name = in.getName();
10143                if (TAG_CATEGORIES.equals(name)) {
10144                    attrCount = in.getAttributeCount();
10145                    for (int attrNdx = attrCount - 1; attrNdx >= 0; --attrNdx) {
10146                        intent.addCategory(in.getAttributeValue(attrNdx));
10147                    }
10148                } else {
10149                    Log.w("Intent", "restoreFromXml: unknown name=" + name);
10150                    XmlUtils.skipCurrentTag(in);
10151                }
10152            }
10153        }
10154
10155        return intent;
10156    }
10157
10158    /**
10159     * Normalize a MIME data type.
10160     *
10161     * <p>A normalized MIME type has white-space trimmed,
10162     * content-type parameters removed, and is lower-case.
10163     * This aligns the type with Android best practices for
10164     * intent filtering.
10165     *
10166     * <p>For example, "text/plain; charset=utf-8" becomes "text/plain".
10167     * "text/x-vCard" becomes "text/x-vcard".
10168     *
10169     * <p>All MIME types received from outside Android (such as user input,
10170     * or external sources like Bluetooth, NFC, or the Internet) should
10171     * be normalized before they are used to create an Intent.
10172     *
10173     * @param type MIME data type to normalize
10174     * @return normalized MIME data type, or null if the input was null
10175     * @see #setType
10176     * @see #setTypeAndNormalize
10177     */
10178    public static @Nullable String normalizeMimeType(@Nullable String type) {
10179        if (type == null) {
10180            return null;
10181        }
10182
10183        type = type.trim().toLowerCase(Locale.ROOT);
10184
10185        final int semicolonIndex = type.indexOf(';');
10186        if (semicolonIndex != -1) {
10187            type = type.substring(0, semicolonIndex);
10188        }
10189        return type;
10190    }
10191
10192    /**
10193     * Prepare this {@link Intent} to leave an app process.
10194     *
10195     * @hide
10196     */
10197    public void prepareToLeaveProcess(Context context) {
10198        final boolean leavingPackage = (mComponent == null)
10199                || !Objects.equals(mComponent.getPackageName(), context.getPackageName());
10200        prepareToLeaveProcess(leavingPackage);
10201    }
10202
10203    /**
10204     * Prepare this {@link Intent} to leave an app process.
10205     *
10206     * @hide
10207     */
10208    public void prepareToLeaveProcess(boolean leavingPackage) {
10209        setAllowFds(false);
10210
10211        if (mSelector != null) {
10212            mSelector.prepareToLeaveProcess(leavingPackage);
10213        }
10214        if (mClipData != null) {
10215            mClipData.prepareToLeaveProcess(leavingPackage, getFlags());
10216        }
10217
10218        if (mExtras != null && !mExtras.isParcelled()) {
10219            final Object intent = mExtras.get(Intent.EXTRA_INTENT);
10220            if (intent instanceof Intent) {
10221                ((Intent) intent).prepareToLeaveProcess(leavingPackage);
10222            }
10223        }
10224
10225        if (mAction != null && mData != null && StrictMode.vmFileUriExposureEnabled()
10226                && leavingPackage) {
10227            switch (mAction) {
10228                case ACTION_MEDIA_REMOVED:
10229                case ACTION_MEDIA_UNMOUNTED:
10230                case ACTION_MEDIA_CHECKING:
10231                case ACTION_MEDIA_NOFS:
10232                case ACTION_MEDIA_MOUNTED:
10233                case ACTION_MEDIA_SHARED:
10234                case ACTION_MEDIA_UNSHARED:
10235                case ACTION_MEDIA_BAD_REMOVAL:
10236                case ACTION_MEDIA_UNMOUNTABLE:
10237                case ACTION_MEDIA_EJECT:
10238                case ACTION_MEDIA_SCANNER_STARTED:
10239                case ACTION_MEDIA_SCANNER_FINISHED:
10240                case ACTION_MEDIA_SCANNER_SCAN_FILE:
10241                case ACTION_PACKAGE_NEEDS_VERIFICATION:
10242                case ACTION_PACKAGE_VERIFIED:
10243                    // Ignore legacy actions
10244                    break;
10245                default:
10246                    mData.checkFileUriExposed("Intent.getData()");
10247            }
10248        }
10249
10250        if (mAction != null && mData != null && StrictMode.vmContentUriWithoutPermissionEnabled()
10251                && leavingPackage) {
10252            switch (mAction) {
10253                case ACTION_PROVIDER_CHANGED:
10254                case QuickContact.ACTION_QUICK_CONTACT:
10255                    // Ignore actions that don't need to grant
10256                    break;
10257                default:
10258                    mData.checkContentUriWithoutPermission("Intent.getData()", getFlags());
10259            }
10260        }
10261    }
10262
10263    /**
10264     * @hide
10265     */
10266    public void prepareToEnterProcess() {
10267        // We just entered destination process, so we should be able to read all
10268        // parcelables inside.
10269        setDefusable(true);
10270
10271        if (mSelector != null) {
10272            mSelector.prepareToEnterProcess();
10273        }
10274        if (mClipData != null) {
10275            mClipData.prepareToEnterProcess();
10276        }
10277
10278        if (mContentUserHint != UserHandle.USER_CURRENT) {
10279            if (UserHandle.getAppId(Process.myUid()) != Process.SYSTEM_UID) {
10280                fixUris(mContentUserHint);
10281                mContentUserHint = UserHandle.USER_CURRENT;
10282            }
10283        }
10284    }
10285
10286    /** @hide */
10287    public boolean hasWebURI() {
10288        if (getData() == null) {
10289            return false;
10290        }
10291        final String scheme = getScheme();
10292        if (TextUtils.isEmpty(scheme)) {
10293            return false;
10294        }
10295        return scheme.equals(IntentFilter.SCHEME_HTTP) || scheme.equals(IntentFilter.SCHEME_HTTPS);
10296    }
10297
10298    /** @hide */
10299    public boolean isWebIntent() {
10300        return ACTION_VIEW.equals(mAction)
10301                && hasWebURI();
10302    }
10303
10304    /**
10305     * @hide
10306     */
10307     public void fixUris(int contentUserHint) {
10308        Uri data = getData();
10309        if (data != null) {
10310            mData = maybeAddUserId(data, contentUserHint);
10311        }
10312        if (mClipData != null) {
10313            mClipData.fixUris(contentUserHint);
10314        }
10315        String action = getAction();
10316        if (ACTION_SEND.equals(action)) {
10317            final Uri stream = getParcelableExtra(EXTRA_STREAM);
10318            if (stream != null) {
10319                putExtra(EXTRA_STREAM, maybeAddUserId(stream, contentUserHint));
10320            }
10321        } else if (ACTION_SEND_MULTIPLE.equals(action)) {
10322            final ArrayList<Uri> streams = getParcelableArrayListExtra(EXTRA_STREAM);
10323            if (streams != null) {
10324                ArrayList<Uri> newStreams = new ArrayList<Uri>();
10325                for (int i = 0; i < streams.size(); i++) {
10326                    newStreams.add(maybeAddUserId(streams.get(i), contentUserHint));
10327                }
10328                putParcelableArrayListExtra(EXTRA_STREAM, newStreams);
10329            }
10330        } else if (MediaStore.ACTION_IMAGE_CAPTURE.equals(action)
10331                || MediaStore.ACTION_IMAGE_CAPTURE_SECURE.equals(action)
10332                || MediaStore.ACTION_VIDEO_CAPTURE.equals(action)) {
10333            final Uri output = getParcelableExtra(MediaStore.EXTRA_OUTPUT);
10334            if (output != null) {
10335                putExtra(MediaStore.EXTRA_OUTPUT, maybeAddUserId(output, contentUserHint));
10336            }
10337        }
10338     }
10339
10340    /**
10341     * Migrate any {@link #EXTRA_STREAM} in {@link #ACTION_SEND} and
10342     * {@link #ACTION_SEND_MULTIPLE} to {@link ClipData}. Also inspects nested
10343     * intents in {@link #ACTION_CHOOSER}.
10344     *
10345     * @return Whether any contents were migrated.
10346     * @hide
10347     */
10348    public boolean migrateExtraStreamToClipData() {
10349        // Refuse to touch if extras already parcelled
10350        if (mExtras != null && mExtras.isParcelled()) return false;
10351
10352        // Bail when someone already gave us ClipData
10353        if (getClipData() != null) return false;
10354
10355        final String action = getAction();
10356        if (ACTION_CHOOSER.equals(action)) {
10357            // Inspect contained intents to see if we need to migrate extras. We
10358            // don't promote ClipData to the parent, since ChooserActivity will
10359            // already start the picked item as the caller, and we can't combine
10360            // the flags in a safe way.
10361
10362            boolean migrated = false;
10363            try {
10364                final Intent intent = getParcelableExtra(EXTRA_INTENT);
10365                if (intent != null) {
10366                    migrated |= intent.migrateExtraStreamToClipData();
10367                }
10368            } catch (ClassCastException e) {
10369            }
10370            try {
10371                final Parcelable[] intents = getParcelableArrayExtra(EXTRA_INITIAL_INTENTS);
10372                if (intents != null) {
10373                    for (int i = 0; i < intents.length; i++) {
10374                        final Intent intent = (Intent) intents[i];
10375                        if (intent != null) {
10376                            migrated |= intent.migrateExtraStreamToClipData();
10377                        }
10378                    }
10379                }
10380            } catch (ClassCastException e) {
10381            }
10382            return migrated;
10383
10384        } else if (ACTION_SEND.equals(action)) {
10385            try {
10386                final Uri stream = getParcelableExtra(EXTRA_STREAM);
10387                final CharSequence text = getCharSequenceExtra(EXTRA_TEXT);
10388                final String htmlText = getStringExtra(EXTRA_HTML_TEXT);
10389                if (stream != null || text != null || htmlText != null) {
10390                    final ClipData clipData = new ClipData(
10391                            null, new String[] { getType() },
10392                            new ClipData.Item(text, htmlText, null, stream));
10393                    setClipData(clipData);
10394                    addFlags(FLAG_GRANT_READ_URI_PERMISSION);
10395                    return true;
10396                }
10397            } catch (ClassCastException e) {
10398            }
10399
10400        } else if (ACTION_SEND_MULTIPLE.equals(action)) {
10401            try {
10402                final ArrayList<Uri> streams = getParcelableArrayListExtra(EXTRA_STREAM);
10403                final ArrayList<CharSequence> texts = getCharSequenceArrayListExtra(EXTRA_TEXT);
10404                final ArrayList<String> htmlTexts = getStringArrayListExtra(EXTRA_HTML_TEXT);
10405                int num = -1;
10406                if (streams != null) {
10407                    num = streams.size();
10408                }
10409                if (texts != null) {
10410                    if (num >= 0 && num != texts.size()) {
10411                        // Wha...!  F- you.
10412                        return false;
10413                    }
10414                    num = texts.size();
10415                }
10416                if (htmlTexts != null) {
10417                    if (num >= 0 && num != htmlTexts.size()) {
10418                        // Wha...!  F- you.
10419                        return false;
10420                    }
10421                    num = htmlTexts.size();
10422                }
10423                if (num > 0) {
10424                    final ClipData clipData = new ClipData(
10425                            null, new String[] { getType() },
10426                            makeClipItem(streams, texts, htmlTexts, 0));
10427
10428                    for (int i = 1; i < num; i++) {
10429                        clipData.addItem(makeClipItem(streams, texts, htmlTexts, i));
10430                    }
10431
10432                    setClipData(clipData);
10433                    addFlags(FLAG_GRANT_READ_URI_PERMISSION);
10434                    return true;
10435                }
10436            } catch (ClassCastException e) {
10437            }
10438        } else if (MediaStore.ACTION_IMAGE_CAPTURE.equals(action)
10439                || MediaStore.ACTION_IMAGE_CAPTURE_SECURE.equals(action)
10440                || MediaStore.ACTION_VIDEO_CAPTURE.equals(action)) {
10441            final Uri output;
10442            try {
10443                output = getParcelableExtra(MediaStore.EXTRA_OUTPUT);
10444            } catch (ClassCastException e) {
10445                return false;
10446            }
10447            if (output != null) {
10448                setClipData(ClipData.newRawUri("", output));
10449                addFlags(FLAG_GRANT_WRITE_URI_PERMISSION|FLAG_GRANT_READ_URI_PERMISSION);
10450                return true;
10451            }
10452        }
10453
10454        return false;
10455    }
10456
10457    /**
10458     * Convert the dock state to a human readable format.
10459     * @hide
10460     */
10461    public static String dockStateToString(int dock) {
10462        switch (dock) {
10463            case EXTRA_DOCK_STATE_HE_DESK:
10464                return "EXTRA_DOCK_STATE_HE_DESK";
10465            case EXTRA_DOCK_STATE_LE_DESK:
10466                return "EXTRA_DOCK_STATE_LE_DESK";
10467            case EXTRA_DOCK_STATE_CAR:
10468                return "EXTRA_DOCK_STATE_CAR";
10469            case EXTRA_DOCK_STATE_DESK:
10470                return "EXTRA_DOCK_STATE_DESK";
10471            case EXTRA_DOCK_STATE_UNDOCKED:
10472                return "EXTRA_DOCK_STATE_UNDOCKED";
10473            default:
10474                return Integer.toString(dock);
10475        }
10476    }
10477
10478    private static ClipData.Item makeClipItem(ArrayList<Uri> streams, ArrayList<CharSequence> texts,
10479            ArrayList<String> htmlTexts, int which) {
10480        Uri uri = streams != null ? streams.get(which) : null;
10481        CharSequence text = texts != null ? texts.get(which) : null;
10482        String htmlText = htmlTexts != null ? htmlTexts.get(which) : null;
10483        return new ClipData.Item(text, htmlText, null, uri);
10484    }
10485
10486    /** @hide */
10487    public boolean isDocument() {
10488        return (mFlags & FLAG_ACTIVITY_NEW_DOCUMENT) == FLAG_ACTIVITY_NEW_DOCUMENT;
10489    }
10490}
10491