Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.
added in version 1.0.0
belongs to Maven artifact androidx.browser:browser:1.0.0-rc01

TrustedWebUtils

public class TrustedWebUtils
extends Object

java.lang.Object
   ↳ androidx.browser.customtabs.TrustedWebUtils


Class for utilities and convenience calls for opening a qualifying web page as a Trusted Web Activity. Trusted Web Activity is a fullscreen UI with no visible browser controls that hosts web pages meeting certain criteria. The full list of qualifications is at the implementing browser's discretion, but minimum recommended set is for the web page :

  • To have declared delegate_permission/common.handle_all_urls relationship with the launching client application ensuring 1:1 trust between the Android native and web components. See https://developers.google.com/digital-asset-links/ for details.
  • To work as a reliable, fast and engaging standalone component within the launching app's flow.
  • To be accessible and operable even when offline.
Fallback behaviors may also differ with implementation. Possibilities are launching the page in a custom tab, or showing it in browser UI. Browsers are encouraged to use CustomTabsCallback.onRelationshipValidationResult(int, Uri, boolean, Bundle) for sending details of the verification results.

Summary

Constants

String EXTRA_LAUNCH_AS_TRUSTED_WEB_ACTIVITY

Boolean extra that triggers a CustomTabsIntent launch to be in a fullscreen UI with no browser controls.

Public methods

static void launchAsTrustedWebActivity(Context context, CustomTabsIntent customTabsIntent, Uri uri)

Launch the given CustomTabsIntent as a Trusted Web Activity.

Inherited methods

Constants

EXTRA_LAUNCH_AS_TRUSTED_WEB_ACTIVITY

added in version 1.0.0
public static final String EXTRA_LAUNCH_AS_TRUSTED_WEB_ACTIVITY

Boolean extra that triggers a CustomTabsIntent launch to be in a fullscreen UI with no browser controls.

Constant Value: "android.support.customtabs.extra.LAUNCH_AS_TRUSTED_WEB_ACTIVITY"

Public methods

launchAsTrustedWebActivity

added in version 1.0.0
public static void launchAsTrustedWebActivity (Context context, 
                CustomTabsIntent customTabsIntent, 
                Uri uri)

Launch the given CustomTabsIntent as a Trusted Web Activity. The given CustomTabsIntent should have a valid CustomTabsSession associated with it during construction. Once the Trusted Web Activity is launched, browser side implementations may have their own fallback behavior (e.g. Showing the page in a custom tab UI with toolbar) based on qualifications listed above or more.

Parameters
context Context: Context to use while launching the CustomTabsIntent.

customTabsIntent CustomTabsIntent: The CustomTabsIntent to use for launching the Trusted Web Activity. Note that all customizations in the given associated with browser toolbar controls will be ignored.

uri Uri: The web page to launch as Trusted Web Activity.