simple-chrome-custom-tabs

Project Url: novoda/simple-chrome-custom-tabs

Introduction: Easy integration of Chrome Custom Tabs into your project. Just connect it to your activity, and navigate to the external website styling your tab as you wish.

More: Author ReportBugs

Tags:

simple-chrome-custom-tabs

Navigating to external websites from your app?
"Yes, that one is easy"
Wondering how to keep the user in context?
"I know... it can be done using WebView, but I don't like it that much"
Aha! Why don't you try Chrome Custom Tabs?
"Integrating it into my app can be a pain..."
Not anymore!

simple-chrome-custom-tabs will help you with that.

Description

simple-chrome-custom-tabs provides easy integration of Chrome Custom Tabs into your project. Just connect it to your activity, and navigate to the external website styling your tab as you wish. Moreover with Custom Tabs the navigation can be nearly instantaneous!

More information about Chrome Custom Tabs available at: https://developer.chrome.com/multidevice/android/customtabs

Adding to your project

To start using this library, add these lines to the build.gradle of your project:

repositories {
    maven {
        url  "http://dl.bintray.com/novoda/maven" 
    }
}

dependencies {
    compile 'com.novoda:simple-chrome-custom-tabs:0.1.6'
}

Simple usage

1) Initialize simple-chrome-custom-tabs, you only have to this once.

SimpleChromeCustomTabs.initialize(context);

2) Connect simple-chrome-custom-tabs to your Activity as soon as it is resumed.

@Override
public void onResume() {
    super.onResume();
    SimpleChromeCustomTabs.getInstance().connectTo(this);
}

And don't forget to disconnect when the Activity is paused.

@Override
public void onPause() {
    SimpleChromeCustomTabs.getInstance().disconnectFrom(this);
    super.onPause();
}

3) Navigate!

Uri url = ANY_WEBSITE_URL;
NavigationFallback fallback = ANY_FALLBACK_MECHANISM; //In case something goes wrong.
IntentCustomizer customizer = ANY_INTENT_CUSTOMIZER; //To theme your tab.

SimpleChromeCustomTabs.getInstance().withFallback(fallback)
    .withIntentCustomizer(customizer)
    .navigateTo(url, activity);

And voilà!!

External Browser	simple-chrome-custom-tabs

Note: Check the extended demo for further usage examples.