README.md

webview_completion_fix

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

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

• GitHub: https://github.com/LinXunFeng
• Email: linxunfeng@yeah.net
• Blogs:
  • 全栈行动: https://fullstackaction.com
  • 掘金: https://juejin.cn/user/1820446984512392