/* * Copyright (C) 2015 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.support.customtabs; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.ServiceConnection; import android.content.pm.PackageManager; import android.content.pm.ResolveInfo; import android.net.Uri; import android.os.Bundle; import android.os.RemoteException; import android.support.annotation.Nullable; import android.text.TextUtils; import java.util.ArrayList; import java.util.List; /** * Class to communicate with a {@link CustomTabsService} and create * {@link CustomTabsSession} from it. */ public class CustomTabsClient { private final ICustomTabsService mService; private final ComponentName mServiceComponentName; /**@hide*/ CustomTabsClient(ICustomTabsService service, ComponentName componentName) { mService = service; mServiceComponentName = componentName; } /** * Bind to a {@link CustomTabsService} using the given package name and * {@link ServiceConnection}. * @param context {@link Context} to use while calling * {@link Context#bindService(Intent, ServiceConnection, int)} * @param packageName Package name to set on the {@link Intent} for binding. * @param connection {@link CustomTabsServiceConnection} to use when binding. This will * return a {@link CustomTabsClient} on * {@link CustomTabsServiceConnection * #onCustomTabsServiceConnected(ComponentName, CustomTabsClient)} * @return Whether the binding was successful. */ public static boolean bindCustomTabsService(Context context, String packageName, CustomTabsServiceConnection connection) { Intent intent = new Intent(CustomTabsService.ACTION_CUSTOM_TABS_CONNECTION); if (!TextUtils.isEmpty(packageName)) intent.setPackage(packageName); return context.bindService(intent, connection, Context.BIND_AUTO_CREATE | Context.BIND_WAIVE_PRIORITY); } /** * Returns the preferred package to use for Custom Tabs, preferring the default VIEW handler. * * @see {@link #getPackageName(Context, List, boolean)}. */ public static String getPackageName(Context context, @Nullable List packages) { return getPackageName(context, packages, false); } /** * Returns the preferred package to use for Custom Tabs. * * The preferred package name is the default VIEW intent handler as long as it supports Custom * Tabs. To modify this preferred behavior, set ignoreDefault to true and give a * non empty list of package names in packages. * * @param context {@link Context} to use for querying the packages. * @param packages Ordered list of packages to test for Custom Tabs support, in * decreasing order of priority. * @param ignoreDefault If set, the default VIEW handler won't get priority over other browsers. * @return The preferred package name for handling Custom Tabs, or null. */ public static String getPackageName( Context context, @Nullable List packages, boolean ignoreDefault) { PackageManager pm = context.getPackageManager(); List packageNames = packages == null ? new ArrayList() : packages; Intent activityIntent = new Intent(Intent.ACTION_VIEW, Uri.parse("http://")); if (!ignoreDefault) { ResolveInfo defaultViewHandlerInfo = pm.resolveActivity(activityIntent, 0); if (defaultViewHandlerInfo != null) { String packageName = defaultViewHandlerInfo.activityInfo.packageName; packageNames = new ArrayList(packageNames.size() + 1); packageNames.add(packageName); if (packages != null) packageNames.addAll(packages); } } Intent serviceIntent = new Intent(CustomTabsService.ACTION_CUSTOM_TABS_CONNECTION); for (String packageName : packageNames) { serviceIntent.setPackage(packageName); if (pm.resolveService(serviceIntent, 0) != null) return packageName; } return null; } /** * Connects to the Custom Tabs warmup service, and initializes the browser. * * This convenience method connects to the service, and immediately warms up the Custom Tabs * implementation. Since service connection is asynchronous, the return code is not the return * code of warmup. * This call is optional, and clients are encouraged to connect to the service, call * warmup() and create a session. In this case, calling this method is not * necessary. * * @param context {@link Context} to use to connect to the remote service. * @param packageName Package name of the target implamentation. * @return Whether the binding was successful. */ public static boolean connectAndInitialize(Context context, String packageName) { if (packageName == null) return false; final Context applicationContext = context.getApplicationContext(); CustomTabsServiceConnection connection = new CustomTabsServiceConnection() { @Override public final void onCustomTabsServiceConnected( ComponentName name, CustomTabsClient client) { client.warmup(0); // Unbinding immediately makes the target process "Empty", provided that it is // not used by anyone else, and doesn't contain any Activity. This makes it // likely to get killed, but is preferable to keeping the connection around. applicationContext.unbindService(this); } @Override public final void onServiceDisconnected(ComponentName componentName) { } }; try { return bindCustomTabsService(applicationContext, packageName, connection); } catch (SecurityException e) { return false; } } /** * Warm up the browser process. * * Allows the browser application to pre-initialize itself in the background. Significantly * speeds up URL opening in the browser. This is asynchronous and can be called several times. * * @param flags Reserved for future use. * @return Whether the warmup was successful. */ public boolean warmup(long flags) { try { return mService.warmup(flags); } catch (RemoteException e) { return false; } } /** * Creates a new session through an ICustomTabsService with the optional callback. This session * can be used to associate any related communication through the service with an intent and * then later with a Custom Tab. The client can then send later service calls or intents to * through same session-intent-Custom Tab association. * @param callback The callback through which the client will receive updates about the created * session. Can be null. * @return The session object that was created as a result of the transaction. The client can * use this to relay {@link CustomTabsSession#mayLaunchUrl(Uri, Bundle, List)} calls. * Null on error. */ public CustomTabsSession newSession(final CustomTabsCallback callback) { ICustomTabsCallback.Stub wrapper = new ICustomTabsCallback.Stub() { @Override public void onNavigationEvent(int navigationEvent, Bundle extras) { if (callback != null) callback.onNavigationEvent(navigationEvent, extras); } @Override public void extraCallback(String callbackName, Bundle args) throws RemoteException { if (callback != null) callback.extraCallback(callbackName, args); } }; try { if (!mService.newSession(wrapper)) return null; } catch (RemoteException e) { return null; } return new CustomTabsSession(mService, wrapper, mServiceComponentName); } public Bundle extraCommand(String commandName, Bundle args) { try { return mService.extraCommand(commandName, args); } catch (RemoteException e) { return null; } } }