由于在國內(nèi)訪問Flutter有時可能會受到限制,F(xiàn)lutter官方為中國開發(fā)者搭建了臨時鏡像,大家可以將如下環(huán)境變量加入到用戶環(huán)境變量中:
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
注意: 此鏡像為臨時鏡像,并不能保證一直可用,讀者可以參考詳情請參考 Using Flutter in China 以獲得有關(guān)鏡像服務(wù)器的最新動態(tài)。
要安裝并運行Flutter,您的開發(fā)環(huán)境必須滿足以下最低要求:
注意: 由于一些flutter命令需要聯(lián)網(wǎng)獲取數(shù)據(jù),如果您是在國內(nèi)訪問,由于眾所周知的原因,直接訪問很可能不會成功。 上面的PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL是google為國內(nèi)開發(fā)者搭建的臨時鏡像。詳情請參考 Using Flutter in China
要更新現(xiàn)有版本的Flutter,請參閱升級Flutter。
運行以下命令查看是否需要安裝其它依賴項來完成安裝:
flutter doctor
該命令檢查您的環(huán)境并在終端窗口中顯示報告。Dart SDK已經(jīng)在捆綁在Flutter里了,沒有必要單獨安裝Dart。 仔細(xì)檢查命令行輸出以獲取可能需要安裝的其他軟件或進(jìn)一步需要執(zhí)行的任務(wù)(以粗體顯示)
例如:
[-] 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.
一般的錯誤會是xcode或Android Studio版本太低、或者沒有ANDROID_HOME環(huán)境變量等,請按照提示解決。下面貼一個筆者本機(jī)(mac)的環(huán)境變量配置,您可以對比修正:
export PATH=/Users/用戶名/Documents/flutter/flutter/bin:$PATH
export ANDROID_HOME="/Users/用戶名/Documents/android_sdk" //android sdk目錄,替換為你自己的即可
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
第一次運行一個flutter命令(如flutter doctor)時,它會下載它自己的依賴項并自行編譯。以后再運行就會快得多。
以下各部分介紹如何執(zhí)行這些任務(wù)并完成設(shè)置過程。你會看到在flutter doctor輸出中, 如果你選擇使用IDE,我們提供了,IntelliJ IDEA,Android Studio和VS Code的插件, 請參閱編輯器設(shè)置 以了解安裝Flutter和Dart插件的步驟。
一旦你安裝了任何缺失的依賴,再次運行flutter doctor命令來驗證你是否已經(jīng)正確地設(shè)置了。
該flutter工具使用Google Analytics匿名報告功能使用情況統(tǒng)計信息和基本崩潰報告。 這些數(shù)據(jù)用于幫助改進(jìn)Flutter工具。Analytics不是一運行或在運行涉及flutter config的任何命令時就發(fā)送, 因此您可以在發(fā)送任何數(shù)據(jù)之前退出分析。要禁用報告,請執(zhí)行flutter config --no-analytics并顯示當(dāng)前設(shè)置,然后執(zhí)行flutter config。 請參閱Google的隱私政策。
您在命令行只能更新當(dāng)前會話的PATH變量,如Clone Flutter repo所示。 但是,您可能需要的是永久更新此變量,以便您可以運行flutter命令在任何終端會話中。
對于所有終端會話永久修改此變量的步驟是和特定計算機(jī)系統(tǒng)相關(guān)的。通常,您會在打開新窗口時將設(shè)置環(huán)境變量的命令添加到執(zhí)行的文件中。例如
export PUB_HOSTED_URL=https://pub.flutter-io.cn //國內(nèi)用戶需要設(shè)置
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn //國內(nèi)用戶需要設(shè)置
export PATH=PATH_TO_FLUTTER_GIT_DIRECTORY/flutter/bin:$PATH
注意:PATH_TO_FLUTTER_GIT_DIRECTORY 為你flutter的路徑,比如“~/document/code”
export PATH=~/document/code/flutter/bin:$PATH
如果你使用的是zsh,終端啟動時
~/.bash_profile
將不會被加載,解決辦法就是修改
~/.zshrc
,在其中添加:source ~/.bash_profile
5.通過運行flutter/bin命令驗證目錄是否在已經(jīng)在PATH中:
echo $PATH
更多詳細(xì)信息,請參閱this StackExchange question.
使用 flutter 命令行工具,您可以使用任何編輯器來開發(fā)Flutter應(yīng)用程序。輸入flutter help在提示符下查看可用的工具。
我們建議使用我們的插件來獲得豐富的IDE體驗,支持編輯,運行和調(diào)試Flutter應(yīng)用程序。請參閱編輯器設(shè)置了解詳細(xì)步驟
macOS支持為iOS和Android開發(fā)Flutter應(yīng)用程序?,F(xiàn)在完成兩個平臺設(shè)置步驟中的至少一個,以便能夠構(gòu)建并運行您的第一個Flutter應(yīng)用程序
要為iOS開發(fā)Flutter應(yīng)用程序,您需要Xcode 7.2或更高版本:
使用Xcode,您可以在iOS設(shè)備或模擬器上運行Flutter應(yīng)用程序。
要準(zhǔn)備在iOS模擬器上運行并測試您的Flutter應(yīng)用,請按以下步驟操作:
要將您的Flutter應(yīng)用安裝到iOS真機(jī)設(shè)備,您需要一些額外的工具和一個Apple帳戶,您還需要在Xcode中進(jìn)行設(shè)置。
如果這些命令中的任何一個失敗并出現(xiàn)錯誤,請運行brew doctor并按照說明解決問題.
遵循Xcode簽名流程來配置您的項目:
要開始您的第一個iOS開發(fā)項目,您可能需要使用您的Apple ID登錄Xcode.
任何Apple ID都支持開發(fā)和測試。需要注冊Apple開發(fā)者計劃才能將您的應(yīng)用分發(fā)到App Store. 查看differences between Apple membership types.
當(dāng)您第一次attach真機(jī)設(shè)備進(jìn)行iOS開發(fā)時,您需要同時信任你的Mac和該設(shè)備上的開發(fā)證書。首次將iOS設(shè)備連接到Mac時,請在對話框中選擇 Trust。
然后,轉(zhuǎn)到iOS設(shè)備上的設(shè)置應(yīng)用程序,選擇 常規(guī)>設(shè)備管理 并信任您的證書。
如果Xcode中的自動簽名失敗,請驗證項目的 General > Identity > Bundle Identifier 值是否唯一.
最后,運行啟動您的應(yīng)用程序 flutter run.
要為Android開發(fā)Flutter應(yīng)用,您可以使用Mac,Windows或Linux(64位)機(jī)器.
Flutter需要安裝和配置Android Studio:
要準(zhǔn)備在Android設(shè)備上運行并測試您的Flutter應(yīng)用,您需要安裝Android 4.1(API level 16)或更高版本的Android設(shè)備.
默認(rèn)情況下,F(xiàn)lutter使用的Android SDK版本是基于你的 adb 工具版本。 如果您想讓Flutter使用不同版本的Android SDK,則必須將該 ANDROID_HOME 環(huán)境變量設(shè)置為SDK安裝目錄。
要準(zhǔn)備在Android模擬器上運行并測試您的Flutter應(yīng)用,請按照以下步驟操作:
更多建議: