launchUrl function

Future<void> launchUrl(Uri url, { bool prefersDeepLink = false, LaunchOptions options = const LaunchOptions(), })

Passes url with options to the underlying platform for launching a custom tab.

Example:

final theme = ...;
try {
  await launchUrl(
    Uri.parse('https://flutter.dev'),
    options: LaunchOptions(
      barColor: theme.colorScheme.surface,
      onBarColor: theme.colorScheme.onSurface,
      barFixingEnabled: false,
    ),
  );
} catch (e) {
  // If the URL launch fails, an exception will be thrown. (For example, if no browser app is installed on the Android device.)
}

Implementation

Future<void> launchUrl(
  Uri url, {
  bool prefersDeepLink = false,
  LaunchOptions options = const LaunchOptions(),
}) async {
  if (url.scheme != 'http' && url.scheme != 'https') {
    throw PlatformException(
      code: 'NOT_A_WEB_SCHEME',
      message: 'Flutter Custom Tabs only supports URL of http or https scheme.',
    );
  }

  await CustomTabsPlatform.instance.launch(
    url.toString(),
    prefersDeepLink: prefersDeepLink,
    customTabsOptions: options.toCustomTabsOptions(),
    safariVCOptions: options.toSafariViewControllerOptions(),
  );
}