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