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 問題均可如此處理。