com.novoda.simplechromecustomtabs

Class SimpleChromeCustomTabs

java.lang.Object

com.novoda.simplechromecustomtabs.SimpleChromeCustomTabs

All Implemented Interfaces:

Connection, WebNavigator, AvailableAppProvider

public final class SimpleChromeCustomTabs
extends java.lang.Object
implements WebNavigator, Connection, AvailableAppProvider

Nested Class Summary

Nested classes/interfaces inherited from interface com.novoda.simplechromecustomtabs.navigation.WebNavigator

WebNavigator.Creator

Nested classes/interfaces inherited from interface com.novoda.simplechromecustomtabs.connection.Connection

Connection.Creator

Nested classes/interfaces inherited from interface com.novoda.simplechromecustomtabs.provider.AvailableAppProvider

AvailableAppProvider.Creator, AvailableAppProvider.PackageFoundCallback

Method Summary

Modifier and Type	Method and Description
void	connectTo(android.app.Activity activity) Connects given activity to CustomTabsService
void	disconnectFrom(android.app.Activity activity)
void	findBestPackage(AvailableAppProvider.PackageFoundCallback packageFoundCallback) Asynchronous search for the best package with support for Chrome Custom Tabs.
android.content.Context	getContext()
static SimpleChromeCustomTabs	getInstance()
Session	getSession() Get current active session for Chrome Custom Tabs usage.
static void	initialize(android.content.Context context)
boolean	isConnected()
boolean	isDisconnected()
void	mayLaunch(android.net.Uri uri) Tells SimpleChromeCustomTabs that a potential Url might be launched.
void	navigateTo(android.net.Uri url, android.app.Activity activityContext) Navigates to the given url using Chrome Custom Tabs if available.
void	release() Releases references to any set IntentCustomizer or NavigationFallback
WebNavigator	withFallback(NavigationFallback navigationFallback) Provides a NavigationFallback to specify navigation mechanism in case of no Chrome Custom Tabs support found.
WebNavigator	withIntentCustomizer(IntentCustomizer intentCustomizer) Provides a IntentCustomizer to be used to customize the Chrome Custom Tabs by attacking directly to SimpleChromeCustomTabsIntentBuilder

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static SimpleChromeCustomTabs getInstance()

initialize

public static void initialize(android.content.Context context)

getContext

public android.content.Context getContext()

withFallback

public WebNavigator withFallback(NavigationFallback navigationFallback)

Provides a NavigationFallback to specify navigation mechanism in case of no Chrome Custom Tabs support found.

Specified by:

withFallback in interface WebNavigator

Parameters:

navigationFallback -

Returns:

WebNavigator with navigation fallback.

withIntentCustomizer

public WebNavigator withIntentCustomizer(IntentCustomizer intentCustomizer)

Provides a IntentCustomizer to be used to customize the Chrome Custom Tabs by attacking directly to SimpleChromeCustomTabsIntentBuilder

Specified by:

withIntentCustomizer in interface WebNavigator

Parameters:

intentCustomizer -

Returns:

WebNavigator with customized Chrome Custom Tabs.

navigateTo

public void navigateTo(android.net.Uri url,
                       android.app.Activity activityContext)

Navigates to the given url using Chrome Custom Tabs if available. If there is no application supporting Chrome Custom Tabs and NavigationFallback is provided it will be used to redirect navigation.

Specified by:

navigateTo in interface WebNavigator

Parameters:

url -

activityContext -

release

public void release()

Releases references to any set IntentCustomizer or NavigationFallback

Specified by:

release in interface WebNavigator

connectTo

public void connectTo(@NonNull
                      android.app.Activity activity)

Connects given activity to CustomTabsService

Specified by:

connectTo in interface Connection

Parameters:

activity -

isConnected

public boolean isConnected()

Specified by:

isConnected in interface Connection

mayLaunch

public void mayLaunch(android.net.Uri uri)

Tells SimpleChromeCustomTabs that a potential Url might be launched. This will do pre DNS resolution that will speed things up but it will as well require network usage which can affect batter performance.

Specified by:

mayLaunch in interface Connection

Parameters:

uri -

getSession

public Session getSession()

Get current active session for Chrome Custom Tabs usage. Can be used to warmup particular Urls. CustomTabsSession.mayLaunchUrl(Uri, Bundle, List)

Specified by:

getSession in interface Connection

Returns:

a new CustomTabsSession or null if not connected to service.

disconnectFrom

public void disconnectFrom(@NonNull
                           android.app.Activity activity)

Specified by:

disconnectFrom in interface Connection

isDisconnected

public boolean isDisconnected()

Specified by:

isDisconnected in interface Connection

findBestPackage

public void findBestPackage(@NonNull
                            AvailableAppProvider.PackageFoundCallback packageFoundCallback)

Asynchronous search for the best package with support for Chrome Custom Tabs.

Specified by:

findBestPackage in interface AvailableAppProvider

Parameters:

packageFoundCallback -