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 /** 245ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * Listener for observing when pending intents are written to a parcel. 246ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * 247ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @hide 248ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov */ 249ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov public interface OnMarshaledListener { 250ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov /** 251ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * Called when a pending intent is written to a parcel. 252ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * 253ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @param intent The pending intent. 254ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @param parcel The parcel to which it was written. 255ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @param flags The parcel flags when it was written. 256ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov */ 257ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov void onMarshaled(PendingIntent intent, Parcel parcel, int flags); 258ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov } 259ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov 260ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov private static final ThreadLocal<OnMarshaledListener> sOnMarshaledListener 261ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov = new ThreadLocal<>(); 262ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov 263ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov /** 264ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * Registers an listener for pending intents being written to a parcel. 265ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * 266ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @param listener The listener, null to clear. 267ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * 268ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov * @hide 269ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov */ 270ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov public static void setOnMarshaledListener(OnMarshaledListener listener) { 271ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov sOnMarshaledListener.set(listener); 272ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov } 273ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov 274ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov /** 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a new activity, like calling 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that the activity will be started outside of the context of an 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 281a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 282a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 283a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 284ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 285a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the activity. 288f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Intent of the activity to be launched. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or any of the flags as supported by 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getActivity(Context context, int requestCode, 301d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 3027a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivity(context, requestCode, intent, flags, null); 3037a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 3047a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 3057a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 3067a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Retrieve a PendingIntent that will start a new activity, like calling 3077a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Context#startActivity(Intent) Context.startActivity(Intent)}. 3087a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Note that the activity will be started outside of the context of an 3097a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 3107a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. 3117a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 312a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 313a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 314a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 315ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 316a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 3177a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 3187a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 319f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 3207a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intent Intent of the activity to be launched. 3217a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 3227a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 3237a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * or any of the flags as supported by 3247a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 3257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 3267a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param options Additional options for how the Activity should be started. 3277a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * May be null if there are no options. 3287a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 3297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 3307a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 3317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 3327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 3337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivity(Context context, int requestCode, 334d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags, @Nullable Bundle options) { 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 33902ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 340344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intent.prepareToLeaveProcess(context); 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 343a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 344621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3464120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, UserHandle.myUserId()); 3474120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return target != null ? new PendingIntent(target) : null; 3484120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } catch (RemoteException e) { 3494120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3504120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn return null; 3514120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn } 3524120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn 3534120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn /** 3544120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn * @hide 35550cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 35650cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * activity is started, not when the pending intent is created. 3574120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn */ 3584120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn public static PendingIntent getActivityAsUser(Context context, int requestCode, 359d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, int flags, Bundle options, UserHandle user) { 3604120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String packageName = context.getPackageName(); 3614120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 3624120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn context.getContentResolver()) : null; 3634120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn try { 36402ffba940ca96988ed3e7774c606b43c58373b5eJeff Sharkey intent.migrateExtraStreamToClipData(); 365344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intent.prepareToLeaveProcess(context); 3664120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn IIntentSender target = 3674120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 3684120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 3694120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 3704120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 3714120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, options, user.getIdentifier()); 372621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return target != null ? new PendingIntent(target) : null; 373621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } catch (RemoteException e) { 374621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 375621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn return null; 376621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 377621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn 378621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn /** 379621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 3805313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 381621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 382621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 383621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 384621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 385621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 386621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 387621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 388621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 389621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 390621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the first in the array are started in the context of the previous activity 391621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 392621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 393621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 394621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * <p class="note"> 395621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * The <em>last</em> intent in the array represents the key for the 396621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * PendingIntent. In other words, it is the significant element for matching 397621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 398621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * its content will be the subject of replacement by 399621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 400621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * This is because it is the most specific of the supplied intents, and the 401621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * UI the user actually sees when the intents are started. 402621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * </p> 403621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 404a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 405a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 406a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 407ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 408a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 409621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param context The Context in which this PendingIntent should start 410621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * the activity. 411f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 412621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param intents Array of Intents of the activities to be launched. 413621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 414621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 415621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * or any of the flags as supported by 416621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 417621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * of the intent that can be supplied when the actual send happens. 418621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * 419621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * @return Returns an existing or new PendingIntent matching the given 420621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 421621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn * supplied. 422621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn */ 423621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 424d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags) { 4257a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn return getActivities(context, requestCode, intents, flags, null); 4267a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn } 4277a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn 4287a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn /** 4297a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Like {@link #getActivity(Context, int, Intent, int)}, but allows an 4305313c9f0271f961c439e2e3407fb66d0aabf98bbTim Hutt * array of Intents to be supplied. The last Intent in the array is 4317a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * taken as the primary key for the PendingIntent, like the single Intent 4327a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * given to {@link #getActivity(Context, int, Intent, int)}. Upon sending 4337a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the resulting PendingIntent, all of the Intents are started in the same 4347a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * way as they would be by passing them to {@link Context#startActivities(Intent[])}. 4357a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4367a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 4377a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>first</em> intent in the array will be started outside of the context of an 4387a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * existing activity, so you must use the {@link Intent#FLAG_ACTIVITY_NEW_TASK 4397a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * Intent.FLAG_ACTIVITY_NEW_TASK} launch flag in the Intent. (Activities after 4407a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the first in the array are started in the context of the previous activity 4417a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * in the array, so FLAG_ACTIVITY_NEW_TASK is not needed nor desired for them.) 4427a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 4437a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4447a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * <p class="note"> 4457a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * The <em>last</em> intent in the array represents the key for the 4467a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * PendingIntent. In other words, it is the significant element for matching 4477a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * (as done with the single intent given to {@link #getActivity(Context, int, Intent, int)}, 4487a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * its content will be the subject of replacement by 4497a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #send(Context, int, Intent)} and {@link #FLAG_UPDATE_CURRENT}, etc. 4507a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * This is because it is the most specific of the supplied intents, and the 4517a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * UI the user actually sees when the intents are started. 4527a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * </p> 4537a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 454a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} objects 455a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be <em>explicit intents</em>, 456a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 457ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 458a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 4597a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param context The Context in which this PendingIntent should start 4607a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * the activity. 461f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 4627a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param intents Array of Intents of the activities to be launched. 4637a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 4647a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 465f2acc54aad23762c9b2458bae90679147fbe3f44Svet Ganov * {@link #FLAG_IMMUTABLE} or any of the flags as supported by 4667a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 4677a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * of the intent that can be supplied when the actual send happens. 4687a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * 4697a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * @return Returns an existing or new PendingIntent matching the given 4707a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 4717a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn * supplied. 4727a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn */ 4737a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn public static PendingIntent getActivities(Context context, int requestCode, 474d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, @Flags int flags, @Nullable Bundle options) { 475621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String packageName = context.getPackageName(); 476621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn String[] resolvedTypes = new String[intents.length]; 477621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn for (int i=0; i<intents.length; i++) { 478a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 479344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intents[i].prepareToLeaveProcess(context); 480621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 481621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn } 482621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn try { 483621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn IIntentSender target = 484621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn ActivityManagerNative.getDefault().getIntentSender( 485a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 4864120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn null, null, requestCode, intents, resolvedTypes, flags, options, 4874120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn UserHandle.myUserId()); 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 495d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * @hide 496d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * Note that UserHandle.CURRENT will be interpreted at the time the 497d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell * activity is started, not when the pending intent is created. 498d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell */ 499d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell public static PendingIntent getActivitiesAsUser(Context context, int requestCode, 500d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent[] intents, int flags, Bundle options, UserHandle user) { 501d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String packageName = context.getPackageName(); 502d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell String[] resolvedTypes = new String[intents.length]; 503d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell for (int i=0; i<intents.length; i++) { 504a14acd20b8d563319ea1a5974dca0e9a29f0aaefJeff Sharkey intents[i].migrateExtraStreamToClipData(); 505344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intents[i].prepareToLeaveProcess(context); 506d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell resolvedTypes[i] = intents[i].resolveTypeIfNeeded(context.getContentResolver()); 507d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 508d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell try { 509d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell IIntentSender target = 510d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManagerNative.getDefault().getIntentSender( 511d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell ActivityManager.INTENT_SENDER_ACTIVITY, packageName, 512d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell null, null, requestCode, intents, resolvedTypes, 513d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell flags, options, user.getIdentifier()); 514d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return target != null ? new PendingIntent(target) : null; 515d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } catch (RemoteException e) { 516d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 517d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell return null; 518d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell } 519d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell 520d56b4d1db34bd6928f599e7e9a7321c2a81cb995Adam Powell /** 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will perform a broadcast, like calling 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#sendBroadcast(Intent) Context.sendBroadcast()}. 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 524a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 525a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 526a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 527ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 528a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should perform 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the broadcast. 531f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The Intent to be broadcast. 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 535f2acc54aad23762c9b2458bae90679147fbe3f44Svet Ganov * {@link #FLAG_IMMUTABLE} or any of the flags as supported by 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getBroadcast(Context context, int requestCode, 544d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye Intent intent, @Flags int flags) { 545599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani return getBroadcastAsUser(context, requestCode, intent, flags, 546599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani new UserHandle(UserHandle.myUserId())); 547599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani } 548599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani 54950cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn /** 55050cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * @hide 55150cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * Note that UserHandle.CURRENT will be interpreted at the time the 55250cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn * broadcast is sent, not when the pending intent is created. 55350cdf7c3069eb2cf82acbad73c322b7a5f3af4b1Dianne Hackborn */ 554599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani public static PendingIntent getBroadcastAsUser(Context context, int requestCode, 555599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani Intent intent, int flags, UserHandle userHandle) { 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 560344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intent.prepareToLeaveProcess(context); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 563a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_BROADCAST, packageName, 564621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 5657a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 566599dd7ce9adf8ca067cefb0b191a5ac20ec35a79Amith Yamasani flags, null, userHandle.getIdentifier()); 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a PendingIntent that will start a service, like calling 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Context#startService Context.startService()}. The start 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * arguments given to the service will come from the extras of the Intent. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 578a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">For security reasons, the {@link android.content.Intent} 579a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you supply here should almost always be an <em>explicit intent</em>, 580a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * that is specify an explicit component to be delivered to through 581ba231fcabfdf8f8bd72dbb428b8d35ae14a1a14dJohn Spurlock * {@link Intent#setClass(android.content.Context, Class) Intent.setClass}</p> 582a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context in which this PendingIntent should start 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the service. 585f15a419e70a51518e2c68e837c09c15fef09e721Danny Baumann * @param requestCode Private request code for the sender 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent An Intent describing the service to be started. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags May be {@link #FLAG_ONE_SHOT}, {@link #FLAG_NO_CREATE}, 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #FLAG_CANCEL_CURRENT}, {@link #FLAG_UPDATE_CURRENT}, 589f2acc54aad23762c9b2458bae90679147fbe3f44Svet Ganov * {@link #FLAG_IMMUTABLE} or any of the flags as supported by 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Intent#fillIn Intent.fillIn()} to control which unspecified parts 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the intent that can be supplied when the actual send happens. 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns an existing or new PendingIntent matching the given 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parameters. May return null only if {@link #FLAG_NO_CREATE} has been 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supplied. 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static PendingIntent getService(Context context, int requestCode, 598d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Intent intent, @Flags int flags) { 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String packageName = context.getPackageName(); 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? intent.resolveTypeIfNeeded( 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project context.getContentResolver()) : null; 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 603344744b49633a7f8aa0c8e43469bbfcf9d8e2cabJeff Sharkey intent.prepareToLeaveProcess(context); 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IIntentSender target = 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().getIntentSender( 606a4972e951bf2bdb7afdafee95b3ab0c15b8bacaeDianne Hackborn ActivityManager.INTENT_SENDER_SERVICE, packageName, 607621e17de87f18003aba2dedb719a2941020a7902Dianne Hackborn null, null, requestCode, new Intent[] { intent }, 6087a2195cdd33f27c79eda343defc1f7ccf59cc8acDianne Hackborn resolvedType != null ? new String[] { resolvedType } : null, 6094120375d46091df8527bb701882e056fbb0e6b06Dianne Hackborn flags, null, UserHandle.myUserId()); 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 6171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Retrieve a IntentSender object that wraps the existing sender of the PendingIntent 6181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 6191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns a IntentSender object that wraps the sender of PendingIntent 6201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 6211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 6221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender getIntentSender() { 6237f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn return new IntentSender(mTarget); 6241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 6251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel a currently active PendingIntent. Only the original application 628f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * owning a PendingIntent can cancel it. 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancel() { 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ActivityManagerNative.getDefault().cancelIntentSender(mTarget); 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send() throws CanceledException { 646a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, 0, null, null, null, null, null); 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void send(int code) throws CanceledException { 660a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, code, null, null, null, null, null); 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 671b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * original Intent. If flag {@link #FLAG_IMMUTABLE} was set when this 672b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * pending intent was created, this argument will be ignored. 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent) 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 681a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, null, null, null, null); 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to be notified when the send has completed. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent, android.app.PendingIntent.OnFinished, Handler) 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 700a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(int code, @Nullable OnFinished onFinished, @Nullable Handler handler) 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws CanceledException { 702a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(null, code, null, onFinished, handler, null, null); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform the operation associated with this PendingIntent, allowing the 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller to specify information about the Intent to use and be notified 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the send has completed. 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>For the intent parameter, a PendingIntent 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * often has restrictions on which fields can be supplied here, based on 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * how the PendingIntent was retrieved in {@link #getActivity}, 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService}. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The Context of the caller. This may be null if 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <var>intent</var> is also null. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code Result code to supply back to the PendingIntent's target. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent Additional Intent data. See {@link Intent#fillIn 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intent.fillIn()} for information on how this is applied to the 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * original Intent. Use null to not modify the original Intent. 721b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 722b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * created, this argument will be ignored. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onFinished The object to call back on when the send has 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completed, or null for no callback. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler Handler identifying the thread on which the callback 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should happen. If null, the callback will happen from the thread 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pool of the process. 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send() 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int) 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(Context, int, Intent) 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 7336c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler, String) 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CanceledException Throws CanceledException if the PendingIntent 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is no longer allowing more intents to be sent through it. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 738a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 739a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler) throws CanceledException { 740a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, onFinished, handler, null, null); 7416c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 7426c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 7436c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 7446c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 7456c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 7466c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 7476c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7486c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <p>For the intent parameter, a PendingIntent 7496c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * often has restrictions on which fields can be supplied here, based on 7506c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 7516c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 7526c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7536c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 7546c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 7556c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 7566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 7576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 7586c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 759b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 760b0a78390ed834724e9c6adf0feff9931d7f9ec10Svetoslav * created, this argument will be ignored. 7616c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 7626c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 7636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 7646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 7656c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 7666c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 7676c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 7686c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 7696c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 7706c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 7716c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7726c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send() 7736c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int) 7746c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent) 7756c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 7766c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 7776c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 7786c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 7796c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 7806c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 781a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 782a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler, 783a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable String requiredPermission) 784a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn throws CanceledException { 785a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn send(context, code, intent, onFinished, handler, requiredPermission, null); 786a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn } 787a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn 788a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn /** 789a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * Perform the operation associated with this PendingIntent, allowing the 790a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * caller to specify information about the Intent to use and be notified 791a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * when the send has completed. 792a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 793a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * <p>For the intent parameter, a PendingIntent 794a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * often has restrictions on which fields can be supplied here, based on 795a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * how the PendingIntent was retrieved in {@link #getActivity}, 796a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * {@link #getBroadcast}, or {@link #getService}. 797a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 798a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param context The Context of the caller. This may be null if 799a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * <var>intent</var> is also null. 800a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param code Result code to supply back to the PendingIntent's target. 801a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 802a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * Intent.fillIn()} for information on how this is applied to the 803a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * original Intent. Use null to not modify the original Intent. 804a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * If flag {@link #FLAG_IMMUTABLE} was set when this pending intent was 805a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * created, this argument will be ignored. 806a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param onFinished The object to call back on when the send has 807a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * completed, or null for no callback. 808a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param handler Handler identifying the thread on which the callback 809a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * should happen. If null, the callback will happen from the thread 810a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * pool of the process. 811a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 812a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * is required to hold. This is only valid for broadcast intents, and 813a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * corresponds to the permission argument in 814a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 815a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * If null, no permission is required. 816a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @param options Additional options the caller would like to provide to modify the sending 817a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * behavior. May be built from an {@link ActivityOptions} to apply to an activity start. 818a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 819a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send() 820a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(int) 821a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(Context, int, Intent) 822a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(int, android.app.PendingIntent.OnFinished, Handler) 823a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @see #send(Context, int, Intent, OnFinished, Handler) 824a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * 825a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * @throws CanceledException Throws CanceledException if the PendingIntent 826a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn * is no longer allowing more intents to be sent through it. 827a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn */ 828a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn public void send(Context context, int code, @Nullable Intent intent, 829a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable OnFinished onFinished, @Nullable Handler handler, 830a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn @Nullable String requiredPermission, @Nullable Bundle options) 8316c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws CanceledException { 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String resolvedType = intent != null ? 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.resolveTypeIfNeeded(context.getContentResolver()) 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null; 8360c4e6a8da3405f742e5cef8afdf579d58b6f1246Dianne Hackborn int res = ActivityManagerNative.getDefault().sendIntentSender( 8370c4e6a8da3405f742e5cef8afdf579d58b6f1246Dianne Hackborn mTarget, code, intent, resolvedType, 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project onFinished != null 8396c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 8406c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 841a750a63d639f6936af456df904fa6b9ba941885eDianne Hackborn requiredPermission, options); 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (res < 0) { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(); 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new CanceledException(e); 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8518832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn * @deprecated Renamed to {@link #getCreatorPackage()}. 8528832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn */ 8538832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn @Deprecated 8548832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getTargetPackage() { 8558832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn try { 8568832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return ActivityManagerNative.getDefault() 8578832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn .getPackageForIntentSender(mTarget); 8588832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } catch (RemoteException e) { 8598832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn // Should never happen. 8608832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn return null; 8618832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 8628832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn } 8638832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn 8648832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn /** 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the package name of the application that created this 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PendingIntent, that is the identity under which you will actually be 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sending the Intent. The returned string is supplied by the system, so 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an application can not spoof its package. 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 870a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 871a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 872a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 873a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 874a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 875a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 876a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 877a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 878a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The package name of the PendingIntent, or null if there is 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * none associated with it. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 882d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 8838832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public String getCreatorPackage() { 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return ActivityManagerNative.getDefault() 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .getPackageForIntentSender(mTarget); 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Should never happen. 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 894c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the uid of the application that created this 895c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the identity under which you will actually be 896c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * sending the Intent. The returned integer is supplied by the system, so 897c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its uid. 898c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 899a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 900a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 901a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 902a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 903a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 904a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 905a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 906a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 907a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 908c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * @return The uid of the PendingIntent, or -1 if there is 909c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 910c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 9118832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public int getCreatorUid() { 912c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 913c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return ActivityManagerNative.getDefault() 914c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 915c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 916c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 917c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn return -1; 918c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 919c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 920c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 921c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 922c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * Return the user handle of the application that created this 923c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * PendingIntent, that is the user under which you will actually be 92479af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * sending the Intent. The returned UserHandle is supplied by the system, so 925c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * that an application can not spoof its user. See 926c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * {@link android.os.Process#myUserHandle() Process.myUserHandle()} for 927c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * more explanation of user handles. 928c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * 929a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * <p class="note">Be careful about how you use this. All this tells you is 930a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * who created the PendingIntent. It does <strong>not</strong> tell you who 931a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * handed the PendingIntent to you: that is, PendingIntent objects are intended to be 932a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * passed between applications, so the PendingIntent you receive from an application 933a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * could actually be one it received from another application, meaning the result 934a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * you get here will identify the original application. Because of this, you should 935a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * only use this information to identify who you expect to be interacting with 936a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * through a {@link #send} call, not who gave you the PendingIntent.</p> 937a53ee35754d22e58978c9fd81396e599e00bac18Dianne Hackborn * 93879af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn * @return The user handle of the PendingIntent, or null if there is 939c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn * none associated with it. 940c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn */ 941d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 9428832c18d8b63367929c2d394c9c508f56003d400Dianne Hackborn public UserHandle getCreatorUserHandle() { 943c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn try { 944c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn int uid = ActivityManagerNative.getDefault() 945c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn .getUidForIntentSender(mTarget); 94679af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return uid > 0 ? new UserHandle(UserHandle.getUserId(uid)) : null; 947c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } catch (RemoteException e) { 948c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn // Should never happen. 94979af1dd54c16cde063152922b42c96d72ae9eca8Dianne Hackborn return null; 950c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 951c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn } 952c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn 953c7501279ee36a80fc8dc98d8eb3e6393a2217909Dianne Hackborn /** 9546c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @hide 9556c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Check to verify that this PendingIntent targets a specific package. 9566c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 9576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public boolean isTargetedToPackage() { 9586c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn try { 9596c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return ActivityManagerNative.getDefault() 9606c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn .isIntentSenderTargetedToPackage(mTarget); 9616c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } catch (RemoteException e) { 9626c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn // Should never happen. 9636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn return false; 9646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 9656c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 9666c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 9676c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 9681927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * @hide 9691927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn * Check whether this PendingIntent will launch an Activity. 9701927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn */ 9711927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn public boolean isActivity() { 9721927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn try { 9731927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return ActivityManagerNative.getDefault() 9741927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn .isIntentSenderAnActivity(mTarget); 9751927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } catch (RemoteException e) { 9761927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn // Should never happen. 9771927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn return false; 9781927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 9791927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn } 9801927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn 9811927ae8a56a010919a7535231fa0f7db70f7e152Dianne Hackborn /** 9828103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * @hide 9838103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn * Return the Intent of this PendingIntent. 9848103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn */ 9858103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn public Intent getIntent() { 9868103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn try { 9878103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return ActivityManagerNative.getDefault() 9888103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn .getIntentForIntentSender(mTarget); 9898103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } catch (RemoteException e) { 9908103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn // Should never happen. 9918103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn return null; 9928103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 9938103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn } 9948103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn 9958103890a59de6ed4abaedaad80e66666ea59f9b5Dianne Hackborn /** 996a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * @hide 997a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn * Return descriptive tag for this PendingIntent. 998a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn */ 999a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn public String getTag(String prefix) { 1000a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn try { 1001a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return ActivityManagerNative.getDefault() 1002a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn .getTagForIntentSender(mTarget, prefix); 1003a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } catch (RemoteException e) { 1004a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn // Should never happen. 1005a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn return null; 1006a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 1007a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn } 1008a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn 1009a1f1a3c573acd91024fda0ceb3b921c73b186963Dianne Hackborn /** 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Comparison operator on two PendingIntent objects, such that true 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is returned then they both represent the same operation from the 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * same package. This allows you to use {@link #getActivity}, 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #getBroadcast}, or {@link #getService} multiple times (even 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * across a process being killed), resulting in different PendingIntent 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects but whose equals() method identifies them as being the same 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation. 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object otherObj) { 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (otherObj instanceof PendingIntent) { 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().equals(((PendingIntent)otherObj) 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .mTarget.asBinder()); 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget.asBinder().hashCode(); 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 10341d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn StringBuilder sb = new StringBuilder(128); 10351d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append("PendingIntent{"); 10361d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(Integer.toHexString(System.identityHashCode(this))); 10371d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(": "); 10381d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append(mTarget != null ? mTarget.asBinder() : null); 10391d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn sb.append('}'); 10401d442e0d990b581357f33f5463c7c5cb49b551e8Dianne Hackborn return sb.toString(); 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel out, int flags) { 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(mTarget.asBinder()); 1049ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov OnMarshaledListener listener = sOnMarshaledListener.get(); 1050ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov if (listener != null) { 1051ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov listener.onMarshaled(this, out, flags); 1052ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov } 1053ddb948896ca7059161e09d0063b3332352772c0aSvet Ganov 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<PendingIntent> CREATOR 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<PendingIntent>() { 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent createFromParcel(Parcel in) { 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder target = in.readStrongBinder(); 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return target != null ? new PendingIntent(target) : null; 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PendingIntent[] newArray(int size) { 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new PendingIntent[size]; 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for writing either a PendingIntent or null pointer to 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must use this with {@link #readPendingIntentOrNullFromParcel} 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for later reading it. 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sender The PendingIntent to write, or null. 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param out Where to write the PendingIntent. 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1076d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static void writePendingIntentOrNullToParcel(@Nullable PendingIntent sender, 1077d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @NonNull Parcel out) { 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project : null); 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience function for reading either a Messenger or null pointer from 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel. You must have previously written the Messenger with 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writePendingIntentOrNullToParcel}. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param in The Parcel containing the written Messenger. 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the Messenger read from the Parcel, or null if null had 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written. 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1092d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Nullable 1093d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public static PendingIntent readPendingIntentOrNullFromParcel(@NonNull Parcel in) { 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder b = in.readStrongBinder(); 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b != null ? new PendingIntent(b) : null; 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IIntentSender target) { 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = target; 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ PendingIntent(IBinder target) { 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTarget = IIntentSender.Stub.asInterface(target); 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1106bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn /** @hide */ 1107bcbcaa7edd32ba67c6290d79f7e7821c4b5b39acDianne Hackborn public IIntentSender getTarget() { 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mTarget; 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1111