webview_completion_fix

author pub

A Flutter plugin that fixes iOS WebView crashes caused by uncalled completion handlers in WKWebView navigation delegate methods.

Related issue: flutter/flutter#102476

English | 简体中文

☕ Support me

ko-fi wechat

Chat: Join WeChat group

✨ Features

✅ Zero Configuration: Works out of the box - just add the dependency
✅ Non-Intrusive: Uses method swizzling without modifying your existing code
✅ Safe Defaults: Invokes missed completion handlers with sensible default values
✅ Optional Logging: Enable detailed logging for debugging purposes

📦 Installation

Add this to your package's pubspec.yaml file:

dependencies:
  webview_completion_fix: latest_version

Then run:

flutter pub get

Installation complete! No additional configuration needed. Now you can enjoy using it 🥳

🔍 Troubleshooting

To help diagnose issues, you can enable detailed logging by adding the following to your iOS app's Info.plist:

<key>WCFEnableLogging</key>
<true/>

Location: ios/Runner/Info.plist

With logging enabled, you'll see detailed console output:

If you're still seeing crashes related to completion handlers after installing this plugin, please:

  1. Verify the plugin is properly initialized by checking the console logs (with WCFEnableLogging enabled)
  2. Report the issue with detailed logs to our issue tracker

🌟 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🖨 About Me

Libraries

webview_completion_fix