Java tutorial
/* * 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 com.elkriefy.android.apps.chubbytabby; import android.app.Activity; import android.content.ComponentName; import android.net.Uri; import android.os.Bundle; import android.support.customtabs.CustomTabsClient; import android.support.customtabs.CustomTabsIntent; import android.support.customtabs.CustomTabsServiceConnection; import android.support.customtabs.CustomTabsSession; import java.util.List; public class CustomTabActivityHelper { private CustomTabsSession mCustomTabsSession; private CustomTabsClient mClient; private CustomTabsServiceConnection mConnection; private ConnectionCallback mConnectionCallback; /** * Opens the URL on a Custom Tab if possible. Otherwise falls back to opening it on a WebView * * @param activity The host activity * @param customTabsIntent a CustomTabsIntent to be used if Custom Tabs is available * @param uri the Uri to be opened * @param fallback a CustomTabFallback to be used if Custom Tabs is not available */ public static void openCustomTab(Activity activity, CustomTabsIntent customTabsIntent, Uri uri, CustomTabFallback fallback, boolean useCustom) { if (useCustom) {//We try and use custom tabs and if we can't we drop to the webview fallback String packageName = CustomTabsHelper.getPackageNameToUse(activity); //If we cant find a package name, it means there's no browser that supports //Chrome Custom Tabs installed. So, we fallback to the webview if (packageName == null) { if (fallback != null) { fallback.openUri(activity, uri); } } else { customTabsIntent.intent.setPackage(packageName); customTabsIntent.launchUrl(activity, uri); } } else { if (fallback != null) { fallback.openUri(activity, uri); } } } /** * Unbinds the Activity from the Custom Tabs Service * * @param activity the activity that is connected to the service */ public void unbindCustomTabsService(Activity activity) { if (mConnection == null) return; activity.unbindService(mConnection); mClient = null; mCustomTabsSession = null; } /** * Creates or retrieves an exiting CustomTabsSession * * @return a CustomTabsSession */ public CustomTabsSession getSession() { if (mClient == null) { mCustomTabsSession = null; } else if (mCustomTabsSession == null) { mCustomTabsSession = mClient.newSession(null); } return mCustomTabsSession; } /** * Register a Callback to be called when connected or disconnected from the Custom Tabs Service */ public void setConnectionCallback(ConnectionCallback connectionCallback) { this.mConnectionCallback = connectionCallback; } /** * Binds the Activity to the Custom Tabs Service * * @param activity the activity to be binded to the service */ public void bindCustomTabsService(Activity activity) { if (mClient != null) return; String packageName = CustomTabsHelper.getPackageNameToUse(activity); if (packageName == null) return; mConnection = new CustomTabsServiceConnection() { @Override public void onCustomTabsServiceConnected(ComponentName name, CustomTabsClient client) { mClient = client; mClient.warmup(0L); if (mConnectionCallback != null) mConnectionCallback.onServiceConnectedCallback(); //Initialize a session as soon as possible. getSession(); } @Override public void onServiceDisconnected(ComponentName name) { mClient = null; if (mConnectionCallback != null) mConnectionCallback.onServiceDisconnectedCallback(); } }; CustomTabsClient.bindCustomTabsService(activity, packageName, mConnection); } public boolean mayLaunchUrl(Uri uri, Bundle extras, List<Bundle> otherLikelyBundles) { if (mClient == null) return false; CustomTabsSession session = getSession(); if (session == null) return false; return session.mayLaunchUrl(uri, extras, otherLikelyBundles); } /** * A Callback for when the service is connected or disconnected. Use those callbacks to handle * UI changes when the service is connected or disconnected */ public interface ConnectionCallback { /** * Called when the service is connected */ void onServiceConnectedCallback(); /** * Called when the service is disconnected */ void onServiceDisconnectedCallback(); } /** * To be used as a fallback to open the Uri when Custom Tabs is not available */ public interface CustomTabFallback { /** * @param activity The Activity that wants to open the Uri * @param uri The uri to be opened by the fallback */ void openUri(Activity activity, Uri uri); } }