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