PendingIntent.java revision 8832c18d8b63367929c2d394c9c508f56003d400
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: 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often, for example, the base Intent you supply will 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 * 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 2207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 2217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2247a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 2257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2267a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 2277a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2287a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 2327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 2337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 2347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 2447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 2467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 2477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 2487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent intent, int flags, Bundle options) { 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2539ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 256a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 257621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2594120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 2604120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 2614120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 2624120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2634120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 2644120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 2654120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 2664120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 2674120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 2684120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 2694120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 2704120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn Intent intent, int flags, Bundle options, UserHandle user) { 2714120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 2724120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 2734120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 2744120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 2754120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn intent.setAllowFds(false); 2764120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 2774120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 2784120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 2794120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 2804120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 2814120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 282621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 283621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 284621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 285621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 286621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 287621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 288621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 289621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 290621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * array of Intents to be supplied. The first Intent in the array is 291621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 292621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 293621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 294621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 295621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 296621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 297621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 298621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 299621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 300621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 301621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 302621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 303621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 304621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 305621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 306621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 307621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 308621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 309621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 310621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 311621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 312621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 313621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 314621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 315621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 316621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param requestCode Private request code for the sender (currently 317621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * not used). 318621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 319621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 320621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 321621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 322621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 323621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 324621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 325621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 326621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 327621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 328621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 329621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 330621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn Intent[] intents, int flags) { 3317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 3327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * array of Intents to be supplied. The first Intent in the array is 3377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 3387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 3397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 3407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 3417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 3447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 3457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 3467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 3477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 3487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3497a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3507a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 3517a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 3527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 3537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 3547a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 3557a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 3567a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 3577a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 3587a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 3597a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3607a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 3617a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 3627a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param requestCode Private request code for the sender (currently 3637a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * not used). 3647a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 3657a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3667a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3677a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 3687a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3697a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 3707a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3717a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 3767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn Intent[] intents, int flags, Bundle options) { 377621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 378621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 379621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 3809ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intents[i].setAllowFds(false); 381621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 382621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 383621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 384621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 385621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 386a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3874120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 3884120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4209ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 423a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 424621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 4264120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param requestCode Private request code for the sender (currently 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not used). 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent, int flags) { 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4599ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn intent.setAllowFds(false); 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 462a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 463621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 4647a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 4654120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 4731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 4741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 4761ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 4771ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 4781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 4797f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 4801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 4811ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 484f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 5026c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, 0, null, null, null, null); 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 5166c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, null, null, null); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent) 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 5366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, null, null, null); 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code, OnFinished onFinished, Handler handler) 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 5576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(null, code, null, onFinished, handler, null); 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 5866c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(Context context, int code, Intent intent, 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project OnFinished onFinished, Handler handler) throws CanceledException { 5936c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn send(context, code, intent, onFinished, handler, null); 5946c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 5956c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 5966c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 5976c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 5986c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 5996c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 6006c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6016c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 6026c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 6036c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 6046c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 6056c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6066c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 6076c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 6086c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 6096c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 6106c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 6116c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 6126c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 6136c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 6146c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 6156c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 6166c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 6176c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 6186c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 6196c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 6206c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 6216c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 6226c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 6246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 6256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 6266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 6276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 6286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 6296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 6306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 6316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 6326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void send(Context context, int code, Intent intent, 6336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 6346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 6416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 6426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 6436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6538832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 6548832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 6558832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 6568832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 6578832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 6588832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 6598832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 6608832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 6618832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 6628832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 6638832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 6648832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 6658832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 6668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 686c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 687c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 688c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 689c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 690c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 691c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 692c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 693c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 6948832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 695c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 696c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 697c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 698c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 699c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 700c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 701c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 702c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 703c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 704c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 705c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 706c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 70779af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 708c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 709c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 710c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 711c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 71279af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 713c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 714c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 7158832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 716c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 717c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 718c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 71979af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 720c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 721c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 72279af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 723c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 724c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 725c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 726c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 7276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 7286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 7296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 7306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 7316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 7326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 7336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 7346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 7356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 7366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 7376c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7386c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7396c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 7406c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 7411927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 7421927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 7431927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 7441927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 7451927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 7461927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 7471927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 7481927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 7491927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 7501927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 7511927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 7521927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 7531927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 7541927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 7791d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 7801d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 7811d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 7821d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 7831d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 7841d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 7851d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void writePendingIntentOrNullToParcel(PendingIntent sender, 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel out) { 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent readPendingIntentOrNullFromParcel(Parcel in) { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 845bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 846bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 850