【Flutter 基礎】環境及配置

林小帥發表於2021-05-19

注:本文從個人公眾號(島前嶼端)中遷移重新發布

Flutter 是谷歌的移動 UI 框架,可以快速在 iOS 和 Android 上構建高質量的原生使用者介面。 Flutter 可以與現有的程式碼一起工作。

Windows、macOS、Linux 也有不同系統安裝說明

基本環境以及配置

因為我使用的是 Windows 系統,所以這裡以 Windows 系統為例。

系統要求:

  • 作業系統: Windows 7 或更高版本 (64-bit)
  • 磁碟空間: 400 MB (不包括 Android Studio 的磁碟空間)。

環境:

  • Flutter SDK
  • Android 套件

Flutter 中文網中提到可以使用 Flutter 官網提供的 SDK 安裝包。

工具:

  • Git for Windows (Git 命令列工具)

注意:我在嘗試使用 Flutter SDK 的安裝包來執行專案會產生錯誤,所以還是建議通過 GitHub 的方式將 Flutter 專案 clone 下來。

首先是將此配置加入到系統環境變數中:

PUB_HOSTED_URL=https://pub.flutter-io.cn
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
複製程式碼

注意:由於一些 flutter 命令需要聯網獲取資料。如果您是在國內訪問,由於眾所周知的原因,直接訪問很可能不會成功。PUB_HOSTED_URL & FLUTTER_STORAGE_BASE_URL 是 google 為國內開發者搭建的臨時映象。詳情請參考 Using Flutter in China

在完成以上配置以及從 GitHub 上 clone flutter 專案之後,再將 flutter 資料夾下 bin 目錄配置到系統環境變數中。

PATH=xxx\flutter\bin
複製程式碼

命令與環境檢查

這時候開啟一個新的命令列視窗 (CMD) 就可以在命令列中使用 flutter 命令了。

image.png (點選檢視大圖 flutter 命令輸出)

如能出現以上命令列說明,那就證明你已經正確的配置了 Flutter 環境了。

這時候就可以開啟 VS Code 在外掛商店中輸入 flutter 安裝支援擴充套件。

安裝此擴充套件外掛後會自動安裝 Dart SDK 和 相關支援擴充套件。

等待完成後,重啟 VS Code 擴充套件外掛就能正常工作了。

當以上步驟都能正確執行後,在命令列中輸入

flutter doctor
複製程式碼

這個命令按官方說明:第一次執行這個命令時,它會下載自己的依賴並自行編譯,以後再執行時就會快很多。

但是!!! 有一點官方並沒太詳細說明,就是它會檢查與之相關的 環境配置資訊、相關的 SDK、以及相關 IDE 的安裝環境。

image.png
(Flutter 環境檢查)

Flutter 環境檢查:

  • Android 開發環境 以及 Android SDK
  • Visual Studio 開發工具 和 環境(非必須,有更好)
  • Android Studio IDE(非必須,有更好)
  • Connected device(連線的裝置:真機 或 虛擬機器)

OK,當 flutter doctor 檢測沒有明顯的錯誤後,就可以考慮建立一個 flutter 專案了。

Hello Demo

通過 flutter create <project name> 命令可以直接初始化一個專案

flutter create myapp
複製程式碼

稍等一會兒,專案就建立完成了。專案建立完成後需要進入專案目錄。

cd myapp
複製程式碼

這時就可以看到專案目錄結構了。

如果需要連線 真機 or 虛擬機器,那麼就需要通過 flutter devices 來檢查裝置資訊。

flutter devices
複製程式碼

一切正常的情況下,該命令會檢查裝置,並且將裝置資訊顯示輸出在命令列中。

然後,就讓我們把專案跑起來吧!

flutter run
複製程式碼

稍等一會……一會……一會……

image.png

如果一切正常,那麼在裝置上就會看到 flutter create 的一個 demo 了。

image.png
(flutter demo - Android)

Error running Gradle

但是!!!很不幸,你可能大概率會報錯!!!別問為什麼!!! (由於眾所周知的原因,你懂的!)

你看到的結果會是這樣?

image.png

首先!不要驚慌,不要害怕!把毛巾打溼捂住口鼻,壓低或蹲下身子有序逃……

emmmmm……不好意思,走錯片場了。

替換映象倉庫

主要原因還是因為無法連上國際網際網路,導致無法獲取相關的包資訊。

沒關係,找到你 clone 的 flutter 專案資料夾,然後進入:

Flutter -> packages -> flutter_tools -> gradle 找到 flutter.gradle 檔案。

buildscript -> repositories 下的 google() & jcenter() 兩個方法進行註釋。

然後新增 阿里雲(aliyun) 提供的 maven 倉庫映象進行替換

maven{ url 'https://maven.aliyun.com/repository/google' }
maven{ url 'https://maven.aliyun.com/repository/gradle-plugin' }
maven{ url 'https://maven.aliyun.com/repository/jcenter' }
maven{ url 'https://maven.aliyun.com/repository/public' }
複製程式碼

image.png
(替換倉庫映象)

然後再次執行 flutter run 命令就可以看到正常執行的 flutter 專案 demo 了。

祝各位神仙大佬們 build 一次過。如果嘗試了很多次還是有問題,請你取關吧,我不認識你

總結

  • 官方文件是你入門的好幫手,請務必認真閱讀。
  • 認真分析和總結問題的所在。
  • 有時候重啟也是可嘗試的方法之一。

參考

相關文章