一粱甫、運行Xcode編譯或者flutter run/build 過程中報錯："x86_64" is not an allowed value for option "ios-arch".
解決方案
在Debug.xcconfig中指定 “FLUTTER_BUILD_MODE=debug”，Release.xcconfig中指定“FLUTTER_BUILD_MODE=release”
錯誤分析
這看起來是在模擬器編譯環(huán)境下選擇了真機的Framework什么的，后來查詢發(fā)現(xiàn)是沒有設(shè)置這個變量。因為工程的Build Phases里運行了<"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh"?build>相關(guān)命令纤控，而xcode_backend里為build_mode變量設(shè)置了默認值"release"，這使得在查找Flutter.framework等編譯所需的“原材料”時，默認選擇了release的目錄享钞，導(dǎo)致了這個錯誤，所以诀蓉，加上debug這個設(shè)置后嫩与，會去ios這個目錄中查找相關(guān)文件，就不會有問題了交排。附目錄截圖：
注：所在目錄 flutter/bin/cache/artifacts/engine/
二划滋、Flutter plugin not installed; this adds Flutter specific functionality.?Dart plugin not installed; this adds Dart specific functionality
解決方案
1.) Start the Android Studio application
2.) Open plugin preferences (Preferences>Plugins on macOS, File>Settings>Plugins on Windows & Linux).
3.) Select Browse repositories…, select the Flutter plug-in and click install .
4.) Click Yes when prompted to install the Dart plugin.
5.) Click Restart when prompted.
錯誤分析
如果你使用的是iOS開發(fā)環(huán)境或者沒有安裝Flutter插件的Android Studio，會報這個錯誤埃篓。Flutter是Google開發(fā)的移動開發(fā)SDK处坪，為了方便，基于自己的IDE開發(fā)了Flutter插件架专，以方便集成過程同窘。在Flutter生成雙端產(chǎn)物的時候，需要經(jīng)過插件做一些操作部脚。
三想邦、Android license status unknown
解決方案
執(zhí)行 “flutter doctor --android-licenses” 命令
會問你'Do you want to review the licenses?'，輸入“y” 然后 回車委刘，這時再執(zhí)行一次flutter doctor就好了
四丧没、MissingPluginException(No implementation found for method xxx on channel xxx)
解決方案
方案一：flutter clean一下，再次 flutter run/build
方案二：將flutter run的進程終止掉重新 flutter run/build
方案三：看看你的FlutterPluginRegistrant產(chǎn)物是否存在锡移，是否更新了
錯誤分析
問題本質(zhì)是Plugin的方法沒有找到呕童，也可能是Plugin本身就沒有注冊成功。老版本的Flutter SDK遇到這個問題可能是沒有觸發(fā)GeneratedPluginRegistrant.register(this)淆珊，新版本的已經(jīng)不需要手動觸發(fā)了夺饲。
五、Waiting for another flutter command to release the startup lock
解決方案
rm ./flutter/bin/cache/lockfile
錯誤分析
原因是在flutter編譯等操作運行過程中施符，會創(chuàng)建一個文件鎖往声，但是由于一些原因鎖沒有釋放導(dǎo)致的，而且一直無法釋放……
六戳吝、'Flutter/Flutter.h' file not found
解決方案
方案一：如果集成方式是靜態(tài)庫(.a)浩销，需要在引用Flutter的工程中，修改Build settings中的Header Search Paths骨坑，將Flutter所在目錄加入其中撼嗓。
方案二：如果集成方式是動態(tài)庫(.framework)柬采，說明在引用Flutter的工程中并沒有依賴成功，需要檢查Flutter.framework包內(nèi)是否包含Headers文件夾且警，是否其中包含F(xiàn)lutter.h粉捻，另外就是Podspec和podfile是否正確。還有斑芜，Cocoapods必須1.5版本及以上肩刃。
方案三：如果你用的podspec.json，試試改寫成podspec（這個坑曾讓我浪費了幾天的時間……）
七杏头、error: cannot parse the debug map for xxx: No such file or directory
解決方案
依賴產(chǎn)物只針對 真機 盈包，但調(diào)試中使用了另一種 模擬器〈纪酰或者反過來了呢燥。
錯誤分析
真機和模擬器的平臺是不同的，符號也不同寓娩。
八叛氨、diff: /../Podfile.lock: No such file or directory
解決方案
方案一：重新pod install
方案二：刪除workspace、podfile.lock棘伴、Pods/寞埠、~/Library/Developer/Xcode/DerivedData
方案三：
1、運行sudo gem install cocoapods-deintegrate安裝快速解除項目cocopods依賴的庫
2焊夸、安裝成功后仁连，cd到你項目的更目錄運行pod deintegrate解除項目cocopods依賴
3、運行pod install,重新安裝cocopods
錯誤分析
Cocoapods的鍋……
九阱穗、Flutter Bitcode
解決方案
在podfile中禁止bitcode
錯誤分析
Flutter相關(guān)集成是不支持bitcode的饭冬，所以需要將相關(guān)產(chǎn)物的bitcode功能關(guān)閉。如果你的現(xiàn)有工程中倉庫眾多颇象，有的倉庫是必須bitcode的伍伤，這樣的話就需要每次pod install之后再在工程配置中手動設(shè)置回來，以下腳本放在podfile中可以解決此問題遣钳。
post_install do |installer|
????????installer.pods_project.targets.each do |target|
????????????????if target.name =="App" || target.name =="Flutter"
????????????????????????target.build_configurations.each do |config|
????????????????????????????????config.build_settings['ENABLE_BITCODE'] ='NO'
????????????????????????end
????????????????end
????????end
end
十、module importing failed: ('invalid syntax', ('temp.py',xxx
解決方案
執(zhí)行以下命令
brew update
brew uninstall --ignore-dependencies libimobiledevice ios-deploy cocoapods
brew uninstall --ignore-dependencies usbmuxd
brew install --HEAD usbmuxd
brew unlink usbmuxd
brew link usbmuxd
brew install --HEAD libimobiledevice
brew install ideviceinstaller ios-deploy cocoapods
十一麦乞、Flutter集成到現(xiàn)有工程后蕴茴，性能問題
解決方案
用Release產(chǎn)物集成
問題分析
為了實現(xiàn)Hot refresh功能，F(xiàn)lutter在Debug下做了很多工作姐直，影響了性能倦淀，可以通過修改
FLUTTER_BUILD_MODE的值（"debug" => "release"）
使用Release產(chǎn)物集成的方式屏蔽這部分影響。注意声畏，flutter_assets是需要同時更新的撞叽，Debug產(chǎn)物中含有kernel_blob.bin文件姻成，Release產(chǎn)物則沒有。
十二愿棋、iOS系統(tǒng)中科展，第一次從Native跳轉(zhuǎn)到Flutter頁面時，會出現(xiàn)LaunchScreen
解決方案
采用繼承糠雨、Category同名方法等方式才睹，覆蓋FlutterViewController的splashScreenView的get方法，直接返回成員變量甘邀，將中間的讀取LaunchScreen頁面過程覆蓋掉琅攘，甚至可以自定義自己的邏輯。
問題分析
Flutter的渲染是異步的松邪，第一次加載需要創(chuàng)建Application和頁面坞琴，無法及時返回結(jié)果，所以Flutter自己把這部分邏輯加到了SDK內(nèi)部逗抑，其實是為了解決 “純Flutter App首屏白屏” 問題剧辐，但給我們這種混編的App帶來了麻煩。
以上是我們到目前為止遇到的主要坑位锋八，以及解決方案和原因分析浙于，F(xiàn)lutter無論從性能還是人效方面來講，都會在熟悉之后節(jié)省不少成本挟纱，希望各位能從我們的經(jīng)驗中節(jié)省更多寶貴的時間羞酗。同時，也希望大家把更多的埋坑記錄發(fā)到評論里紊服，幫助友隊一起學(xué)習(xí)檀轨，一起成長。歡迎技術(shù)交流欺嗤！
