Skip to main content

advanced_webview 0.3.0 copy "advanced_webview: ^0.3.0" to clipboard
advanced_webview: ^0.3.0 copied to clipboard

A lean, type-safe WebView plugin for Android and iOS built on Pigeon.

advanced_webview #

English | 日本語

CI License: MIT

A type-safe Flutter WebView plugin for Android and iOS only, built on Pigeon. It borrows feature ideas from flutter_inappwebview, but favours maintainability with a small public API and a single, centralised platform contract.

Documentation: https://imk1t.github.io/advanced_webview/

For design decisions (such as why Pigeon was chosen), see doc/architecture.md (Japanese).

Supported platforms #

Android iOS
API 24+ iOS 18+

On iOS, both Swift Package Manager and CocoaPods are supported. The plugin builds with either, depending on your Flutter setting (flutter config --enable-swift-package-manager / --no-enable-swift-package-manager); no plugin-specific manual linking is needed. Configure your app requirements below.

Installation #

Before the first release, use the Git dependency below. After publication on pub.dev, use flutter pub add advanced_webview instead.

dependencies:
  advanced_webview:
    git:
      url: https://github.com/imk1t/advanced_webview.git

Requires Flutter 3.47.8+ (Dart 3.13.7+). Android devices need API 24+; Android builds need compileSdk 36 and JDK 17. iOS devices and the app deployment target must be 18.0+; builds need Xcode with an iOS SDK that supports that target. Add this directly under <manifest> in your app's android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

See the getting-started guide for platform setup.

Usage #

import 'package:advanced_webview/advanced_webview.dart';

final controller = AdvancedWebViewController(
  javaScriptChannels: {'Bridge': (message) => print(message)},
  onPageFinished: (url) => print('loaded $url'),
  onNavigationRequest: (request) => request.url.startsWith('https://')
      ? NavigationDecision.navigate
      : NavigationDecision.prevent,
)..loadUrl('https://flutter.dev');

// build
AdvancedWebView(controller: controller);

// Run JavaScript (the result is already decoded from JSON)
final title = await controller.runJavaScriptReturningResult('document.title');

// When you no longer need it
await controller.dispose();

On both platforms, JavaScript can call window.Bridge.postMessage('hello').

Current features #

  • Load a URL or an HTML string; reload, stop, go back and forward
  • Get the current URL and title
  • Run JavaScript (with or without a return value)
  • JavaScript channels (messages from JS to Dart)
  • JavaScript handlers (JS calls Dart and gets a value back)
  • Permission requests from pages (camera, microphone, location)
  • Download notifications (the app decides how to fetch the file)
  • Certificate error and HTTP authentication callbacks
  • Navigation decisions (main frame)
  • Callbacks: page started / finished, progress, title changed, load errors
  • Settings: JavaScript enabled, User-Agent, media autoplay, inline playback (iOS), zoom (Android), transparent background

Development #

Flutter is managed with mise (the version is pinned in mise.toml).

mise install                                         # install the pinned Flutter
flutter pub get
dart run pigeon --input pigeons/messages.dart   # after editing pigeons/messages.dart
flutter analyze
flutter test                                     # Dart unit tests
cd example && flutter test integration_test      # integration tests on a device or simulator

Native code is formatted and linted with ktlint (Kotlin) and swift-format (Swift). See CONTRIBUTING.md for the full workflow.

Contributing #

Issues and pull requests are welcome, in English or Japanese. Please read CONTRIBUTING.md and the Code of Conduct. Please report security vulnerabilities by following SECURITY.md, not through public issues.

Instructions for AI coding agents are in AGENTS.md (shared skills are distributed with APM via apm.yml).

License #

MIT License

0
likes
0
points
1.46k
downloads

Documentation

Documentation

Publisher

unverified uploader

Weekly Downloads

A lean, type-safe WebView plugin for Android and iOS built on Pigeon.

Repository (GitHub)
View/report issues

Topics

#webview #browser #pigeon #android #ios

License

unknown (license)

Dependencies

flutter, meta

More

Packages that depend on advanced_webview

Packages that implement advanced_webview