webview_flutter 2.0.14
webview_flutter: ^2.0.14 copied to clipboard

A Flutter plugin that provides a WebView widget on Android and iOS.

WebView for Flutter #

pub package

A Flutter plugin that provides a WebView widget.

On iOS the WebView widget is backed by a WKWebView; On Android the WebView widget is backed by a WebView.

Usage #

Add webview_flutter as a dependency in your pubspec.yaml file. If you are targeting Android, make sure to read the Android Platform Views section below to choose the platform view mode that best suits your needs.

You can now include a WebView widget in your widget tree. See the WebView widget's Dartdoc for more details on how to use the widget.

Android Platform Views #

The WebView is relying on Platform Views to embed the Android’s webview within the Flutter app. It supports two modes: Virtual displays (the current default) and Hybrid composition.

Here are some points to consider when choosing between the two:

  • Hybrid composition mode has a built-in keyboard support while Virtual displays mode has multiple keyboard issues
  • Hybrid composition mode requires Android SKD 19+ while Virtual displays mode requires Android SDK 20+
  • Hybrid composition mode has performence limitations when working on Android versions prior to Android 10 while Virtual displays is performant on all supported Android versions
Hybrid compositionVirtual displays
Full keyboard supoportyesno
Android SDK support19+20+
Full performanceAndroid 10+always
The defaultnoyes

Using Virtual displays #

The mode is currently enabled by default. You should however make sure to set the correct minSdkVersion in android/app/build.gradle (if it was previously lower than 20):

android {
    defaultConfig {
        minSdkVersion 20
    }
}

Using Hybrid Composition #

  1. Set the correct minSdkVersion in android/app/build.gradle (if it was previously lower than 19):

     android {
         defaultConfig {
             minSdkVersion 19
         }
     }
    
  2. Set WebView.platform = SurfaceAndroidWebView(); in initState(). For example:

     import 'dart:io';
    
     import 'package:webview_flutter/webview_flutter.dart';
    
     class WebViewExample extends StatefulWidget {
       @override
       WebViewExampleState createState() => WebViewExampleState();
     }
    
     class WebViewExampleState extends State<WebViewExample> {
       @override
       void initState() {
         super.initState();
             // Enable hybrid composition.
     if (Platform.isAndroid) WebView.platform = SurfaceAndroidWebView();
       }
    
       @override
       Widget build(BuildContext context) {
         return WebView(
           initialUrl: 'https://flutter.dev',
         );
       }
     }
    

Enable Material Components for Android #

To use Material Components when the user interacts with input elements in the WebView, follow the steps described in the Enabling Material Components instructions.

1506
likes
120
pub points
100%
popularity

Publisher

flutter.dev

A Flutter plugin that provides a WebView widget on Android and iOS.

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-3-Clause (LICENSE)

Dependencies

flutter

More

Packages that depend on webview_flutter