webview_flutter_android #

The Android implementation of webview_flutter.

Usage #

This package is endorsed, which means you can simply use webview_flutter normally. This package will be automatically included in your app when you do.

Display Mode #

This plugin supports two different platform view display modes. The default display mode is subject to change in the future, and will not be considered a breaking change, so if you want to ensure a specific mode, you can set it explicitly.

Texture Layer Hybrid Composition #

This is the current default mode for versions >=23. This is a new display mode used by most plugins starting with Flutter 3.0. This is more performant than Hybrid Composition, but has some limitations from using an Android SurfaceTexture. See:

• https://github.com/flutter/flutter/issues/104889
• https://github.com/flutter/flutter/issues/116954

Hybrid Composition #

This is the current default mode for versions <23. It ensures that the WebView will display and work as expected, at the cost of some performance. See:

• https://flutter.cn/docs/development/platform-integration/platform-views#performance

This can be configured for versions >=23 with AndroidWebViewWidgetCreationParams.displayWithHybridComposition. See https://pub-web.flutter-io.cn/packages/webview_flutter#platform-specific-features for more details on setting platform-specific features in the main plugin.

Contributing #

This package uses pigeon to generate the communication layer between Flutter and the host platform (Android). The communication interface is defined in the pigeons/android_webview.dart file. After editing the communication interface regenerate the communication layer by running flutter pub run pigeon --input pigeons/android_webview.dart.

Besides pigeon this package also uses mockito to generate mock objects for testing purposes. To generate the mock objects run the following command:

flutter pub run build_runner build --delete-conflicting-outputs

If you would like to contribute to the plugin, check out our contribution guide.