Flutter相关配置及问题记录
Flutter是谷歌的移动UI框架，可以快速在iOS和Android上构建高质量的原生用户界面。 Flutter可以与现有的代码一起工作。在全世界，Flutter正在被越来越多的开发者和组织使用，并且Flutter是完全免费、开源的。
Windows 环境配置
Windows 环境下开发 Flutter 需要以下环境：
- Java 开发环境 （JavaSDK，用于Android开发）
- GIT
- Flutter SDK
- IDE （Flutter支持很多开发工具，如：Android Studio、Visual Studio Code、IDEA等）
- 部分IDE需要自行安装开发插件（如：Flutter、Dart等插件）
- AVD虚拟机
Windows环境安装配置参看
PUB镜像源配置
# Flutter 社区 (推荐使用)
FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn
PUB_HOSTED_URL: https://pub.flutter-io.cn
# 上海交通大学 Linux 用户组
FLUTTER_STORAGE_BASE_URL: https://mirrors.sjtug.sjtu.edu.cn
PUB_HOSTED_URL: https://dart-pub.mirrors.sjtug.sjtu.edu.cn
由于部分原因，可以使用以上镜像源，来保证在国内正常使用Flutter，以上镜像源配置在 系统环境变量 中。
Gradle镜像源配置
Flutter 编译Android程序时，需要使用 Gradle ，由于网络原因，会下载很慢或者失败，可以进行如下操作：
-
针对单个项目配置（单个项目生效）。打开项目目录下的
build.gradle，并将文件内的repositories { google() jcenter() }按类似下面提示修改：
buildscript { repositories { //google() //jcenter() ------------ 注释上面内容，复制下面内容 ---------------- maven { url 'https://plugins.gradle.org/m2/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/google' } maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'} ------------------- 复制上面内容 --------------------- ... } allprojects { repositories { //google() //jcenter() ------------ 注释上面内容，复制下面内容 ---------------- maven { url 'https://plugins.gradle.org/m2/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/google' } maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'} ------------------- 复制上面内容 --------------------- } } -
针对全局配置（所有项目生效）。可以在
C:\Users\[用户名]\.gradle目录下创建init.gradle，并写入以下内容：allprojects{ repositories { def ALIYUN_REPOSITORY_URL = 'http://maven.aliyun.com/nexus/content/groups/public' def ALIYUN_JCENTER_URL = 'http://maven.aliyun.com/nexus/content/repositories/jcenter' all { ArtifactRepository repo -> if(repo instanceof MavenArtifactRepository){ def url = repo.url.toString() if (url.startsWith('https://repo1.maven.org/maven2')) { project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_REPOSITORY_URL." remove repo } if (url.startsWith('https://jcenter.bintray.com/')) { project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_JCENTER_URL." remove repo } } } maven { url ALIYUN_REPOSITORY_URL url ALIYUN_JCENTER_URL } } } -
修改
..\[Flutter SDK目录]\packages\flutter_tools\gradle目录下的flutter.gradle文件内容buildscript { repositories { // google() // jcenter() ------------ 注释上面内容，复制下面内容 ---------------- maven { url 'https://plugins.gradle.org/m2/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/google' } maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } maven { url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'} ------------------- 复制上面内容 --------------------- } dependencies { classpath 'com.android.tools.build:gradle:3.2.1' } }
注意： 进行以上配置后，使用时，尽量不要挂梯子，防止造成影响。
Android模拟器的Intel显卡硬件加速
在 Android Studio 中Debug运行Android模拟器时，会出现一些错误，此时要确保开启虚拟化且支持Intel硬件加速（另，新版的Android模拟器中也开始支持AMD显卡加速）。相关配置及注意内容参看下文：
问题记录
模拟器相关错误
Emulator: emulator: ERROR: x86 emulation currently requires hardware acceleration!
Emulator: ERROR: x86 emulation currently requires hardware acceleration!
Please ensure Intel HAXM is properly installed and usable.
CPU acceleration status: HAX kernel module is not installed!
错误中有了明确的问题提示，确定是否正确安装或使用 Intel HAXM， 即是否正确安装 intelhaxm-android.exe ，且确保 BIOS 中开启了硬件虚拟化。可以参看 stackoverflow 中提供的解决方案 或参看 此文。
开发相关问题
VS Code 程序引入三方包，提示 uri_does_not_exist
在包管理配置文件 pubspec.yaml， dependencies 里声明要引入的三方库及对应的版本后，使用在终端中执行命令 flutter packages get 下载三方包，之后在需要的地方通过 import 引入时， VS Code 中会提示 uri_does_not_exist 错误。出现此问题时，执行 flutter packages get 后，尝试重启编辑器。添加依赖详情见官方文章 。
编译时报错 uses-sdk:minSdkVersion 16 cannot be smaller than version 17 declared in library
在引入 flutter_inappbrowser 插件编译时，出现错误 uses-sdk:minSdkVersion 16 cannot be smaller than version 17 declared in library 。
在 flutter_inappbrowser 的github的readme文件中，有关于该插件的 Requirements
- Dart sdk: ">=2.1.0-dev.7.1 <3.0.0"
- Flutter: ">=0.10.1 <2.0.0"
- Android:
minSdkVersion 17 - iOS:
--ios-language swift
并在后续提到出现关于该错误的处理 ， 即需要修改 build.gradle 配置文件中 minSdkVersion 的版本到 17 。
处理步骤大致如下：
找到项目目录下
项目名\android\app\build.gradle文件-
在
build.gradle配置文件中找到minSdkVersion并将后面的版本号更改为17defaultConfig { // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). applicationId "com.example.flutter_sl_webview" minSdkVersion 17 // <------- 修改此处 targetSdkVersion 28 versionCode flutterVersionCode.toInteger() versionName flutterVersionName testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" }
使用三方包时，编译出现类似 minSdkVersion 问题均可如此处理。
