-
Notifications
You must be signed in to change notification settings - Fork 62
/
IntentConstant.js
8334 lines (7823 loc) · 346 KB
/
IntentConstant.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/* eslint-disable space-infix-ops */
/* eslint-disable no-multi-spaces */
/* eslint-disable quotes */
/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
// package android.content;
// import android.content.pm.ApplicationInfo;
// import android.os.ResultReceiver;
// import android.provider.MediaStore;
// import android.util.ArraySet;
// import org.xmlpull.v1.XmlPullParser;
// import org.xmlpull.v1.XmlPullParserException;
// import android.annotation.AnyRes;
// import android.annotation.IntDef;
// import android.annotation.SdkConstant;
// import android.annotation.SystemApi;
// import android.annotation.SdkConstant.SdkConstantType;
// import android.content.pm.ActivityInfo;
// import static android.content.ContentProvider.maybeAddUserId;
// import android.content.pm.PackageManager;
// import android.content.pm.ResolveInfo;
// import android.content.res.Resources;
// import android.content.res.TypedArray;
// import android.graphics.Rect;
// import android.net.Uri;
// import android.os.Bundle;
// import android.os.IBinder;
// import android.os.Parcel;
// import android.os.Parcelable;
// import android.os.Process;
// import android.os.StrictMode;
// import android.os.UserHandle;
// import android.provider.DocumentsContract;
// import android.provider.DocumentsProvider;
// import android.provider.OpenableColumns;
// import android.util.AttributeSet;
// import android.util.Log;
// import com.android.internal.util.XmlUtils;
// import org.xmlpull.v1.XmlSerializer;
// import java.io.IOException;
// import java.io.Serializable;
// import java.lang.annotation.Retention;
// import java.lang.annotation.RetentionPolicy;
// import java.net.URISyntaxException;
// import java.util.ArrayList;
// import java.util.List;
// import java.util.Locale;
// import java.util.Objects;
// import java.util.Set;
/**
* An intent is an abstract description of an operation to be performed. It
* can be used with {@link Context#startActivity(Intent) startActivity} to
* launch an {@link android.app.Activity},
* {@link android.content.Context#sendBroadcast(Intent) broadcastIntent} to
* send it to any interested {@link BroadcastReceiver BroadcastReceiver} components,
* and {@link android.content.Context#startService} or
* {@link android.content.Context#bindService} to communicate with a
* background {@link android.app.Service}.
*
* <p>An Intent provides a facility for performing late runtime binding between the code in
* different applications. Its most significant use is in the launching of activities, where it
* can be thought of as the glue between activities. It is basically a passive data structure
* holding an abstract description of an action to be performed.</p>
*
* <div class="special reference">
* <h3>Developer Guides</h3>
* <p>For information about how to create and resolve intents, read the
* <a href="{@docRoot}guide/topics/intents/intents-filters.html">Intents and Intent Filters</a>
* developer guide.</p>
* </div>
*
* <a name="IntentStructure"></a>
* <h3>Intent Structure</h3>
* <p>The primary pieces of information in an intent are:</p>
*
* <ul>
* <li> <p><b>action</b> -- The general action to be performed, such as
* {@link #ACTION_VIEW}, {@link #ACTION_EDIT}, {@link #ACTION_MAIN},
* etc.</p>
* </li>
* <li> <p><b>data</b> -- The data to operate on, such as a person record
* in the contacts database, expressed as a {@link android.net.Uri}.</p>
* </li>
* </ul>
*
*
* <p>Some examples of action/data pairs are:</p>
*
* <ul>
* <li> <p><b>{@link #ACTION_VIEW} <i>content://contacts/people/1</i></b> -- Display
* information about the person whose identifier is "1".</p>
* </li>
* <li> <p><b>{@link #ACTION_DIAL} <i>content://contacts/people/1</i></b> -- Display
* the phone dialer with the person filled in.</p>
* </li>
* <li> <p><b>{@link #ACTION_VIEW} <i>tel:123</i></b> -- Display
* the phone dialer with the given number filled in. Note how the
* VIEW action does what what is considered the most reasonable thing for
* a particular URI.</p>
* </li>
* <li> <p><b>{@link #ACTION_DIAL} <i>tel:123</i></b> -- Display
* the phone dialer with the given number filled in.</p>
* </li>
* <li> <p><b>{@link #ACTION_EDIT} <i>content://contacts/people/1</i></b> -- Edit
* information about the person whose identifier is "1".</p>
* </li>
* <li> <p><b>{@link #ACTION_VIEW} <i>content://contacts/people/</i></b> -- Display
* a list of people, which the user can browse through. This example is a
* typical top-level entry into the Contacts application, showing you the
* list of people. Selecting a particular person to view would result in a
* new intent { <b>{@link #ACTION_VIEW} <i>content://contacts/N</i></b> }
* being used to start an activity to display that person.</p>
* </li>
* </ul>
*
* <p>In addition to these primary attributes, there are a number of secondary
* attributes that you can also include with an intent:</p>
*
* <ul>
* <li> <p><b>category</b> -- Gives additional information about the action
* to execute. For example, {@link #CATEGORY_LAUNCHER} means it should
* appear in the Launcher as a top-level application, while
* {@link #CATEGORY_ALTERNATIVE} means it should be included in a list
* of alternative actions the user can perform on a piece of data.</p>
* <li> <p><b>type</b> -- Specifies an explicit type (a MIME type) of the
* intent data. Normally the type is inferred from the data itself.
* By setting this attribute, you disable that evaluation and force
* an explicit type.</p>
* <li> <p><b>component</b> -- Specifies an explicit name of a component
* class to use for the intent. Normally this is determined by looking
* at the other information in the intent (the action, data/type, and
* categories) and matching that with a component that can handle it.
* If this attribute is set then none of the evaluation is performed,
* and this component is used exactly as is. By specifying this attribute,
* all of the other Intent attributes become optional.</p>
* <li> <p><b>extras</b> -- This is a {@link Bundle} of any additional information.
* This can be used to provide extended information to the component.
* For example, if we have a action to send an e-mail message, we could
* also include extra pieces of data here to supply a subject, body,
* etc.</p>
* </ul>
*
* <p>Here are some examples of other operations you can specify as intents
* using these additional parameters:</p>
*
* <ul>
* <li> <p><b>{@link #ACTION_MAIN} with category {@link #CATEGORY_HOME}</b> --
* Launch the home screen.</p>
* </li>
* <li> <p><b>{@link #ACTION_GET_CONTENT} with MIME type
* <i>{@link android.provider.Contacts.Phones#CONTENT_URI
* vnd.android.cursor.item/phone}</i></b>
* -- Display the list of people's phone numbers, allowing the user to
* browse through them and pick one and return it to the parent activity.</p>
* </li>
* <li> <p><b>{@link #ACTION_GET_CONTENT} with MIME type
* <i>*{@literal /}*</i> and category {@link #CATEGORY_OPENABLE}</b>
* -- Display all pickers for data that can be opened with
* {@link ContentResolver#openInputStream(Uri) ContentResolver.openInputStream()},
* allowing the user to pick one of them and then some data inside of it
* and returning the resulting URI to the caller. This can be used,
* for example, in an e-mail application to allow the user to pick some
* data to include as an attachment.</p>
* </li>
* </ul>
*
* <p>There are a variety of standard Intent action and category constants
* defined in the Intent class, but applications can also define their own.
* These strings use java style scoping, to ensure they are unique -- for
* example, the standard {@link #ACTION_VIEW} is called
* "android.intent.action.VIEW".</p>
*
* <p>Put together, the set of actions, data types, categories, and extra data
* defines a language for the system allowing for the expression of phrases
* such as "call john smith's cell". As applications are added to the system,
* they can extend this language by adding new actions, types, and categories, or
* they can modify the behavior of existing phrases by supplying their own
* activities that handle them.</p>
*
* <a name="IntentResolution"></a>
* <h3>Intent Resolution</h3>
*
* <p>There are two primary forms of intents you will use.
*
* <ul>
* <li> <p><b>Explicit Intents</b> have specified a component (via
* {@link #setComponent} or {@link #setClass}), which provides the exact
* class to be run. Often these will not include any other information,
* simply being a way for an application to launch various internal
* activities it has as the user interacts with the application.
*
* <li> <p><b>Implicit Intents</b> have not specified a component;
* instead, they must include enough information for the system to
* determine which of the available components is best to run for that
* intent.
* </ul>
*
* <p>When using implicit intents, given such an arbitrary intent we need to
* know what to do with it. This is handled by the process of <em>Intent
* resolution</em>, which maps an Intent to an {@link android.app.Activity},
* {@link BroadcastReceiver}, or {@link android.app.Service} (or sometimes two or
* more activities/receivers) that can handle it.</p>
*
* <p>The intent resolution mechanism basically revolves around matching an
* Intent against all of the <intent-filter> descriptions in the
* installed application packages. (Plus, in the case of broadcasts, any {@link BroadcastReceiver}
* objects explicitly registered with {@link Context#registerReceiver}.) More
* details on this can be found in the documentation on the {@link
* IntentFilter} class.</p>
*
* <p>There are three pieces of information in the Intent that are used for
* resolution: the action, type, and category. Using this information, a query
* is done on the {@link PackageManager} for a component that can handle the
* intent. The appropriate component is determined based on the intent
* information supplied in the <code>AndroidManifest.xml</code> file as
* follows:</p>
*
* <ul>
* <li> <p>The <b>action</b>, if given, must be listed by the component as
* one it handles.</p>
* <li> <p>The <b>type</b> is retrieved from the Intent's data, if not
* already supplied in the Intent. Like the action, if a type is
* included in the intent (either explicitly or implicitly in its
* data), then this must be listed by the component as one it handles.</p>
* <li> For data that is not a <code>content:</code> URI and where no explicit
* type is included in the Intent, instead the <b>scheme</b> of the
* intent data (such as <code>http:</code> or <code>mailto:</code>) is
* considered. Again like the action, if we are matching a scheme it
* must be listed by the component as one it can handle.
* <li> <p>The <b>categories</b>, if supplied, must <em>all</em> be listed
* by the activity as categories it handles. That is, if you include
* the categories {@link #CATEGORY_LAUNCHER} and
* {@link #CATEGORY_ALTERNATIVE}, then you will only resolve to components
* with an intent that lists <em>both</em> of those categories.
* Activities will very often need to support the
* {@link #CATEGORY_DEFAULT} so that they can be found by
* {@link Context#startActivity Context.startActivity()}.</p>
* </ul>
*
* <p>For example, consider the Note Pad sample application that
* allows user to browse through a list of notes data and view details about
* individual items. Text in italics indicate places were you would replace a
* name with one specific to your own package.</p>
*
* <pre> <manifest xmlns:android="http://schemas.android.com/apk/res/android"
* package="<i>com.android.notepad</i>">
* <application android:icon="@drawable/app_notes"
* android:label="@string/app_name">
*
* <provider class=".NotePadProvider"
* android:authorities="<i>com.google.provider.NotePad</i>" />
*
* <activity class=".NotesList" android:label="@string/title_notes_list">
* <intent-filter>
* <action android:name="android.intent.action.MAIN" />
* <category android:name="android.intent.category.LAUNCHER" />
* </intent-filter>
* <intent-filter>
* <action android:name="android.intent.action.VIEW" />
* <action android:name="android.intent.action.EDIT" />
* <action android:name="android.intent.action.PICK" />
* <category android:name="android.intent.category.DEFAULT" />
* <data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" />
* </intent-filter>
* <intent-filter>
* <action android:name="android.intent.action.GET_CONTENT" />
* <category android:name="android.intent.category.DEFAULT" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter>
* </activity>
*
* <activity class=".NoteEditor" android:label="@string/title_note">
* <intent-filter android:label="@string/resolve_edit">
* <action android:name="android.intent.action.VIEW" />
* <action android:name="android.intent.action.EDIT" />
* <category android:name="android.intent.category.DEFAULT" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter>
*
* <intent-filter>
* <action android:name="android.intent.action.INSERT" />
* <category android:name="android.intent.category.DEFAULT" />
* <data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" />
* </intent-filter>
*
* </activity>
*
* <activity class=".TitleEditor" android:label="@string/title_edit_title"
* android:theme="@android:style/Theme.Dialog">
* <intent-filter android:label="@string/resolve_title">
* <action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" />
* <category android:name="android.intent.category.DEFAULT" />
* <category android:name="android.intent.category.ALTERNATIVE" />
* <category android:name="android.intent.category.SELECTED_ALTERNATIVE" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter>
* </activity>
*
* </application>
* </manifest></pre>
*
* <p>The first activity,
* <code>com.android.notepad.NotesList</code>, serves as our main
* entry into the app. It can do three things as described by its three intent
* templates:
* <ol>
* <li><pre>
* <intent-filter>
* <action android:name="{@link #ACTION_MAIN android.intent.action.MAIN}" />
* <category android:name="{@link #CATEGORY_LAUNCHER android.intent.category.LAUNCHER}" />
* </intent-filter></pre>
* <p>This provides a top-level entry into the NotePad application: the standard
* MAIN action is a main entry point (not requiring any other information in
* the Intent), and the LAUNCHER category says that this entry point should be
* listed in the application launcher.</p>
* <li><pre>
* <intent-filter>
* <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
* <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
* <action android:name="{@link #ACTION_PICK android.intent.action.PICK}" />
* <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
* <data mimeType:name="vnd.android.cursor.dir/<i>vnd.google.note</i>" />
* </intent-filter></pre>
* <p>This declares the things that the activity can do on a directory of
* notes. The type being supported is given with the <type> tag, where
* <code>vnd.android.cursor.dir/vnd.google.note</code> is a URI from which
* a Cursor of zero or more items (<code>vnd.android.cursor.dir</code>) can
* be retrieved which holds our note pad data (<code>vnd.google.note</code>).
* The activity allows the user to view or edit the directory of data (via
* the VIEW and EDIT actions), or to pick a particular note and return it
* to the caller (via the PICK action). Note also the DEFAULT category
* supplied here: this is <em>required</em> for the
* {@link Context#startActivity Context.startActivity} method to resolve your
* activity when its component name is not explicitly specified.</p>
* <li><pre>
* <intent-filter>
* <action android:name="{@link #ACTION_GET_CONTENT android.intent.action.GET_CONTENT}" />
* <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter></pre>
* <p>This filter describes the ability return to the caller a note selected by
* the user without needing to know where it came from. The data type
* <code>vnd.android.cursor.item/vnd.google.note</code> is a URI from which
* a Cursor of exactly one (<code>vnd.android.cursor.item</code>) item can
* be retrieved which contains our note pad data (<code>vnd.google.note</code>).
* The GET_CONTENT action is similar to the PICK action, where the activity
* will return to its caller a piece of data selected by the user. Here,
* however, the caller specifies the type of data they desire instead of
* the type of data the user will be picking from.</p>
* </ol>
*
* <p>Given these capabilities, the following intents will resolve to the
* NotesList activity:</p>
*
* <ul>
* <li> <p><b>{ action=android.app.action.MAIN }</b> matches all of the
* activities that can be used as top-level entry points into an
* application.</p>
* <li> <p><b>{ action=android.app.action.MAIN,
* category=android.app.category.LAUNCHER }</b> is the actual intent
* used by the Launcher to populate its top-level list.</p>
* <li> <p><b>{ action=android.intent.action.VIEW
* data=content://com.google.provider.NotePad/notes }</b>
* displays a list of all the notes under
* "content://com.google.provider.NotePad/notes", which
* the user can browse through and see the details on.</p>
* <li> <p><b>{ action=android.app.action.PICK
* data=content://com.google.provider.NotePad/notes }</b>
* provides a list of the notes under
* "content://com.google.provider.NotePad/notes", from which
* the user can pick a note whose data URL is returned back to the caller.</p>
* <li> <p><b>{ action=android.app.action.GET_CONTENT
* type=vnd.android.cursor.item/vnd.google.note }</b>
* is similar to the pick action, but allows the caller to specify the
* kind of data they want back so that the system can find the appropriate
* activity to pick something of that data type.</p>
* </ul>
*
* <p>The second activity,
* <code>com.android.notepad.NoteEditor</code>, shows the user a single
* note entry and allows them to edit it. It can do two things as described
* by its two intent templates:
* <ol>
* <li><pre>
* <intent-filter android:label="@string/resolve_edit">
* <action android:name="{@link #ACTION_VIEW android.intent.action.VIEW}" />
* <action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" />
* <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter></pre>
* <p>The first, primary, purpose of this activity is to let the user interact
* with a single note, as decribed by the MIME type
* <code>vnd.android.cursor.item/vnd.google.note</code>. The activity can
* either VIEW a note or allow the user to EDIT it. Again we support the
* DEFAULT category to allow the activity to be launched without explicitly
* specifying its component.</p>
* <li><pre>
* <intent-filter>
* <action android:name="{@link #ACTION_INSERT android.intent.action.INSERT}" />
* <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
* <data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" />
* </intent-filter></pre>
* <p>The secondary use of this activity is to insert a new note entry into
* an existing directory of notes. This is used when the user creates a new
* note: the INSERT action is executed on the directory of notes, causing
* this activity to run and have the user create the new note data which
* it then adds to the content provider.</p>
* </ol>
*
* <p>Given these capabilities, the following intents will resolve to the
* NoteEditor activity:</p>
*
* <ul>
* <li> <p><b>{ action=android.intent.action.VIEW
* data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
* shows the user the content of note <var>{ID}</var>.</p>
* <li> <p><b>{ action=android.app.action.EDIT
* data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
* allows the user to edit the content of note <var>{ID}</var>.</p>
* <li> <p><b>{ action=android.app.action.INSERT
* data=content://com.google.provider.NotePad/notes }</b>
* creates a new, empty note in the notes list at
* "content://com.google.provider.NotePad/notes"
* and allows the user to edit it. If they keep their changes, the URI
* of the newly created note is returned to the caller.</p>
* </ul>
*
* <p>The last activity,
* <code>com.android.notepad.TitleEditor</code>, allows the user to
* edit the title of a note. This could be implemented as a class that the
* application directly invokes (by explicitly setting its component in
* the Intent), but here we show a way you can publish alternative
* operations on existing data:</p>
*
* <pre>
* <intent-filter android:label="@string/resolve_title">
* <action android:name="<i>com.android.notepad.action.EDIT_TITLE</i>" />
* <category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" />
* <category android:name="{@link #CATEGORY_ALTERNATIVE android.intent.category.ALTERNATIVE}" />
* <category android:name="{@link #CATEGORY_SELECTED_ALTERNATIVE android.intent.category.SELECTED_ALTERNATIVE}" />
* <data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" />
* </intent-filter></pre>
*
* <p>In the single intent template here, we
* have created our own private action called
* <code>com.android.notepad.action.EDIT_TITLE</code> which means to
* edit the title of a note. It must be invoked on a specific note
* (data type <code>vnd.android.cursor.item/vnd.google.note</code>) like the previous
* view and edit actions, but here displays and edits the title contained
* in the note data.
*
* <p>In addition to supporting the default category as usual, our title editor
* also supports two other standard categories: ALTERNATIVE and
* SELECTED_ALTERNATIVE. Implementing
* these categories allows others to find the special action it provides
* without directly knowing about it, through the
* {@link android.content.pm.PackageManager#queryIntentActivityOptions} method, or
* more often to build dynamic menu items with
* {@link android.view.Menu#addIntentOptions}. Note that in the intent
* template here was also supply an explicit name for the template
* (via <code>android:label="@string/resolve_title"</code>) to better control
* what the user sees when presented with this activity as an alternative
* action to the data they are viewing.
*
* <p>Given these capabilities, the following intent will resolve to the
* TitleEditor activity:</p>
*
* <ul>
* <li> <p><b>{ action=com.android.notepad.action.EDIT_TITLE
* data=content://com.google.provider.NotePad/notes/<var>{ID}</var> }</b>
* displays and allows the user to edit the title associated
* with note <var>{ID}</var>.</p>
* </ul>
*
* <h3>Standard Activity Actions</h3>
*
* <p>These are the current standard actions that Intent defines for launching
* activities (usually through {@link Context#startActivity}. The most
* important, and by far most frequently used, are {@link #ACTION_MAIN} and
* {@link #ACTION_EDIT}.
*
* <ul>
* <li> {@link #ACTION_MAIN}
* <li> {@link #ACTION_VIEW}
* <li> {@link #ACTION_ATTACH_DATA}
* <li> {@link #ACTION_EDIT}
* <li> {@link #ACTION_PICK}
* <li> {@link #ACTION_CHOOSER}
* <li> {@link #ACTION_GET_CONTENT}
* <li> {@link #ACTION_DIAL}
* <li> {@link #ACTION_CALL}
* <li> {@link #ACTION_SEND}
* <li> {@link #ACTION_SENDTO}
* <li> {@link #ACTION_ANSWER}
* <li> {@link #ACTION_INSERT}
* <li> {@link #ACTION_DELETE}
* <li> {@link #ACTION_RUN}
* <li> {@link #ACTION_SYNC}
* <li> {@link #ACTION_PICK_ACTIVITY}
* <li> {@link #ACTION_SEARCH}
* <li> {@link #ACTION_WEB_SEARCH}
* <li> {@link #ACTION_FACTORY_TEST}
* </ul>
*
* <h3>Standard Broadcast Actions</h3>
*
* <p>These are the current standard actions that Intent defines for receiving
* broadcasts (usually through {@link Context#registerReceiver} or a
* <receiver> tag in a manifest).
*
* <ul>
* <li> {@link #ACTION_TIME_TICK}
* <li> {@link #ACTION_TIME_CHANGED}
* <li> {@link #ACTION_TIMEZONE_CHANGED}
* <li> {@link #ACTION_BOOT_COMPLETED}
* <li> {@link #ACTION_PACKAGE_ADDED}
* <li> {@link #ACTION_PACKAGE_CHANGED}
* <li> {@link #ACTION_PACKAGE_REMOVED}
* <li> {@link #ACTION_PACKAGE_RESTARTED}
* <li> {@link #ACTION_PACKAGE_DATA_CLEARED}
* <li> {@link #ACTION_UID_REMOVED}
* <li> {@link #ACTION_BATTERY_CHANGED}
* <li> {@link #ACTION_POWER_CONNECTED}
* <li> {@link #ACTION_POWER_DISCONNECTED}
* <li> {@link #ACTION_SHUTDOWN}
* </ul>
*
* <h3>Standard Categories</h3>
*
* <p>These are the current standard categories that can be used to further
* clarify an Intent via {@link #addCategory}.
*
* <ul>
* <li> {@link #CATEGORY_DEFAULT}
* <li> {@link #CATEGORY_BROWSABLE}
* <li> {@link #CATEGORY_TAB}
* <li> {@link #CATEGORY_ALTERNATIVE}
* <li> {@link #CATEGORY_SELECTED_ALTERNATIVE}
* <li> {@link #CATEGORY_LAUNCHER}
* <li> {@link #CATEGORY_INFO}
* <li> {@link #CATEGORY_HOME}
* <li> {@link #CATEGORY_PREFERENCE}
* <li> {@link #CATEGORY_TEST}
* <li> {@link #CATEGORY_CAR_DOCK}
* <li> {@link #CATEGORY_DESK_DOCK}
* <li> {@link #CATEGORY_LE_DESK_DOCK}
* <li> {@link #CATEGORY_HE_DESK_DOCK}
* <li> {@link #CATEGORY_CAR_MODE}
* <li> {@link #CATEGORY_APP_MARKET}
* </ul>
*
* <h3>Standard Extra Data</h3>
*
* <p>These are the current standard fields that can be used as extra data via
* {@link #putExtra}.
*
* <ul>
* <li> {@link #EXTRA_ALARM_COUNT}
* <li> {@link #EXTRA_BCC}
* <li> {@link #EXTRA_CC}
* <li> {@link #EXTRA_CHANGED_COMPONENT_NAME}
* <li> {@link #EXTRA_DATA_REMOVED}
* <li> {@link #EXTRA_DOCK_STATE}
* <li> {@link #EXTRA_DOCK_STATE_HE_DESK}
* <li> {@link #EXTRA_DOCK_STATE_LE_DESK}
* <li> {@link #EXTRA_DOCK_STATE_CAR}
* <li> {@link #EXTRA_DOCK_STATE_DESK}
* <li> {@link #EXTRA_DOCK_STATE_UNDOCKED}
* <li> {@link #EXTRA_DONT_KILL_APP}
* <li> {@link #EXTRA_EMAIL}
* <li> {@link #EXTRA_INITIAL_INTENTS}
* <li> {@link #EXTRA_INTENT}
* <li> {@link #EXTRA_KEY_EVENT}
* <li> {@link #EXTRA_ORIGINATING_URI}
* <li> {@link #EXTRA_PHONE_NUMBER}
* <li> {@link #EXTRA_REFERRER}
* <li> {@link #EXTRA_REMOTE_INTENT_TOKEN}
* <li> {@link #EXTRA_REPLACING}
* <li> {@link #EXTRA_SHORTCUT_ICON}
* <li> {@link #EXTRA_SHORTCUT_ICON_RESOURCE}
* <li> {@link #EXTRA_SHORTCUT_INTENT}
* <li> {@link #EXTRA_STREAM}
* <li> {@link #EXTRA_SHORTCUT_NAME}
* <li> {@link #EXTRA_SUBJECT}
* <li> {@link #EXTRA_TEMPLATE}
* <li> {@link #EXTRA_TEXT}
* <li> {@link #EXTRA_TITLE}
* <li> {@link #EXTRA_UID}
* </ul>
*
* <h3>Flags</h3>
*
* <p>These are the possible flags that can be used in the Intent via
* {@link #setFlags} and {@link #addFlags}. See {@link #setFlags} for a list
* of all possible flags.
*/
// public class Intent implements Parcelable, Cloneable {
export default class Intent {
static ATTR_ACTION = "action";
static TAG_CATEGORIES = "categories";
static ATTR_CATEGORY = "category";
static TAG_EXTRA = "extra";
static ATTR_TYPE = "type";
static ATTR_COMPONENT = "component";
static ATTR_DATA = "data";
static ATTR_FLAGS = "flags";
// ---------------------------------------------------------------------
// ---------------------------------------------------------------------
// Standard intent activity actions (see action variable).
/**
* Activity Action: Start as a main entry point, does not expect to
* receive data.
* <p>Input: nothing
* <p>Output: nothing
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_MAIN = "android.intent.action.MAIN";
/**
* Activity Action: Display the data to the user. This is the most common
* action performed on data -- it is the generic action you can use on
* a piece of data to get the most reasonable thing to occur. For example,
* when used on a contacts entry it will view the entry; when used on a
* mailto: URI it will bring up a compose window filled with the information
* supplied by the URI; when used with a tel: URI it will invoke the
* dialer.
* <p>Input: {@link #getData} is URI from which to retrieve data.
* <p>Output: nothing.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_VIEW = "android.intent.action.VIEW";
/**
* A synonym for {@link #ACTION_VIEW}, the "standard" action that is
* performed on a piece of data.
*/
// static ACTION_DEFAULT = Intent.ACTION_VIEW;
/**
* Used to indicate that some piece of data should be attached to some other
* place. For example, image data could be attached to a contact. It is up
* to the recipient to decide where the data should be attached; the intent
* does not specify the ultimate destination.
* <p>Input: {@link #getData} is URI of data to be attached.
* <p>Output: nothing.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_ATTACH_DATA = "android.intent.action.ATTACH_DATA";
/**
* Activity Action: Provide explicit editable access to the given data.
* <p>Input: {@link #getData} is URI of data to be edited.
* <p>Output: nothing.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_EDIT = "android.intent.action.EDIT";
/**
* Activity Action: Pick an existing item, or insert a new item, and then edit it.
* <p>Input: {@link #getType} is the desired MIME type of the item to create or edit.
* The extras can contain type specific data to pass through to the editing/creating
* activity.
* <p>Output: The URI of the item that was picked. This must be a content:
* URI so that any receiver can access it.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_INSERT_OR_EDIT = "android.intent.action.INSERT_OR_EDIT";
/**
* Activity Action: Pick an item from the data, returning what was selected.
* <p>Input: {@link #getData} is URI containing a directory of data
* (vnd.android.cursor.dir/*) from which to pick an item.
* <p>Output: The URI of the item that was picked.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_PICK = "android.intent.action.PICK";
/**
* Activity Action: Creates a shortcut.
* <p>Input: Nothing.</p>
* <p>Output: An Intent representing the shortcut. The intent must contain three
* extras: SHORTCUT_INTENT (value: Intent), SHORTCUT_NAME (value: String),
* and SHORTCUT_ICON (value: Bitmap) or SHORTCUT_ICON_RESOURCE
* (value: ShortcutIconResource).</p>
*
* @see #EXTRA_SHORTCUT_INTENT
* @see #EXTRA_SHORTCUT_NAME
* @see #EXTRA_SHORTCUT_ICON
* @see #EXTRA_SHORTCUT_ICON_RESOURCE
* @see android.content.Intent.ShortcutIconResource
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_CREATE_SHORTCUT = "android.intent.action.CREATE_SHORTCUT";
/**
* The name of the extra used to define the Intent of a shortcut.
*
* @see #ACTION_CREATE_SHORTCUT
*/
static EXTRA_SHORTCUT_INTENT = "android.intent.extra.shortcut.INTENT";
/**
* The name of the extra used to define the name of a shortcut.
*
* @see #ACTION_CREATE_SHORTCUT
*/
static EXTRA_SHORTCUT_NAME = "android.intent.extra.shortcut.NAME";
/**
* The name of the extra used to define the icon, as a Bitmap, of a shortcut.
*
* @see #ACTION_CREATE_SHORTCUT
*/
static EXTRA_SHORTCUT_ICON = "android.intent.extra.shortcut.ICON";
/**
* The name of the extra used to define the icon, as a ShortcutIconResource, of a shortcut.
*
* @see #ACTION_CREATE_SHORTCUT
* @see android.content.Intent.ShortcutIconResource
*/
static EXTRA_SHORTCUT_ICON_RESOURCE =
"android.intent.extra.shortcut.ICON_RESOURCE";
/**
* Represents a shortcut/live folder icon resource.
*
* @see Intent#ACTION_CREATE_SHORTCUT
* @see Intent#EXTRA_SHORTCUT_ICON_RESOURCE
* @see android.provider.LiveFolders#ACTION_CREATE_LIVE_FOLDER
* @see android.provider.LiveFolders#EXTRA_LIVE_FOLDER_ICON
*/
// public static class ShortcutIconResource implements Parcelable {
// /**
// * The package name of the application containing the icon.
// */
// public String packageName;
// /**
// * The resource name of the icon, including package, name and type.
// */
// public String resourceName;
// /**
// * Creates a new ShortcutIconResource for the specified context and resource
// * identifier.
// *
// * @param context The context of the application.
// * @param resourceId The resource identifier for the icon.
// * @return A new ShortcutIconResource with the specified's context package name
// * and icon resource identifier.``
// */
// public static ShortcutIconResource fromContext(Context context, @AnyRes int resourceId) {
// ShortcutIconResource icon = new ShortcutIconResource();
// icon.packageName = context.getPackageName();
// icon.resourceName = context.getResources().getResourceName(resourceId);
// return icon;
// }
// *
// * Used to read a ShortcutIconResource from a Parcel.
// public static final Parcelable.Creator<ShortcutIconResource> CREATOR =
// new Parcelable.Creator<ShortcutIconResource>() {
// public ShortcutIconResource createFromParcel(Parcel source) {
// ShortcutIconResource icon = new ShortcutIconResource();
// icon.packageName = source.readString();
// icon.resourceName = source.readString();
// return icon;
// }
// public ShortcutIconResource[] newArray(int size) {
// return new ShortcutIconResource[size];
// }
// };
// /**
// * No special parcel contents.
// */
// public int describeContents() {
// return 0;
// }
// public void writeToParcel(Parcel dest, int flags) {
// dest.writeString(packageName);
// dest.writeString(resourceName);
// }
// @Override
// public String toString() {
// return resourceName;
// }
// }
/**
* Activity Action: Display an activity chooser, allowing the user to pick
* what they want to before proceeding. This can be used as an alternative
* to the standard activity picker that is displayed by the system when
* you try to start an activity with multiple possible matches, with these
* differences in behavior:
* <ul>
* <li>You can specify the title that will appear in the activity chooser.
* <li>The user does not have the option to make one of the matching
* activities a preferred activity, and all possible activities will
* always be shown even if one of them is currently marked as the
* preferred activity.
* </ul>
* <p>
* This action should be used when the user will naturally expect to
* select an activity in order to proceed. An example if when not to use
* it is when the user clicks on a "mailto:" link. They would naturally
* expect to go directly to their mail app, so startActivity() should be
* called directly: it will
* either launch the current preferred app, or put up a dialog allowing the
* user to pick an app to use and optionally marking that as preferred.
* <p>
* In contrast, if the user is selecting a menu item to send a picture
* they are viewing to someone else, there are many different things they
* may want to do at this point: send it through e-mail, upload it to a
* web service, etc. In this case the CHOOSER action should be used, to
* always present to the user a list of the things they can do, with a
* nice title given by the caller such as "Send this photo with:".
* <p>
* If you need to grant URI permissions through a chooser, you must specify
* the permissions to be granted on the ACTION_CHOOSER Intent
* <em>in addition</em> to the EXTRA_INTENT inside. This means using
* {@link #setClipData} to specify the URIs to be granted as well as
* {@link #FLAG_GRANT_READ_URI_PERMISSION} and/or
* {@link #FLAG_GRANT_WRITE_URI_PERMISSION} as appropriate.
* <p>
* As a convenience, an Intent of this form can be created with the
* {@link #createChooser} function.
* <p>
* Input: No data should be specified. get*Extra must have
* a {@link #EXTRA_INTENT} field containing the Intent being executed,
* and can optionally have a {@link #EXTRA_TITLE} field containing the
* title text to display in the chooser.
* <p>
* Output: Depends on the protocol of {@link #EXTRA_INTENT}.
*/
// @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
static ACTION_CHOOSER = "android.intent.action.CHOOSER";
/**
* Convenience function for creating a {@link #ACTION_CHOOSER} Intent.
*
* <p>Builds a new {@link #ACTION_CHOOSER} Intent that wraps the given
* target intent, also optionally supplying a title. If the target
* intent has specified {@link #FLAG_GRANT_READ_URI_PERMISSION} or
* {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, then these flags will also be
* set in the returned chooser intent, with its ClipData set appropriately:
* either a direct reflection of {@link #getClipData()} if that is non-null,
* or a new ClipData built from {@link #getData()}.
*
* @param target The Intent that the user will be selecting an activity
* to perform.
* @param title Optional title that will be displayed in the chooser.
* @return Return a new Intent object that you can hand to
* {@link Context#startActivity(Intent) Context.startActivity()} and
* related methods.
*/
// public static Intent createChooser(Intent target, CharSequence title) {
// return createChooser(target, title, null);
// }
/**
* Convenience function for creating a {@link #ACTION_CHOOSER} Intent.
*
* <p>Builds a new {@link #ACTION_CHOOSER} Intent that wraps the given
* target intent, also optionally supplying a title. If the target
* intent has specified {@link #FLAG_GRANT_READ_URI_PERMISSION} or
* {@link #FLAG_GRANT_WRITE_URI_PERMISSION}, then these flags will also be
* set in the returned chooser intent, with its ClipData set appropriately:
* either a direct reflection of {@link #getClipData()} if that is non-null,
* or a new ClipData built from {@link #getData()}.</p>
*
* <p>The caller may optionally supply an {@link IntentSender} to receive a callback
* when the user makes a choice. This can be useful if the calling application wants
* to remember the last chosen target and surface it as a more prominent or one-touch
* affordance elsewhere in the UI for next time.</p>
*
* @param target The Intent that the user will be selecting an activity
* to perform.
* @param title Optional title that will be displayed in the chooser.
* @param sender Optional IntentSender to be called when a choice is made.
* @return Return a new Intent object that you can hand to
* {@link Context#startActivity(Intent) Context.startActivity()} and
* related methods.
*/
// public static Intent createChooser(Intent target, CharSequence title, IntentSender sender) {
// Intent intent = new Intent(ACTION_CHOOSER);
// intent.putExtra(EXTRA_INTENT, target);
// if (title != null) {
// intent.putExtra(EXTRA_TITLE, title);
// }
// if (sender != null) {
// intent.putExtra(EXTRA_CHOSEN_COMPONENT_INTENT_SENDER, sender);
// }
// // Migrate any clip data and flags from target.
// int permFlags = target.getFlags() & (FLAG_GRANT_READ_URI_PERMISSION
// | FLAG_GRANT_WRITE_URI_PERMISSION | FLAG_GRANT_PERSISTABLE_URI_PERMISSION
// | FLAG_GRANT_PREFIX_URI_PERMISSION);
// if (permFlags != 0) {
// ClipData targetClipData = target.getClipData();
// if (targetClipData == null && target.getData() != null) {
// ClipData.Item item = new ClipData.Item(target.getData());
// String[] mimeTypes;
// if (target.getType() != null) {
// mimeTypes = new String[] { target.getType() };
// } else {
// mimeTypes = new String[] { };
// }
// targetClipData = new ClipData(null, mimeTypes, item);
// }
// if (targetClipData != null) {
// intent.setClipData(targetClipData);
// intent.addFlags(permFlags);
// }
// }
// return intent;
// }
/**
* Activity Action: Allow the user to select a particular kind of data and
* return it. This is different than {@link #ACTION_PICK} in that here we
* just say what kind of data is desired, not a URI of existing data from
* which the user can pick. An ACTION_GET_CONTENT could allow the user to
* create the data as it runs (for example taking a picture or recording a
* sound), let them browse over the web and download the desired data,
* etc.
* <p>
* There are two main ways to use this action: if you want a specific kind
* of data, such as a person contact, you set the MIME type to the kind of
* data you want and launch it with {@link Context#startActivity(Intent)}.
* The system will then launch the best application to select that kind
* of data for you.
* <p>
* You may also be interested in any of a set of types of content the user
* can pick. For example, an e-mail application that wants to allow the
* user to add an attachment to an e-mail message can use this action to
* bring up a list of all of the types of content the user can attach.
* <p>
* In this case, you should wrap the GET_CONTENT intent with a chooser
* (through {@link #createChooser}), which will give the proper interface
* for the user to pick how to send your data and allow you to specify
* a prompt indicating what they are doing. You will usually specify a
* broad MIME type (such as image/* or {@literal *}/*), resulting in a
* broad range of content types the user can select from.
* <p>
* When using such a broad GET_CONTENT action, it is often desirable to
* only pick from data that can be represented as a stream. This is
* accomplished by requiring the {@link #CATEGORY_OPENABLE} in the Intent.
* <p>
* Callers can optionally specify {@link #EXTRA_LOCAL_ONLY} to request that
* the launched content chooser only returns results representing data that
* is locally available on the device. For example, if this extra is set
* to true then an image picker should not show any pictures that are available
* from a remote server but not already on the local device (thus requiring
* they be downloaded when opened).
* <p>
* If the caller can handle multiple returned items (the user performing
* multiple selection), then it can specify {@link #EXTRA_ALLOW_MULTIPLE}
* to indicate this.
* <p>
* Input: {@link #getType} is the desired MIME type to retrieve. Note
* that no URI is supplied in the intent, as there are no constraints on
* where the returned data originally comes from. You may also include the
* {@link #CATEGORY_OPENABLE} if you can only accept data that can be
* opened as a stream. You may use {@link #EXTRA_LOCAL_ONLY} to limit content
* selection to local data. You may use {@link #EXTRA_ALLOW_MULTIPLE} to
* allow the user to select multiple items.
* <p>
* Output: The URI of the item that was picked. This must be a content:
* URI so that any receiver can access it.