PendingIntent.java revision 02ffba940ca96988ed3e7774c606b43c58373b5e
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 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IntentSender; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 30f02b60aa4f367516f40cf3d60fffae0c6fe3e1b8Dianne Hackbornimport android.os.UserHandle; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AndroidException; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A description of an Intent and target action to perform with it. Instances 358832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * of this class are created with {@link #getActivity}, {@link #getActivities}, 368832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, and {@link #getService}; the returned object can be 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handed to other applications so that they can perform the action you 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * described on your behalf at a later time. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>By giving a PendingIntent to another application, 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you are granting it the right to perform the operation you have specified 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if the other application was yourself (with the same permissions and 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identity). As such, you should be careful about how you build the PendingIntent: 44a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * almost always, for example, the base Intent you supply should have the component 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name explicitly set to one of your own components, to ensure it is ultimately 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sent there and nowhere else. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A PendingIntent itself is simply a reference to a token maintained by 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system describing the original data used to retrieve it. This means 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that, even if its owning application's process is killed, the 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent itself will remain usable from other processes that 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been given it. If the creating application later re-retrieves the 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same kind of PendingIntent (same operation, same Intent action, data, 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * categories, and components, and same flags), it will receive a PendingIntent 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing the same token if that is still valid, and can thus call 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #cancel} to remove it. 578832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 588832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>Because of this behavior, it is important to know when two Intents 598832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * are considered to be the same for purposes of retrieving a PendingIntent. 608832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * A common mistake people make is to create multiple PendingIntent objects 618832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * with Intents that only vary in their "extra" contents, expecting to get 628832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * a different PendingIntent each time. This does <em>not</em> happen. The 638832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * parts of the Intent that are used for matching are the same ones defined 648832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * by {@link Intent#filterEquals(Intent) Intent.filterEquals}. If you use two 658832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent objects that are equivalent as per 668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, then you will get 678832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same PendingIntent for both of them. 688832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 698832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>There are two typical ways to deal with this. 708832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 718832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you truly need multiple distinct PendingIntent objects active at 728832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same time (such as to use as two notifications that are both shown 738832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * at the same time), then you will need to ensure there is something that 748832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * is different about them to associate them with different PendingIntents. 758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * This may be any of the Intent attributes considered by 768832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, or different 778832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * request code integers supplied to {@link #getActivity}, {@link #getActivities}, 788832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 808832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you only need one PendingIntent active at a time for any of the 818832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intents you will use, then you can alternatively use the flags 828832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT} or {@link #FLAG_UPDATE_CURRENT} to either 838832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * cancel or modify whatever current PendingIntent is associated with the 848832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent you are supplying. 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class PendingIntent implements Parcelable { 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IIntentSender mTarget; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: this 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent can only be used once. If set, after 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #send()} is called on it, it will be automatically 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canceled for you and any future attempt to send through it will fail. 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ONE_SHOT = 1<<30; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent does not already 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exist, then simply return null instead of creating it. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_NO_CREATE = 1<<29; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current one is canceled before generating a new one. You can use 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to retrieve a new PendingIntent when you are only changing the 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extra data in the Intent; by canceling the previous pending intent, 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this ensures that only entities given the new data will be able to 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * launch it. If this assurance is not an issue, consider 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_UPDATE_CURRENT}. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_CANCEL_CURRENT = 1<<28; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flag for use with {@link #getActivity}, {@link #getBroadcast}, and 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getService}: if the described PendingIntent already exists, 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then keep it but its replace its extra data with what is in this new 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent. This can be used if you are creating intents where only the 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras change, and don't care that any entities that received your 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous PendingIntent will be able to launch it with your new 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras even if they are not explicitly given to it. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_UPDATE_CURRENT = 1<<27; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exception thrown when trying to send through a PendingIntent that 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been canceled or is otherwise no longer able to execute the request. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CanceledException extends AndroidException { 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException() { 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(String name) { 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(name); 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(Exception cause) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(cause); 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for discovering when a send operation has 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed. Primarily for use with a PendingIntent that is 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performing a broadcast, this provides the same information as 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Context#sendOrderedBroadcast(Intent, String, 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.content.BroadcastReceiver, Handler, int, String, Bundle) 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.sendBroadcast()} with a final BroadcastReceiver. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnFinished { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a send operation as completed. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pendingIntent The PendingIntent this operation was sent through. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The original Intent that was sent. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultCode The final result code determined by the send. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultData The final data collected by a broadcast. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultExtras The final extras collected by a broadcast. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSendFinished(PendingIntent pendingIntent, Intent intent, 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resultCode, String resultData, Bundle resultExtras); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static class FinishedDispatcher extends IIntentReceiver.Stub 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Runnable { 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final PendingIntent mPendingIntent; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final OnFinished mWho; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Intent mIntent; 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mResultCode; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mResultData; 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bundle mResultExtras; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project FinishedDispatcher(PendingIntent pi, OnFinished who, Handler handler) { 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPendingIntent = pi; 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho = who; 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17820e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn public void performReceive(Intent intent, int resultCode, String data, 17920e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn Bundle extras, boolean serialized, boolean sticky, int sendingUser) { 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIntent = intent; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultCode = resultCode; 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData = data; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultExtras = extras; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler == null) { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project run(); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.post(this); 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho.onSendFinished(mPendingIntent, mIntent, mResultCode, 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData, mResultExtras); 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 203a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 204a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 205a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 206a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 207a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 2257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 2267a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2277a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2287a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 2307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 2327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 235a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 236a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 237a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 238a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 239a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 2427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 2437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 2447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2497a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2507a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2517a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 2547a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2557a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 2567a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 2577a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 2587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent intent, int flags, Bundle options) { 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2639ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 26402ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 267a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 268621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2697a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2704120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 2714120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 2724120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 2734120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2744120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 2754120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2764120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 2774120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 2784120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 27950cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 28050cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * activity is started, not when the pending intent is created. 2814120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 2824120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 2834120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn Intent intent, int flags, Bundle options, UserHandle user) { 2844120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 2854120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2864120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 2874120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 2884120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn intent.setAllowFds(false); 28902ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 2904120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 2914120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 2924120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 2934120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2944120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2954120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 296621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 297621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 298621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 299621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 300621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 301621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 302621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 303621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3045313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 305621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 306621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 307621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 308621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 309621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 310621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 311621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 312621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 313621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 314621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 315621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 316621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 317621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 318621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 319621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 320621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 321621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 322621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 323621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 324621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 325621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 326621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 327621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 328a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 329a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 330a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 331a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 332a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 333621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 334621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 335621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param requestCode Private request code for the sender (currently 336621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * not used). 337621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 338621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 339621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 340621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 341621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 342621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 343621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 344621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 345621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 346621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 347621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 348621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 349621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn Intent[] intents, int flags) { 3507a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 3517a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3547a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3555313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 3567a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 3577a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 3587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 3597a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 3607a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3617a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3627a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 3637a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 3647a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 3657a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 3667a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 3677a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3687a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3697a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3707a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 3717a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 3727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 3737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 3747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 3757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 3767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 3777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 379a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 380a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 381a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 382a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 383a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 3847a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 3857a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 3867a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 3877a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 3887a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 3897a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3907a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3917a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 3927a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3937a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 3947a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 4007a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent[] intents, int flags, Bundle options) { 401621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 402621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 403621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 4049ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intents[i].setAllowFds(false); 405621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 406621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 407621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 408621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 409621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 410a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 4114120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 4124120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 420d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * @hide 421d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * Note that UserHandle.CURRENT will be interpreted at the time the 422d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * activity is started, not when the pending intent is created. 423d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell */ 424d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell public static PendingIntent getActivitiesAsUser(Context context, int requestCode, 425d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell Intent[] intents, int flags, Bundle options, UserHandle user) { 426d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String packageName = context.getPackageName(); 427d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String[] resolvedTypes = new String[intents.length]; 428d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell for (int i=0; i<intents.length; i++) { 429d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell intents[i].setAllowFds(false); 430d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 431d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 432d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell try { 433d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell IIntentSender target = 434d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManagerNative.getDefault().getIntentSender( 435d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 436d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell null, null, requestCode, intents, resolvedTypes, 437d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell flags, options, user.getIdentifier()); 438d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return target != null ? new PendingIntent(target) : null; 439d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } catch (RemoteException e) { 440d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 441d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return null; 442d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 443d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell 444d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell /** 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 448a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 449a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 450a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 451a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 452a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 470599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani return getBroadcastAsUser(context, requestCode, intent, flags, 471599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani new UserHandle(UserHandle.myUserId())); 472599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani } 473599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani 47450cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn /** 47550cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * @hide 47650cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 47750cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * broadcast is sent, not when the pending intent is created. 47850cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn */ 479599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani public static PendingIntent getBroadcastAsUser(Context context, int requestCode, 480599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani Intent intent, int flags, UserHandle userHandle) { 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4859ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 488a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 489621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4907a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 491599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani flags, null, userHandle.getIdentifier()); 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 503a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 504a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 505a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 506a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * {@link Intent#setClass(android.content.Context, Class)} Intent.setClass</p> 507a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5299ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 532a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 533621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 5354120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 5431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 5441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 5461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 5481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 5497f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 5501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 5511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 554f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 5726c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, 0, null, null, null, null); 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 5866c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, null, null, null); 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent) 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 6066c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, null, null, null); 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code, OnFinished onFinished, Handler handler) 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 6276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, onFinished, handler, null); 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 6566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent, 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnFinished onFinished, Handler handler) throws CanceledException { 6636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, onFinished, handler, null); 6646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 6656c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 6666c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 6676c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 6686c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 6696c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 6706c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6716c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 6726c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 6736c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 6746c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 6756c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6766c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 6776c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 6786c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 6796c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 6806c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 6816c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 6826c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 6836c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 6846c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 6856c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 6866c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 6876c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 6886c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 6896c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 6906c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 6916c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 6926c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6936c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 6946c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 6956c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 6966c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 6976c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 6986c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6996c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 7006c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 7016c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 7026c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void send(Context context, int code, Intent intent, 7036c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 7046c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 7116c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 7126c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 7136c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7238832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 7248832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 7258832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 7268832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 7278832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 7288832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 7298832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 7308832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 7318832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 7328832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 7338832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 7348832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 7358832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 7368832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 742a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 743a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 744a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 745a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 746a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 747a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 748a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 749a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 750a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7548832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 765c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 766c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 767c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 768c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 769c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 770a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 771a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 772a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 773a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 774a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 775a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 776a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 777a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 778a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 779c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 780c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 781c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 7828832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 783c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 784c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 785c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 786c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 787c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 788c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 789c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 790c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 791c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 792c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 793c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 794c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 79579af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 796c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 797c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 798c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 799c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 800a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 801a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 802a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 803a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 804a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 805a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 806a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 807a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 808a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 80979af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 810c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 811c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 8128832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 813c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 814c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 815c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 81679af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 817c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 818c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 81979af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 820c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 821c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 822c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 823c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 8246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 8256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 8266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 8276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 8286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 8296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 8306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 8316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 8326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 8336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 8346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 8356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 8366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 8376c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 8381927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 8391927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 8401927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 8411927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 8421927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 8431927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 8441927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 8451927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 8461927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 8471927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 8481927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 8491927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 8501927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 8511927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 8528103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * @hide 8538103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * Return the Intent of this PendingIntent. 8548103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn */ 8558103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn public Intent getIntent() { 8568103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn try { 8578103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return ActivityManagerNative.getDefault() 8588103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn .getIntentForIntentSender(mTarget); 8598103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } catch (RemoteException e) { 8608103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn // Should never happen. 8618103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return null; 8628103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 8638103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 8648103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn 8658103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn /** 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 8901d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 8911d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 8921d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 8931d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 8941d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 8951d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 8961d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void writePendingIntentOrNullToParcel(PendingIntent sender, 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel out) { 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent readPendingIntentOrNullFromParcel(Parcel in) { 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 956bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 957bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 961