Which ChooserTargetServices are queried depends on a system-level policy decision * made at the moment the chooser is invoked, including but not limited to user time * spent with the app package or associated components in the foreground, recency of usage * or frequency of usage. These will generally correlate with the order that app targets * are shown in the list of intent handlers shown in the system chooser or resolver.
* *To extend this class, you must declare the service in your manifest file with * the {@link android.Manifest.permission#BIND_CHOOSER_TARGET_SERVICE} permission * and include an intent filter with the {@link #SERVICE_INTERFACE} action. For example:
** <service android:name=".MyChooserTargetService" * android:label="@string/service_name" * android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE"> * <intent-filter> * <action android:name="android.service.chooser.ChooserTargetService" /> * </intent-filter> * </service> ** *
For the system to query your service, you must add a <meta-data> element to the * Activity in your manifest that can handle Intents that you would also like to provide * optional deep links for. For example, a chat app might offer deep links to recent active * conversations instead of invoking a generic picker after the app itself is chosen as a target. *
* *The meta-data element should have the name
* android.service.chooser.chooser_target_service and a value corresponding to
* the component name of your service. Example:
* <activity android:name=".MyShareActivity" * android:label="@string/share_activity_label"> * <intent-filter> * <action android:name="android.intent.action.SEND" /> * </intent-filter> * <meta-data android:name="android.service.chooser.chooser_target_service" * android:value=".MyChooserTargetService" /> * </activity> **/ public abstract class ChooserTargetService extends Service { // TAG = "ChooserTargetService[MySubclass]"; private final String TAG = ChooserTargetService.class.getSimpleName() + '[' + getClass().getSimpleName() + ']'; private static final boolean DEBUG = false; /** * The Intent action that a ChooserTargetService must respond to */ @SdkConstant(SdkConstant.SdkConstantType.SERVICE_ACTION) public static final String SERVICE_INTERFACE = "android.service.chooser.ChooserTargetService"; /** * The name of the
meta-data element that must be present on an
* activity element in a manifest to link it to a ChooserTargetService
*/
public static final String META_DATA_NAME = "android.service.chooser.chooser_target_service";
/**
* The permission that a ChooserTargetService must require in order to bind to it.
* If this permission is not enforced the system will skip that ChooserTargetService.
*/
public static final String BIND_PERMISSION = "android.permission.BIND_CHOOSER_TARGET_SERVICE";
private IChooserTargetServiceWrapper mWrapper = null;
/**
* Called by the system to retrieve a set of deep-link {@link ChooserTarget targets} that
* can handle an intent.
*
* The returned list should be sorted such that the most relevant targets appear first. * The score for each ChooserTarget will be combined with the system's score for the original * target Activity to sort and filter targets presented to the user.
* *Important: Calls to this method from other applications will occur on * a binder thread, not on your app's main thread. Make sure that access to relevant data * within your app is thread-safe.
* * @param targetActivityName the ComponentName of the matched activity that referred the system * to this ChooserTargetService * @param matchedFilter the specific IntentFilter on the component that was matched * @return a list of deep-link targets to fulfill the intent match, sorted by relevance */ public abstract List