【從零開始學 Flutter 程式設計】安裝 Flutter 開發環境

作者： HKT - 9月 16, 2019

【從零開始學 Flutter 程式設計】線上教學課程目錄使用 Dart 程式語言，開發 Android 和 iOS APP 應用程式。

Windows 和 Linux 作業系統環境下只能開發 Android 應用程式。而 macOS 作業系統環境下則可以開發 Android 和 iOS 應用程式。本篇介紹將以 macOS 環境安裝為主。其他作業系統安裝步驟與方法可以參考官網說明介紹。

Flutter 官網介紹 Windows 安裝方式：
https://flutter.dev/docs/get-started/install/windows

Flutter 官網介紹 MacOS 安裝方式：
https://flutter.dev/docs/get-started/install/macos

Flutter 官網介紹 Linux 安裝方式：
https://flutter.dev/docs/get-started/install/linux

俗話說「萬事起頭難，好事多折磨」，要建立 Flutter 開發環境，目前確實不簡單，非一鍵即可完成安裝。因可開發多平台應用程式，所以需要安裝多種軟體：

Flutter SDK ：
Flutter 開發工具包。
Android Studio ：
Android 程式整合開發環境。
(若要開發 Android APP 應用程式)
Xcode：
iOS 程式整合開發環境。
(若要開發 iOS APP 應用程式)

安裝 Flutter 開發環境

Step 1：先下載 Flutter SDK

Flutter SDK For MacOS 官方下載點：flutter_macos_v1.5.4-hotfix.2-stable.zip

Step 2：將下載回來的 zip 壓縮檔，解壓縮到你想存放的位置

開啟終端機

//在桌面建立一個 development 資料夾
mkdir ~/Desktop/development

//進入 development 目錄
cd ~/Desktop/development

//解壓縮 Flutter.zip 壓縮檔到此目錄
unzip ~/Downloads/flutter_macos_v1.5.4-hotfix.2-stable.zip

Step 3：設定 Flutter 指令路徑

之後需要 Flutter 指令，若沒有設定指令路徑，將無法使用 Flutter

//語法
export PATH=$PATH:[你剛剛 Flutter 目錄路徑]/flutter/bin

//範例
export PATH=$PATH:/Users/CalvinHuo/Desktop/development/flutter/bin

透過此方式只是暫時，關閉終端機，下次進來，若沒再設定一次 flutter 指令路徑，將無法使用 flutter 指令，若需永久需要修改 .bash_profile 檔：

// 使用 nano 文字編輯器，開啟 「.bash_profile」
nano .bash_profile

//在「.bash_profile」檔案中加入 Flutter 指令路徑：
export PATH=$PATH:/Users/CalvinHuo/Desktop/development/flutter/bin

//ctrl + x 存檔離開，將永久可使用 flutter 指令，不會因會關閉終端機，下次進來就無法使用 flutter 指令

//新增的設定檔，需要重開終端機才會生效，若不想重開，可以執行以下指令
source ~/.bash_profile

Step 4：檢查需要安裝哪些軟體

透過「flutter doctor」指令來檢查

flutter doctor

會出現類似下方指示:

「✓」最左邊出現綠色勾勾，代表該項完成，「！」驚嘆號即表示，還有遺漏，「✗」叉叉表示，該項尚未安裝，不用太擔心害怕，只要根據上面命令指示，分別執行即可完成初步開發環境架設。所以我們就接著再安裝 Android Studio 和 Xcode。若迫不及待想馬上體驗 flutter，可以先裝一套環境即可，如 Android 或 iOS 擇一環境，之後再裝另外一套。

同理，再一次強調 Windows 和 Linux 作業系統環境下只能開發 Android 應用程式。若要用 flutter 開發 iOS APP 只能在 MacOS 蘋果作業系統環境。附帶一提，若你最近剛好考慮換新電腦，KT 私心無業配推薦，Mac 蘋果電腦，絕對是寫 Code 電腦的最佳選擇，每個專業程式設計工程師皆都應該要配備一台。

Step 5：下載並安裝 Android Studio

Android Studio 官方下載點：https://developer.android.com/studio

安裝完成，可以再執行「flutter doctor」指令來檢查，是否還有需要安裝的？

執行後，出現需要授權使用合約：

[!] Android toolchain - develop for Android devices (Android SDK version 28.0.3)
    ! Some Android licenses not accepted.  To resolve this, run: flutter doctor
      --android-licenses

執行「flutter doctor --android-licenses」來授權使用合約：
PS. 接著都是按 Y，如果按Ｎ不同意將無法繼續使用。

flutter doctor --android-licenses

Step 6：下載並安裝 Xcode

Xcode 官方下載點：https://apps.apple.com/tw/app/xcode/id497799835

安裝完成，可以再執行「flutter doctor」指令來檢查，是否還有需要安裝的？

執行後，出現下方需安裝的內容，依照指示，分別執行提示語法

[!] iOS toolchain - develop for iOS devices (Xcode 10.2.1)
    ✗ libimobiledevice and ideviceinstaller are not installed. To install with
      Brew, run:
        brew update
        brew install --HEAD usbmuxd
        brew link usbmuxd
        brew install --HEAD libimobiledevice
        brew install ideviceinstaller
    ✗ ios-deploy not installed. To install:
        brew install ios-deploy
    ✗ CocoaPods not installed.
        CocoaPods is used to retrieve the iOS platform side's plugin code that
        responds to your plugin usage on the Dart side.
        Without resolving iOS dependencies with CocoaPods, plugins will not work
        on iOS.
        For more info, see https://flutter.dev/platform-plugins
      To install:
        brew install cocoapods
        pod setup
[!] Android Studio (version 3.1)
    ✗ Flutter plugin not installed; this adds Flutter specific functionality.
    ✗ Dart plugin not installed; this adds Dart specific functionality.
[!] IntelliJ IDEA Community Edition (version 2019.1.3)
    ✗ Flutter plugin not installed; this adds Flutter specific functionality.
    ✗ Dart plugin not installed; this adds Dart specific functionality.
[!] Connected device
    ! No devices available
    ```

其中 brew 指的是 macOS 的 Homebrew 套件管理工具。若在安裝 brew 發生問題，可以使用「brew doctor」指令來解決發生的問題。

而 CocoaPods 是管理專案相依性的工具。Android 是使用 Gradle。

如果你的電腦 macOS 升級到 High Sierra (10.13.1) 以上，可能會遇到執行 pod setup 出現以下問題：

-bash: /usr/local/bin/pod: /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/ruby: bad interpreter: No such file or directory

解決方式：先移除 cocoapods 然後再安裝

// 反安裝，先移除 cocoapods 
sudo gem uninstall cocoapods  

//重新安装，主要問題是因為 10.11 之後就需要指定文件夹
sudo gem install -n /usr/local/bin cocoapods

//在執行，就不會遇到紅框內的問題
pod setup

Step 7：下載並安裝 Flutter IDE 整合程式碼編輯器

「從零開始學 Flutter 程式設計」，此套課程 KT 將使用 IntelliJ IDEA 程式碼編輯器來介紹如何開發 Flutter。KT 會選 IntelliJ IDEA 因為它可以單純建立一個很乾淨、很簡單的 Dart 專案來練習語法，可以把他想像成小孩子的遊樂場。不用開到 Flutter 專案。不然其實 Android Studio 就可以直接來使用，不用裝到三個大型 IDE 軟體。但如果真的有空間與運行資源的考量，可以只裝 Android Studio 直接在上面開發 Flutter 專案即可，需要另外練習 Dart 程式語言可以到 DartPad上練習。