使用鏡像
由于在國(guó)內(nèi)訪問(wèn)Flutter有時(shí)可(kě)能(néng)會受到限制,Flutter官方為(wèi)中國(guó)開(kāi)發者搭建了(le)臨時(shí)鏡像,大家可(kě)以将如(rú)下(xià)環境變量加入到用戶環境變量中:
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
注意: 此鏡像為(wèi)臨時(shí)鏡像,并不能(néng)保證一(yī)直可(kě)用,讀者可(kě)以參考詳情請(qǐng)參考 Using Flutter in China 以獲得有關鏡像服務器的最新動态。
系統要(yào)求
要(yào)安裝并運行(xíng)Flutter,您的開(kāi)發環境必須滿足以下(xià)最低(dī)要(yào)求:
操作(zuò)系統: Linux (64-bit)
磁盤空間(jiān): 600 MB (不包括Android Studio的磁盤空間(jiān)).
工(gōng)具: Flutter 依賴下(xià)面這(zhè)些命令行(xíng)工(gōng)具.bash, mkdir, rm, git, curl, unzip, which
獲取Flutter SDK
去flutter官網下(xià)載其最新可(kě)用的安裝包,轉到下(xià)載頁 。注意,Flutter的渠道(dào)版本會不停變動,請(qǐng)以Flutter官網為(wèi)準。另外(wài),在中國(guó)大陸地(dì)區(qū),要(yào)想正常獲取安裝包列表或下(xià)載安裝包,可(kě)能(néng)需要(yào)翻牆,讀者也可(kě)以去Flutter github項目下(xià)去下(xià)載安裝包,轉到下(xià)載頁 。
解壓安裝包到你想安裝的目錄,如(rú):cd ~/development unzip ~/Downloads/flutter_macos_v0.5.1-beta.zip
添加flutter相關工(gōng)具到path中:export PATH=`pwd`/flutter/bin:$PATH 此代碼隻能(néng)暫時(shí)針對當前命令行(xíng)窗口設置PATH環境變量,要(yào)想永久将Flutter添加到PATH中請(qǐng)參考下(xià)面更新環境變量 部分。
注意: 由于一(yī)些flutter命令需要(yào)聯網獲取數(shù)據,如(rú)果您是在國(guó)內(nèi)訪問(wèn),由于衆所周知的原因,直接訪問(wèn)很(hěn)可(kě)能(néng)不會成功。 上(shàng)面的PUB_HOSTED_URL和(hé)FLUTTER_STORAGE_BASE_URL是google為(wèi)國(guó)內(nèi)開(kāi)發者搭建的臨時(shí)鏡像。詳情請(qǐng)參考 Using Flutter in China
要(yào)更新現有版本的Flutter,請(qǐng)參閱升級Flutter。
運行(xíng) flutter doctor
運行(xíng)以下(xià)命令查看(kàn)是否需要(yào)安裝其它依賴項來完成安裝:
flutter doctor
該命令檢查您的環境并在終端窗口中顯示報告。Dart SDK已經在捆綁在Flutter裏了(le),沒有必要(yào)單獨安裝Dart。 仔細檢查命令行(xíng)輸出以獲取可(kě)能(néng)需要(yào)安裝的其他(tā)軟件或進一(yī)步需要(yào)執行(xíng)的任務(以粗體顯示)
例如(rú):
[-] Android toolchain - develop for Android devices
• Android SDK at /Users/obiwan/Library/Android/sdk
✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
• Try re-installing or updating your Android SDK,
visit https://flutter.io/setup/#android-setup for detailed instructions.
一(yī)般的錯誤會是xcode或Android Studio版本太低(dī)、或者沒有ANDROID_HOME環境變量等,請(qǐng)按照提示解決。下(xià)面貼一(yī)個筆(bǐ)者本機(mac)的環境變量配置,您可(kě)以對比修正:
export PATH=/Users/用戶名/Documents/flutter/flutter/bin:$PATH
export ANDROID_HOME="/Users/用戶名/Documents/android_sdk" //android sdk目錄,替換為(wèi)你自(zì)己的即可(kě)
export PATH=${PATH}:${ANDROID_HOME}/tools
export PATH=${PATH}:${ANDROID_HOME}/platform-tools
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
第一(yī)次運行(xíng)一(yī)個flutter命令(如(rú)flutter doctor)時(shí),它會下(xià)載它自(zì)己的依賴項并自(zì)行(xíng)編譯。以後再運行(xíng)就會快(kuài)得多。
以下(xià)各部分介紹如(rú)何執行(xíng)這(zhè)些任務并完成設置過程。你會看(kàn)到在flutter doctor輸出中, 如(rú)果你選擇使用IDE,我們提供了(le),IntelliJ IDEA,Android Studio和(hé)VS Code的插件, 請(qǐng)參閱編輯器設置 以了(le)解安裝Flutter和(hé)Dart插件的步驟。
一(yī)旦你安裝了(le)任何缺失的依賴,再次運行(xíng)flutter doctor命令來驗證你是否已經正确地(dì)設置了(le)。
該flutter工(gōng)具使用Google Analytics匿名報告功能(néng)使用情況統計信息和(hé)基本崩潰報告。 這(zhè)些數(shù)據用于幫助改進Flutter工(gōng)具。Analytics不是一(yī)運行(xíng)或在運行(xíng)涉及flutter config的任何命令時(shí)就發送, 因此您可(kě)以在發送任何數(shù)據之前退出分析。要(yào)禁用報告,請(qǐng)執行(xíng)flutter config --no-analytics并顯示當前設置,然後執行(xíng)flutter config。 請(qǐng)參閱Google的隐私政策。
更新環境變量
您在命令行(xíng)隻能(néng)更新當前會話的PATH變量,如(rú)Clone Flutter repo所示。 但(dàn)是,您可(kě)能(néng)需要(yào)的是永久更新此變量,以便您可(kě)以運行(xíng)flutter命令在任何終端會話中。
對于所有終端會話永久修改此變量的步驟是和(hé)特定計算機系統相關的。通(tōng)常,您會在打開(kāi)新窗口時(shí)将設置環境變量的命令添加到執行(xíng)的文件中。例如(rú)
确定您Flutter SDK的目錄,您将在步驟3中用到。
打開(kāi)(或創建) $HOME/.bash_profile. 文件路徑和(hé)文件名可(kě)能(néng)在您的機器上(shàng)不同.
添加以下(xià)行(xíng)并更改[PATH_TO_FLUTTER_GIT_DIRECTORY]為(wèi)克隆Flutter的git repo的路徑:
export PUB_HOSTED_URL=https://pub.flutter-io.cn //國(guó)內(nèi)用戶需要(yào)設置
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn //國(guó)內(nèi)用戶需要(yào)設置
export PATH=PATH_TO_FLUTTER_GIT_DIRECTORY/flutter/bin:$PATH
注意:PATH_TO_FLUTTER_GIT_DIRECTORY 為(wèi)你flutter的路徑,比如(rú)“~/document/code”
export PATH=~/document/code/flutter/bin:$PATH
運行(xíng) source $HOME/.bash_profile 刷新當前終端窗口.
注意:
如(rú)果你使用的是zsh,終端啓動時(shí)
~/.bash_profile
将不會被加載,解決辦法就是修改
~/.zshrc
,在其中添加:source ~/.bash_profile
5.通(tōng)過運行(xíng)flutter/bin命令驗證目錄是否在已經在PATH中:
echo $PATH
更多詳細信息,請(qǐng)參閱this StackExchange question.
編輯器設置
使用 flutter 命令行(xíng)工(gōng)具,您可(kě)以使用任何編輯器來開(kāi)發Flutter應用程序。輸入flutter help在提示符下(xià)查看(kàn)可(kě)用的工(gōng)具。
我們建議(yì)使用我們的插件來獲得豐富的IDE體驗,支持編輯,運行(xíng)和(hé)調試Flutter應用程序。請(qǐng)參閱編輯器設置了(le)解詳細步驟
Android設置
安裝Android Studio
要(yào)為(wèi)Android開(kāi)發Flutter應用,您可(kě)以使用Mac,Windows或Linux(64位)機器.
Flutter需要(yào)安裝和(hé)配置Android Studio:
下(xià)載并安裝 Android Studio.
啓動Android Studio,然後執行(xíng)“Android Studio安裝向導”。這(zhè)将安裝最新的Android SDK,Android SDK平台工(gōng)具和(hé)Android SDK構建工(gōng)具,這(zhè)是Flutter為(wèi)Android開(kāi)發時(shí)所必需的
設置您的Android設備
要(yào)準備在Android設備上(shàng)運行(xíng)并測試您的Flutter應用,您需要(yào)安裝Android 4.1(API level 16)或更高版本的Android設備.
在您的設備上(shàng)啓用 開(kāi)發人(rén)員(yuán)選項 和(hé) USB調試 。詳細說明(míng)可(kě)在Android文檔中找到。
使用USB将手機插入電腦。如(rú)果您的設備出現提示,請(qǐng)授權您的計算機訪問(wèn)您的設備。
在終端中,運行(xíng) flutter devices 命令以驗證Flutter識别您連接的Android設備。
運行(xíng)啓動您的應用程序 flutter run。
默認情況下(xià),Flutter使用的Android SDK版本是基于你的 adb 工(gōng)具版本。 如(rú)果您想讓Flutter使用不同版本的Android SDK,則必須将該 ANDROID_HOME 環境變量設置為(wèi)SDK安裝目錄。
設置Android模拟器
要(yào)準備在Android模拟器上(shàng)運行(xíng)并測試您的Flutter應用,請(qǐng)按照以下(xià)步驟操作(zuò):
在您的機器上(shàng)啓用 VM acceleration .
啓動 Android Studio>Tools>Android>AVD Manager 并選擇 Create Virtual Device.
選擇一(yī)個設備并選擇 Next。
為(wèi)要(yào)模拟的Android版本選擇一(yī)個或多個系統映像,然後選擇 Next. 建議(yì)使用 x86 或 x86_64 image .
在 Emulated Performance下(xià), 選擇 Hardware - GLES 2.0 以啓用 硬件加速.
驗證AVD配置是否正确,然後選擇 Finish。有關上(shàng)述步驟的詳細信息,請(qǐng)參閱 Managing AVDs.
在 Android Virtual Device Manager中, 點擊工(gōng)具欄的 Run。模拟器啓動并顯示所選操作(zuò)系統版本或設備的啓動畫(huà)面.
運行(xíng) flutter run 啓動您的設備. 連接的設備名是 Android SDK built for