19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.IntDef; 20d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.NonNull; 21d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.Nullable; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IntentSender; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 289a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwaleimport android.os.Looper; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 349a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwaleimport android.os.Process; 35f02b60aa4f367516f40cf3d60fffae0c6fe3e1b8Dianne Hackbornimport android.os.UserHandle; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AndroidException; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 38d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.Retention; 39d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.RetentionPolicy; 40d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A description of an Intent and target action to perform with it. Instances 438832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * of this class are created with {@link #getActivity}, {@link #getActivities}, 448832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, and {@link #getService}; the returned object can be 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handed to other applications so that they can perform the action you 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * described on your behalf at a later time. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>By giving a PendingIntent to another application, 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you are granting it the right to perform the operation you have specified 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as if the other application was yourself (with the same permissions and 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identity). As such, you should be careful about how you build the PendingIntent: 52a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * almost always, for example, the base Intent you supply should have the component 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name explicitly set to one of your own components, to ensure it is ultimately 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sent there and nowhere else. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A PendingIntent itself is simply a reference to a token maintained by 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system describing the original data used to retrieve it. This means 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that, even if its owning application's process is killed, the 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent itself will remain usable from other processes that 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been given it. If the creating application later re-retrieves the 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same kind of PendingIntent (same operation, same Intent action, data, 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * categories, and components, and same flags), it will receive a PendingIntent 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing the same token if that is still valid, and can thus call 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #cancel} to remove it. 658832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 668832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>Because of this behavior, it is important to know when two Intents 678832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * are considered to be the same for purposes of retrieving a PendingIntent. 688832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * A common mistake people make is to create multiple PendingIntent objects 698832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * with Intents that only vary in their "extra" contents, expecting to get 708832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * a different PendingIntent each time. This does <em>not</em> happen. The 718832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * parts of the Intent that are used for matching are the same ones defined 728832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * by {@link Intent#filterEquals(Intent) Intent.filterEquals}. If you use two 738832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent objects that are equivalent as per 748832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, then you will get 758832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same PendingIntent for both of them. 768832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 778832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>There are two typical ways to deal with this. 788832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 798832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you truly need multiple distinct PendingIntent objects active at 808832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * the same time (such as to use as two notifications that are both shown 818832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * at the same time), then you will need to ensure there is something that 828832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * is different about them to associate them with different PendingIntents. 838832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * This may be any of the Intent attributes considered by 848832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link Intent#filterEquals(Intent) Intent.filterEquals}, or different 858832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * request code integers supplied to {@link #getActivity}, {@link #getActivities}, 868832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 878832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * 888832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * <p>If you only need one PendingIntent active at a time for any of the 898832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intents you will use, then you can alternatively use the flags 908832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT} or {@link #FLAG_UPDATE_CURRENT} to either 918832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * cancel or modify whatever current PendingIntent is associated with the 928832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * Intent you are supplying. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class PendingIntent implements Parcelable { 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IIntentSender mTarget; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 97d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye /** @hide */ 98d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @IntDef(flag = true, 99d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye value = { 100d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_ONE_SHOT, 101d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_NO_CREATE, 102d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_CANCEL_CURRENT, 103d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye FLAG_UPDATE_CURRENT, 104d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 105d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_ACTION, 106d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_DATA, 107d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_CATEGORIES, 108d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_COMPONENT, 109d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_PACKAGE, 110d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_SOURCE_BOUNDS, 111d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_SELECTOR, 112d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent.FILL_IN_CLIP_DATA 113d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye }) 114d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Retention(RetentionPolicy.SOURCE) 115d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public @interface Flags {} 116d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 118df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that this PendingIntent can be used only once. 119df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 120df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>If set, after 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #send()} is called on it, it will be automatically 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canceled for you and any future attempt to send through it will fail. 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_ONE_SHOT = 1<<30; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12687d9d1a0405e6cdbcd7c87cfebee04b622100753Katie McCormick * Flag indicating that if the described PendingIntent does not 12787d9d1a0405e6cdbcd7c87cfebee04b622100753Katie McCormick * already exist, then simply return null instead of creating it. 128df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 129df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_NO_CREATE = 1<<29; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 133df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that if the described PendingIntent already exists, 134df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * the current one should be canceled before generating a new one. 135df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * For use with {@link #getActivity}, {@link #getBroadcast}, and 136df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>You can use 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to retrieve a new PendingIntent when you are only changing the 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extra data in the Intent; by canceling the previous pending intent, 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this ensures that only entities given the new data will be able to 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * launch it. If this assurance is not an issue, consider 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_UPDATE_CURRENT}. 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_CANCEL_CURRENT = 1<<28; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 145df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Flag indicating that if the described PendingIntent already exists, 146df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * then keep it but replace its extra data with what is in this new 147df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * Intent. For use with {@link #getActivity}, {@link #getBroadcast}, and 148df75bdcc5546112958a6a5834c1a7e060f88bc68Scott Main * {@link #getService}. <p>This can be used if you are creating intents where only the 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras change, and don't care that any entities that received your 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous PendingIntent will be able to launch it with your new 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras even if they are not explicitly given to it. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FLAG_UPDATE_CURRENT = 1<<27; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 156b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * Flag indicating that the created PendingIntent should be immutable. 157b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * This means that the additional intent argument passed to the send 158b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * methods to fill in unpopulated properties of this intent will be 159b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * ignored. 160b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav */ 161b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav public static final int FLAG_IMMUTABLE = 1<<26; 162b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav 163b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav /** 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Exception thrown when trying to send through a PendingIntent that 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been canceled or is otherwise no longer able to execute the request. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class CanceledException extends AndroidException { 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException() { 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(String name) { 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(name); 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CanceledException(Exception cause) { 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(cause); 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback interface for discovering when a send operation has 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed. Primarily for use with a PendingIntent that is 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * performing a broadcast, this provides the same information as 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calling {@link Context#sendOrderedBroadcast(Intent, String, 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.content.BroadcastReceiver, Handler, int, String, Bundle) 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Context.sendBroadcast()} with a final BroadcastReceiver. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface OnFinished { 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a send operation as completed. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pendingIntent The PendingIntent this operation was sent through. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The original Intent that was sent. 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultCode The final result code determined by the send. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultData The final data collected by a broadcast. 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resultExtras The final extras collected by a broadcast. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSendFinished(PendingIntent pendingIntent, Intent intent, 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int resultCode, String resultData, Bundle resultExtras); 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static class FinishedDispatcher extends IIntentReceiver.Stub 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Runnable { 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final PendingIntent mPendingIntent; 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final OnFinished mWho; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final Handler mHandler; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Intent mIntent; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mResultCode; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mResultData; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bundle mResultExtras; 2119a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale private static Handler sDefaultSystemHandler; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project FinishedDispatcher(PendingIntent pi, OnFinished who, Handler handler) { 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPendingIntent = pi; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho = who; 2159a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale if (handler == null && ActivityThread.isSystem()) { 2169a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale // We assign a default handler for the system process to avoid deadlocks when 2179a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale // processing receivers in various components that hold global service locks. 2189a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale if (sDefaultSystemHandler == null) { 2199a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale sDefaultSystemHandler = new Handler(Looper.getMainLooper()); 2209a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale } 2219a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale mHandler = sDefaultSystemHandler; 2229a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale } else { 2239a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale mHandler = handler; 2249a6ef1e94c2c7cd937a6af668b33988057042520Wale Ogunwale } 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22620e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn public void performReceive(Intent intent, int resultCode, String data, 22720e809870d8ac1e5b848f2daf51b2272ef89bdfcDianne Hackborn Bundle extras, boolean serialized, boolean sticky, int sendingUser) { 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIntent = intent; 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultCode = resultCode; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData = data; 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultExtras = extras; 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler == null) { 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project run(); 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.post(this); 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWho.onSendFinished(mPendingIntent, mIntent, mResultCode, 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResultData, mResultExtras); 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 251a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 252a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 253a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 254ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 255a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 258f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 271d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 2727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 2737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 2747a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 2757a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 2767a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 2777a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 2797a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2807a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2817a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 282a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 283a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 284a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 285ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 286a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2877a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 2887a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 289f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 2907a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 2917a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2927a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2937a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 2947a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 2967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 2977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 2987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 2997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3007a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3017a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 304d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags, @Nullable Bundle options) { 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 30902ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 310a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 313a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 314621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3164120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 3174120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 3184120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 3194120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3204120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 3214120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3224120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 3234120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 3244120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 32550cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 32650cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * activity is started, not when the pending intent is created. 3274120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 3284120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 329d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, int flags, Bundle options, UserHandle user) { 3304120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 3314120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3324120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 3334120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 33402ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 335a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 3364120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 3374120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 3384120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3394120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3404120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3414120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 342621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 343621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 344621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 345621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 346621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 347621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 348621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 349621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3505313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 351621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 352621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 353621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 354621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 355621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 356621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 357621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 358621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 359621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 360621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 361621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 362621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 363621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 364621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 365621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 366621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 367621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 368621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 369621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 370621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 371621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 372621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 373621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 374a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 375a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 376a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 377ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 378a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 379621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 380621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 381f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 382621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 383621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 384621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 385621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 386621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 387621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 388621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 389621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 390621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 391621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 392621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 393621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 394d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags) { 3957a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 3967a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3977a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3987a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3997a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 4005313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 4017a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 4027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 4037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 4047a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 4057a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4067a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 4077a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 4087a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 4097a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 4107a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 4117a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 4127a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 4137a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4147a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 4157a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 4167a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 4177a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 4187a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 4197a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 4207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 4217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 4227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 4237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 424a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 425a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 426a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 427ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 428a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 4307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 431f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 4327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 4337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 4357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 4367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 4387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 4407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 4427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 4437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 444d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags, @Nullable Bundle options) { 445621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 446621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 447621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 448a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 449a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].prepareToLeaveProcess(); 450621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 451621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 452621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 453621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 454621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 455a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 4564120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 4574120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 465d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * @hide 466d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * Note that UserHandle.CURRENT will be interpreted at the time the 467d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * activity is started, not when the pending intent is created. 468d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell */ 469d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell public static PendingIntent getActivitiesAsUser(Context context, int requestCode, 470d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, int flags, Bundle options, UserHandle user) { 471d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String packageName = context.getPackageName(); 472d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String[] resolvedTypes = new String[intents.length]; 473d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell for (int i=0; i<intents.length; i++) { 474a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 475a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].prepareToLeaveProcess(); 476d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 477d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 478d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell try { 479d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell IIntentSender target = 480d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManagerNative.getDefault().getIntentSender( 481d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 482d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell null, null, requestCode, intents, resolvedTypes, 483d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell flags, options, user.getIdentifier()); 484d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return target != null ? new PendingIntent(target) : null; 485d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } catch (RemoteException e) { 486d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 487d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return null; 488d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 489d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell 490d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell /** 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 494a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 495a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 496a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 497ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 498a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 501f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 514d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 515599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani return getBroadcastAsUser(context, requestCode, intent, flags, 516599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani new UserHandle(UserHandle.myUserId())); 517599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani } 518599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani 51950cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn /** 52050cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * @hide 52150cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 52250cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * broadcast is sent, not when the pending intent is created. 52350cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn */ 524599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani public static PendingIntent getBroadcastAsUser(Context context, int requestCode, 525599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani Intent intent, int flags, UserHandle userHandle) { 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 530a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 533a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 534621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 536599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani flags, null, userHandle.getIdentifier()); 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 548a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 549a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 550a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 551ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 552a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 555f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 568d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 573a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intent.prepareToLeaveProcess(); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 576a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 577621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5787a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 5794120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 5871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 5881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 5901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 5911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 5921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 5937f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 5941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 5951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 598f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 616a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, 0, null, null, null, null, null); 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 630a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, code, null, null, null, null, null); 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 641b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * original Intent. If flag {@link #FLAG_IMMUTABLE} was set when this 642b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * pending intent was created, this argument will be ignored. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent) 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 651a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, null, null, null, null); 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 670a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(int code, @Nullable OnFinished onFinished, @Nullable Handler handler) 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 672a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, code, null, onFinished, handler, null, null); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 691b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 692b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * created, this argument will be ignored. 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 7036c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 708a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 709a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler) throws CanceledException { 710a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, onFinished, handler, null, null); 7116c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7126c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 7136c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 7146c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 7156c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 7166c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 7176c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7186c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 7196c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 7206c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 7216c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 7226c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 7246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 7256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 7266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 7276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 7286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 729b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 730b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * created, this argument will be ignored. 7316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 7326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 7336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 7346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 7356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 7366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 7376c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 7386c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 7396c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 7406c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 7416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 7436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 7446c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 7456c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 7466c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 7476c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7486c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 7496c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 7506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 751a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 752a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler, 753a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable String requiredPermission) 754a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn throws CanceledException { 755a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, onFinished, handler, requiredPermission, null); 756a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn } 757a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn 758a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn /** 759a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 760a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * caller to specify information about the Intent to use and be notified 761a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * when the send has completed. 762a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 763a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * <p>For the intent parameter, a PendingIntent 764a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * often has restrictions on which fields can be supplied here, based on 765a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 766a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 767a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 768a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param context The Context of the caller. This may be null if 769a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * <var>intent</var> is also null. 770a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 771a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 772a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * Intent.fillIn()} for information on how this is applied to the 773a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * original Intent. Use null to not modify the original Intent. 774a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 775a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * created, this argument will be ignored. 776a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param onFinished The object to call back on when the send has 777a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * completed, or null for no callback. 778a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param handler Handler identifying the thread on which the callback 779a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * should happen. If null, the callback will happen from the thread 780a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * pool of the process. 781a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 782a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * is required to hold. This is only valid for broadcast intents, and 783a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * corresponds to the permission argument in 784a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 785a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * If null, no permission is required. 786a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param options Additional options the caller would like to provide to modify the sending 787a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * behavior. May be built from an {@link ActivityOptions} to apply to an activity start. 788a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 789a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send() 790a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(int) 791a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(Context, int, Intent) 792a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 793a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 794a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 795a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 796a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * is no longer allowing more intents to be sent through it. 797a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn */ 798a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 799a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler, 800a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable String requiredPermission, @Nullable Bundle options) 8016c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int res = mTarget.send(code, intent, resolvedType, 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 8086c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 8096c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 810a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn requiredPermission, options); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8208832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 8218832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 8228832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 8238832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 8248832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 8258832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 8268832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 8278832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 8288832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 8298832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 8308832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 8318832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 8328832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 8338832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 839a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 840a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 841a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 842a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 843a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 844a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 845a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 846a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 847a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 851d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 8528832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 863c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 864c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 865c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 866c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 867c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 868a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 869a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 870a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 871a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 872a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 873a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 874a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 875a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 876a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 877c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 878c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 879c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 8808832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 881c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 882c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 883c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 884c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 885c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 886c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 887c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 888c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 889c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 890c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 891c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 892c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 89379af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 894c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 895c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 896c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 897c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 898a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 899a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 900a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 901a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 902a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 903a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 904a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 905a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 906a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 90779af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 908c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 909c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 910d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 9118832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 912c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 913c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 914c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 91579af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 916c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 917c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 91879af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 919c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 920c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 921c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 922c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 9236c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 9246c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 9256c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 9266c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 9276c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 9286c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 9296c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 9306c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 9316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 9326c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 9336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 9346c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 9356c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 9366c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 9371927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 9381927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 9391927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 9401927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 9411927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 9421927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 9431927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 9441927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 9451927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 9461927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 9471927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 9481927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 9491927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 9501927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 9518103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * @hide 9528103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * Return the Intent of this PendingIntent. 9538103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn */ 9548103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn public Intent getIntent() { 9558103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn try { 9568103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return ActivityManagerNative.getDefault() 9578103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn .getIntentForIntentSender(mTarget); 9588103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } catch (RemoteException e) { 9598103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn // Should never happen. 9608103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return null; 9618103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 9628103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 9638103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn 9648103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn /** 965a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * @hide 966a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * Return descriptive tag for this PendingIntent. 967a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn */ 968a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn public String getTag(String prefix) { 969a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn try { 970a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return ActivityManagerNative.getDefault() 971a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn .getTagForIntentSender(mTarget, prefix); 972a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } catch (RemoteException e) { 973a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn // Should never happen. 974a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return null; 975a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 976a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 977a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn 978a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn /** 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 10031d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 10041d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 10051d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 10061d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 10071d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 10081d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 10091d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1040d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static void writePendingIntentOrNullToParcel(@Nullable PendingIntent sender, 1041d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Parcel out) { 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1056d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 1057d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static PendingIntent readPendingIntentOrNullFromParcel(@NonNull Parcel in) { 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1070bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 1071bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1075