升级Flutter项目后webview_flutter插件异常求助

以下是针对该问题的具体排查和解决步骤：

• 检查插件与Flutter版本兼容性
  升级Flutter后，旧版webview_flutter可能无法适配当前框架。执行命令更新插件到兼容版本：

  flutter pub upgrade webview_flutter
  flutter pub get
  

  确保pubspec.yaml中webview_flutter的版本与当前Flutter版本匹配（例如Flutter 3.x需搭配webview_flutter 4.x+）。

• 替换废弃API
  webview_flutter 4.0.0及以上版本已废弃initialUrl参数，需替换为initialRequest。修改代码如下：

  WebView(
    initialRequest: WebViewRequest(url: Uri.parse('https://bufkes.nl')),
    javascriptMode: JavascriptMode.unrestricted,
  )
  

  旧API的使用会导致组件无法正常初始化，进而触发“未使用该插件”的错误提示。

• 完善平台配置

  • Android端：确保android/app/build.gradle中minSdkVersion不低于19，同时在AndroidManifest.xml添加网络权限：

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

  • iOS端：在Info.plist中添加WebView相关配置（若加载HTTPS站点，需确保App Transport Security允许该域名，或添加NSAllowsArbitraryLoadsInWebContent权限）。

• 清理项目缓存
  缓存异常可能导致插件识别失败，执行以下命令后重新构建项目：

  flutter clean
  flutter pub get
  flutter run
  

内容的提问来源于stack exchange，提问作者EnricovanDijkhuizen