Flutter相关配置及问题记录

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显卡加速）。相关配置及注意内容参看下文：

• 提升基于英特尔® 架构的 Android* 模拟器的速度
• 使用AMD CPU硬體加速Andriod模擬器 —— Hsiu’s Blog

---

问题记录

模拟器相关错误

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 ❤️.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 并将后面的版本号更改为 17

  defaultConfig {
      // 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 问题均可如此处理。