19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.IntDef; 20d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.NonNull; 21d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.Nullable; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IntentSender; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 33f02b60aa4f367516f40cf3d60fffae0c6fe3e1b8Dianne Hackbornimport android.os.UserHandle; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AndroidException; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 36d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.Retention; 37d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.RetentionPolicy; 38d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A description of an Intent and target action to perform with it. Instances 418832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * of this class are created with {@link #getActivity}, {@link #getActivities}, 428832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, and {@link #getService}; the returned object can be 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handed to other applications so that they can perform the action you 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * described on your behalf at a later time. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>By giving a PendingIntent to another application, 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you are granting it the right to perform the operation you have specified 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if the other application was yourself (with the same permissions and 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identity). As such, you should be careful about how you build the PendingIntent: 50a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * almost always, for example, the base Intent you supply should have the component 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name explicitly set to one of your own components, to ensure it is ultimately 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sent there and nowhere else. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A PendingIntent itself is simply a reference to a token maintained by 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system describing the original data used to retrieve it. This means 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that, even if its owning application's process is killed, the 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent itself will remain usable from other processes that 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been given it. If the creating application later re-retrieves the 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same kind of PendingIntent (same operation, same Intent action, data, 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * categories, and components, and same flags), it will receive a PendingIntent 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing the same token if that is still valid, and can thus call 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #cancel} to remove it. 638832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 648832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>Because of this behavior, it is important to know when two Intents 658832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * are considered to be the same for purposes of retrieving a PendingIntent. 668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * A common mistake people make is to create multiple PendingIntent objects 678832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * with Intents that only vary in their "extra" contents, expecting to get 688832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * a different PendingIntent each time. This does <em>not</em> happen. The 698832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * parts of the Intent that are used for matching are the same ones defined 708832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * by {@link Intent#filterEquals(Intent) Intent.filterEquals}. If you use two 718832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent objects that are equivalent as per 728832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, then you will get 738832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same PendingIntent for both of them. 748832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>There are two typical ways to deal with this. 768832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 778832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you truly need multiple distinct PendingIntent objects active at 788832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same time (such as to use as two notifications that are both shown 798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * at the same time), then you will need to ensure there is something that 808832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * is different about them to associate them with different PendingIntents. 818832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * This may be any of the Intent attributes considered by 828832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, or different 838832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * request code integers supplied to {@link #getActivity}, {@link #getActivities}, 848832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 858832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 868832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you only need one PendingIntent active at a time for any of the 878832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intents you will use, then you can alternatively use the flags 888832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT} or {@link #FLAG_UPDATE_CURRENT} to either 898832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * cancel or modify whatever current PendingIntent is associated with the 908832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent you are supplying. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class PendingIntent implements Parcelable { 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IIntentSender mTarget; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 95d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye /** @hide */ 96d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @IntDef(flag = true, 97d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye value = { 98d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_ONE_SHOT, 99d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_NO_CREATE, 100d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_CANCEL_CURRENT, 101d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_UPDATE_CURRENT, 102d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 103d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_ACTION, 104d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_DATA, 105d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_CATEGORIES, 106d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_COMPONENT, 107d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_PACKAGE, 108d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_SOURCE_BOUNDS, 109d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_SELECTOR, 110d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_CLIP_DATA 111d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye }) 112d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Retention(RetentionPolicy.SOURCE) 113d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public @interface Flags {} 114d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 116df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that this PendingIntent can be used only once. 117df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 118df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>If set, after 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #send()} is called on it, it will be automatically 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canceled for you and any future attempt to send through it will fail. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ONE_SHOT = 1<<30; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12487d9d1a0405e6cdbcd7c87cfebee04b622100753Katie McCormick * Flag indicating that if the described PendingIntent does not 12587d9d1a0405e6cdbcd7c87cfebee04b622100753Katie McCormick * already exist, then simply return null instead of creating it. 126df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 127df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_NO_CREATE = 1<<29; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 131df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that if the described PendingIntent already exists, 132df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * the current one should be canceled before generating a new one. 133df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 134df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>You can use 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to retrieve a new PendingIntent when you are only changing the 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extra data in the Intent; by canceling the previous pending intent, 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this ensures that only entities given the new data will be able to 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * launch it. If this assurance is not an issue, consider 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_UPDATE_CURRENT}. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_CANCEL_CURRENT = 1<<28; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 143df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that if the described PendingIntent already exists, 144df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * then keep it but replace its extra data with what is in this new 145df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Intent. For use with {@link #getActivity}, {@link #getBroadcast}, and 146df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>This can be used if you are creating intents where only the 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras change, and don't care that any entities that received your 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous PendingIntent will be able to launch it with your new 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras even if they are not explicitly given to it. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_UPDATE_CURRENT = 1<<27; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exception thrown when trying to send through a PendingIntent that 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been canceled or is otherwise no longer able to execute the request. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CanceledException extends AndroidException { 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException() { 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(String name) { 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(name); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(Exception cause) { 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(cause); 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for discovering when a send operation has 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed. Primarily for use with a PendingIntent that is 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performing a broadcast, this provides the same information as 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Context#sendOrderedBroadcast(Intent, String, 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.content.BroadcastReceiver, Handler, int, String, Bundle) 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.sendBroadcast()} with a final BroadcastReceiver. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnFinished { 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a send operation as completed. 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pendingIntent The PendingIntent this operation was sent through. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The original Intent that was sent. 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultCode The final result code determined by the send. 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultData The final data collected by a broadcast. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultExtras The final extras collected by a broadcast. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSendFinished(PendingIntent pendingIntent, Intent intent, 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resultCode, String resultData, Bundle resultExtras); 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static class FinishedDispatcher extends IIntentReceiver.Stub 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Runnable { 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final PendingIntent mPendingIntent; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final OnFinished mWho; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Intent mIntent; 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mResultCode; 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mResultData; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bundle mResultExtras; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project FinishedDispatcher(PendingIntent pi, OnFinished who, Handler handler) { 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPendingIntent = pi; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho = who; 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20620e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn public void performReceive(Intent intent, int resultCode, String data, 20720e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn Bundle extras, boolean serialized, boolean sticky, int sendingUser) { 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIntent = intent; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultCode = resultCode; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData = data; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultExtras = extras; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler == null) { 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project run(); 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.post(this); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho.onSendFinished(mPendingIntent, mIntent, mResultCode, 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData, mResultExtras); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 231a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 232a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 233a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 234ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 235a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 238f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 251d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 2527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 2537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2547a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2557a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2567a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 2577a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 2597a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2607a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2617a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 262a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 263a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 264a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 265ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 266a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2677a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2687a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 269f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 2707a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2717a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2797a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 2807a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2817a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 2827a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 2837a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 284d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags, @Nullable Bundle options) { 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 28902ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 290a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 293a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 294621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2964120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 2974120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 2984120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 2994120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3004120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 3014120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3024120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 3034120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 3044120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 30550cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 30650cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * activity is started, not when the pending intent is created. 3074120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 3084120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 309d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, int flags, Bundle options, UserHandle user) { 3104120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 3114120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3124120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 3134120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 31402ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 315a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 3164120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 3174120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 3184120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3194120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3204120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3214120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 322621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 323621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 324621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 325621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 326621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 327621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 328621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 329621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3305313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 331621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 332621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 333621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 334621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 335621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 336621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 337621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 338621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 339621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 340621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 341621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 342621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 343621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 344621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 345621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 346621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 347621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 348621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 349621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 350621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 351621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 352621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 353621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 354a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 355a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 356a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 357ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 358a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 359621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 360621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 361f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 362621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 363621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 364621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 365621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 366621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 367621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 368621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 369621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 370621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 371621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 372621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 373621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 374d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags) { 3757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 3767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3797a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3805313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 3817a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 3827a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 3837a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 3847a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 3857a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3867a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3877a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 3887a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 3897a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 3907a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 3917a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 3927a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3937a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3947a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 3967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 3977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 3987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 3997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 4007a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 4017a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 4027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 4037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 404a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 405a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 406a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 407ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 408a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4097a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 4107a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 411f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 4127a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 4137a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4147a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 4167a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4177a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 4187a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4197a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 4207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 4227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 4237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 424d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags, @Nullable Bundle options) { 425621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 426621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 427621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 428a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 429a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].prepareToLeaveProcess(); 430621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 431621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 432621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 433621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 434621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 435a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 4364120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 4374120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 445d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * @hide 446d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * Note that UserHandle.CURRENT will be interpreted at the time the 447d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * activity is started, not when the pending intent is created. 448d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell */ 449d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell public static PendingIntent getActivitiesAsUser(Context context, int requestCode, 450d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, int flags, Bundle options, UserHandle user) { 451d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String packageName = context.getPackageName(); 452d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String[] resolvedTypes = new String[intents.length]; 453d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell for (int i=0; i<intents.length; i++) { 454a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 455a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].prepareToLeaveProcess(); 456d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 457d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 458d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell try { 459d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell IIntentSender target = 460d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManagerNative.getDefault().getIntentSender( 461d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 462d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell null, null, requestCode, intents, resolvedTypes, 463d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell flags, options, user.getIdentifier()); 464d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return target != null ? new PendingIntent(target) : null; 465d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } catch (RemoteException e) { 466d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 467d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return null; 468d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 469d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell 470d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell /** 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 474a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 475a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 476a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 477ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 478a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 481f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 494d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 495599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani return getBroadcastAsUser(context, requestCode, intent, flags, 496599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani new UserHandle(UserHandle.myUserId())); 497599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani } 498599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani 49950cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn /** 50050cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * @hide 50150cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 50250cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * broadcast is sent, not when the pending intent is created. 50350cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn */ 504599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani public static PendingIntent getBroadcastAsUser(Context context, int requestCode, 505599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani Intent intent, int flags, UserHandle userHandle) { 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 510a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 513a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 514621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 516599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani flags, null, userHandle.getIdentifier()); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 528a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 529a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 530a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 531ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 532a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 535f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 548d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 553a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 556a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 557621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 5594120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 5671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 5681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 5701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 5721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 5737f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 5741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 5751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 578f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 5966c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, 0, null, null, null, null); 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 6106c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, null, null, null); 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent) 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 6306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, null, null, null); 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code, OnFinished onFinished, Handler handler) 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 6516c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, onFinished, handler, null); 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 6806c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent, 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnFinished onFinished, Handler handler) throws CanceledException { 6876c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, onFinished, handler, null); 6886c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 6896c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 6906c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 6916c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 6926c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 6936c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 6946c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6956c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 6966c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 6976c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 6986c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 6996c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7006c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 7016c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 7026c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 7036c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 7046c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 7056c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 7066c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 7076c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 7086c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 7096c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 7106c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 7116c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 7126c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 7136c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 7146c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 7156c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 7166c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7176c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 7186c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 7196c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 7206c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 7216c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 7226c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 7246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 7256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 7266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void send(Context context, int code, Intent intent, 7276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 7286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 7356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 7366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 7376c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7478832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 7488832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 7498832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 7508832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 7518832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 7528832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 7538832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 7548832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 7558832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 7568832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 7578832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 7588832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 7598832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 7608832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 766a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 767a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 768a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 769a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 770a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 771a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 772a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 773a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 774a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 778d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 7798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 790c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 791c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 792c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 793c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 794c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 795a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 796a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 797a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 798a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 799a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 800a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 801a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 802a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 803a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 804c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 805c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 806c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 8078832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 808c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 809c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 810c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 811c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 812c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 813c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 814c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 815c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 816c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 817c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 818c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 819c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 82079af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 821c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 822c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 823c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 824c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 825a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 826a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 827a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 828a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 829a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 830a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 831a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 832a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 833a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 83479af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 835c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 836c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 837d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 8388832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 839c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 840c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 841c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 84279af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 843c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 844c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 84579af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 846c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 847c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 848c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 849c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 8506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 8516c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 8526c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 8536c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 8546c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 8556c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 8566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 8576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 8586c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 8596c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 8606c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 8616c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 8626c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 8636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 8641927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 8651927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 8661927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 8671927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 8681927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 8691927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 8701927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 8711927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 8721927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 8731927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 8741927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 8751927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 8761927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 8771927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 8788103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * @hide 8798103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * Return the Intent of this PendingIntent. 8808103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn */ 8818103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn public Intent getIntent() { 8828103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn try { 8838103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return ActivityManagerNative.getDefault() 8848103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn .getIntentForIntentSender(mTarget); 8858103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } catch (RemoteException e) { 8868103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn // Should never happen. 8878103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return null; 8888103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 8898103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 8908103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn 8918103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn /** 892a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * @hide 893a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * Return descriptive tag for this PendingIntent. 894a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn */ 895a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn public String getTag(String prefix) { 896a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn try { 897a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return ActivityManagerNative.getDefault() 898a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn .getTagForIntentSender(mTarget, prefix); 899a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } catch (RemoteException e) { 900a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn // Should never happen. 901a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return null; 902a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 903a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 904a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn 905a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn /** 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 9301d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 9311d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 9321d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 9331d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 9341d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 9351d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 9361d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 967d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static void writePendingIntentOrNullToParcel(@Nullable PendingIntent sender, 968d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Parcel out) { 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 983d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 984d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static PendingIntent readPendingIntentOrNullFromParcel(@NonNull Parcel in) { 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 997bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 998bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1002