Skip to content
This repository has been archived by the owner on Feb 11, 2022. It is now read-only.

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.

License

Notifications You must be signed in to change notification settings

novoda/simple-chrome-custom-tabs

Repository files navigation

🛑 THIS REPOSITORY IS OFFICIALLY NO LONGER UNDER MAINTENANCE since 10/02/2022 🛑

simple-chrome-custom-tabs Download

  • 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);
  1. 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();
}
  1. 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
external_browser simplechromecustomtabs

Note: Check the extended demo for further usage examples.

Links

Here are a list of useful links:

  • We always welcome people to contribute new features or bug fixes, here is how
  • If you have a problem or you feel that important functionality is missing check the Issues Page first to see if we are working on it

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published