Flutter 示例应用:内嵌 WebView 打开 百度,支持 AppBar 后退、刷新。主打 Android Debug 安装到真机。
- Flutter SDK(本项目使用 FVM 时:
fvm use 3.41.7或本机flutter --version可用即可) - Android SDK(
flutter doctor中 Android toolchain 无报错) - 真机 USB 调试已开启,或 Android 模拟器已运行
Maven / Gradle(已写入 android/settings.gradle.kts + build.gradle.kts)
拉取 Android 依赖、Gradle 插件走阿里云;Gradle 本体走腾讯云(gradle-wrapper.properties)。
Flutter / Dart(终端里 export,或写入 ~/.zshrc)
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cnAndroid SDK / NDK(sdkmanager 下载慢时) 需单独用镜像或代理,不能只靠 settings.gradle.kts。
检查环境:
flutter doctorflutter pub get
flutter devices # 确认已连接设备
flutter run # 编译并安装 Debug 包也可在设备已连接时使用:
flutter install| 项 | 值 |
|---|---|
| 包名 | com.example.hello_flutter |
| 显示名 | Hello Flutter |
| 默认 URL | https://www.baidu.com |
- 返回:WebView 有历史则后退,否则退出应用
- 刷新:重新加载当前页
flutter analyze
flutter test- 设备未列出:检查 USB 调试、数据线、运行
adb devices - 依赖失败:确认网络后重试
flutter pub get - WebView 空白:确认手机可访问外网,且已声明
INTERNET权限(已配置) - Charles 部分子域仍 SSL 失败:Charles → SSL Proxying 添加
*.baidu.com:443;手机安装并信任 Charles 证书;Debug 包已配置network_security_config信任用户证书,改完后需 重新安装 Debug 包(flutter run),不能只热重载