Flutter相關(guān)配置及問題記錄
Flutter是谷歌的移動UI框架,可以快速在iOS和Android上構(gòu)建高質(zhì)量的原生用戶界面。 Flutter可以與現(xiàn)有的代碼一起工作。在全世界,F(xiàn)lutter正在被越來越多的開發(fā)者和組織使用,并且Flutter是完全免費、開源的。
Windows 環(huán)境配置
Windows 環(huán)境下開發(fā) Flutter 需要以下環(huán)境:
- Java 開發(fā)環(huán)境 (JavaSDK,用于Android開發(fā))
- GIT
- Flutter SDK
- IDE (Flutter支持很多開發(fā)工具,如:Android Studio、Visual Studio Code、IDEA等)
- 部分IDE需要自行安裝開發(fā)插件(如:Flutter、Dart等插件)
- AVD虛擬機
Windows環(huán)境安裝配置參看
PUB鏡像源配置
# Flutter 社區(qū) (推薦使用)
FLUTTER_STORAGE_BASE_URL: https://storage.flutter-io.cn
PUB_HOSTED_URL: https://pub.flutter-io.cn
# 上海交通大學(xué) Linux 用戶組
FLUTTER_STORAGE_BASE_URL: https://mirrors.sjtug.sjtu.edu.cn
PUB_HOSTED_URL: https://dart-pub.mirrors.sjtug.sjtu.edu.cn
由于部分原因,可以使用以上鏡像源,來保證在國內(nèi)正常使用Flutter,以上鏡像源配置在 系統(tǒng)環(huán)境變量 中。
Gradle鏡像源配置
Flutter 編譯Android程序時,需要使用 Gradle ,由于網(wǎng)絡(luò)原因,會下載很慢或者失敗,可以進(jìn)行如下操作:
-
針對單個項目配置(單個項目生效)。打開項目目錄下的
build.gradle,并將文件內(nèi)的repositories { google() jcenter() }按類似下面提示修改:
buildscript { repositories { //google() //jcenter() ------------ 注釋上面內(nèi)容,復(fù)制下面內(nèi)容 ---------------- 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'} ------------------- 復(fù)制上面內(nèi)容 --------------------- ... } allprojects { repositories { //google() //jcenter() ------------ 注釋上面內(nèi)容,復(fù)制下面內(nèi)容 ---------------- 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'} ------------------- 復(fù)制上面內(nèi)容 --------------------- } } -
針對全局配置(所有項目生效)??梢栽?
C:\Users\[用戶名]\.gradle目錄下創(chuàng)建init.gradle,并寫入以下內(nèi)容: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文件內(nèi)容buildscript { repositories { // google() // jcenter() ------------ 注釋上面內(nèi)容,復(fù)制下面內(nèi)容 ---------------- 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'} ------------------- 復(fù)制上面內(nèi)容 --------------------- } dependencies { classpath 'com.android.tools.build:gradle:3.2.1' } }
注意: 進(jìn)行以上配置后,使用時,盡量不要掛梯子,防止造成影響。
Android模擬器的Intel顯卡硬件加速
在 Android Studio 中Debug運行Android模擬器時,會出現(xiàn)一些錯誤,此時要確保開啟虛擬化且支持Intel硬件加速(另,新版的Android模擬器中也開始支持AMD顯卡加速)。相關(guān)配置及注意內(nèi)容參看下文:
問題記錄
模擬器相關(guān)錯誤
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 中提供的解決方案 或參看 此文。
開發(fā)相關(guān)問題
VS Code 程序引入三方包,提示 uri_does_not_exist
在包管理配置文件 pubspec.yaml, dependencies 里聲明要引入的三方庫及對應(yīng)的版本后,使用在終端中執(zhí)行命令 flutter packages get 下載三方包,之后在需要的地方通過 import 引入時, VS Code 中會提示 uri_does_not_exist 錯誤。出現(xiàn)此問題時,執(zhí)行 flutter packages get 后,嘗試重啟編輯器。添加依賴詳情見官方文章 。
編譯時報錯 uses-sdk:minSdkVersion 16 cannot be smaller than version 17 declared in library
在引入 flutter_inappbrowser 插件編譯時,出現(xiàn)錯誤 uses-sdk:minSdkVersion 16 cannot be smaller than version 17 declared in library 。
在 flutter_inappbrowser 的github的readme文件中,有關(guān)于該插件的 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
并在后續(xù)提到出現(xiàn)關(guān)于該錯誤的處理 , 即需要修改 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" }
使用三方包時,編譯出現(xiàn)類似 minSdkVersion 問題均可如此處理。