接下來的一段時間裡,我們將為大家持續推送最新的 Flutter 中文文檔,這些文檔由國內的 Flutter 開發者、愛好者翻譯發布和共同維護。歡迎分享給身邊的開發者朋友,也歡迎隨時通過 Issue、PR 的方式向我們提出翻譯錯誤,你的貢獻會造福全球讀中文的開發者。

Flutter 是 Google 開源的攜帶型 UI 工具包,幫助開發者通過一套代碼庫高效構建多平台精美應用,支持移動、Web、桌面和嵌入式平台。

要想入手開發,開發環境搭建是首要,本文為 Flutter 開發環境在 Windows 下安裝全過程:

一、系統配置要求

要想安裝和運行 Flutter,你的開發環境至少應該滿足如下的需求:

  • 操作系統:Windows 7 SP1 或更高的版本(64 位操作系統)。
  • 磁碟空間:除安裝 IDE 和一些工具之外還應有至少 400 MB 的空間。
  • 工具:要讓 Flutter 在你的開發環境中正常使用,依賴於以下的工具:
    • Windows PowerShell 5.0 或者更高的版本(Windows 10 中已經預裝了)
    • Git for Windows 2.x,並且勾選從 Windows 命令提示符使用 Git 選項。如果 Windows 版的 Git 已經安裝過了,那麼請確保能從命令提示符或者 PowerShell 中直接執行 git 命令。

二、獲取 Flutter SDK

  1. 下載下面的安裝包以獲取最新版本 stable 的 Flutter SDK

flutter_windows_v1.5.4-hotfix.2-stable.zip?

storage.flutter-io.cn

要查看其他發行通道和以往的版本,請參閱SDK 歸檔頁面。

2. 將壓縮包解壓,然後把其中的 flutter 目錄整個放在你預想的 Flutter SDK 安裝目錄中(比如C:srcflutter;請勿將該目錄放在一些需要額外操作許可權的目錄,比如 C:Program Files)。

3. 找到 flutter 目錄中的 flutter_console.bat 文件,雙擊執行該批處理腳本。

好的,現在你可以在控制台當中使用 Flutter 的命令了。

要升級本地已安裝的 Flutter,請參閱升級 Flutter。

2.1 更新 path 環境變數

如果你想要在普通的 Windows 控制台中使用 Flutter 命令,那就需要按照下面的步驟來將 Flutter 的二進位文件路徑加入到 PATH 環境變數。

  • 在開始菜單的搜索功能鍵入「env」,然後選擇編輯當前用戶的環境變數
  • 用戶變數 (User variables) 一欄中,檢查是否有 Path 這個條目:
    • 如果存在,直接把 flutterin 目錄的完整路徑以 ; 作為分隔加到已有的值後面。
    • 如果不存在的話,在用戶環境變數中創建一個新的 Path 變數,然後將 flutterin 所在的完整路徑作為新變數的值。

注意,你需要關閉和重新啟動已經打開的各個控制台窗口,這樣下次啟動控制台時才能訪問到剛才修改的變數。

2.2 運行 flutter doctor

在將 Path 變數更新後,打開一個新的控制台窗口,然後將下面的命令輸入進去執行。如果它提示有任何的平台相關依賴,那麼你就需要按照指示完成這些配置:

C:srcflutter>flutter doctor

上述命令會檢查你的現有環境,然後把檢測結果以報告形式呈現出來。仔細閱讀它顯示的內容,檢查是否有尚未安裝的軟體或是有其他的步驟需要完成(通常會以粗體呈現)。

舉個例子:

[-] Android toolchain - develop for Android devices
? Android SDK at D:Androidsdk
? 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.cn/setup/#android-setup for detailed instructions.

下面的章節描述了如何執行報告中提到的任務來完成整體配置。每當按照報告安裝了任何的依賴項,就可以執行 flutter doctor 來檢查還有什麼沒有完成的。

flutter 工具使用了 Google Analytics 來對基本使用情況和崩潰報告進行匿名的統計。這些數據用來幫助改善 Flutter 工具。在第一次運行或者任何涉及到 flutter config 的信息都不會進行發送,所以你可以在發送分析數據之前選擇禁止分析數據的統計。要禁用這一功能,只需要輸入 flutter config --no-analytics 即可,想要查看當前設置使用命令 flutter config 即可。你可以在 Google 隱私政策中查看更詳細的內容。

三、設置 Android 開發環境

備忘

Flutter 依賴 Android Studio 的全量安裝來為其提供 Android 平台的支持。但你也可以使用其他的編輯器來寫 Flutter 應用,稍後會說明討論這個問題。

3.1 安裝 Android Studio

  1. 下載並安裝 Android Studio。

2. 運行 Android Studio,並進入 『Android Studio Setup Wizard』,這會安裝最新的 Android SDK, Android SDK Platform-Tools 以及 Android SDK Build-Tools,這些都是在開發 AndroidFlutter 應用時所需要的。

3.2 配置 Android 設備

在 Android 設備上運行或測試 Flutter 應用之前,你需要一個運行 Android 4.1(API 版本 16)或者更高的設備。

1. 在設備上打開 Developer optionsUSB debugging 選項,你可以在 Android documentation 上查看更詳細的方法介紹。

2. 如果是在 Windows 平台上使用,需要安裝 Google USB Driver

3. 通過 USB 介面連接手機和電腦,如果在設備上彈出需要授權彈窗,允許授權以便讓電腦能夠訪問你的開發設備。

4. 在命令行中,使用 flutter devices 命令來確保 Flutter 能夠識別出你所連接的 Android 設備。

默認情況下,Flutter 會使用當前版本 adb 工具所依賴的 Android SDK 版本,如果你想讓 Flutter 使用別的 Android SDK,你可以通過設置 ANDROID_HOME 環境變數來達到目的。

3.3 配置 Android 模擬器

根據以下步驟來將 Flutter 應用運行或測試於你的 Android 模擬器上:

1. 激活機器上的VM acceleration選項。

2. 啟動 Android Studio > Tools >Android > AVD Manager,然後選擇 Create VirtualDevice 選項。(只有在 Android 項目中才會顯示 Android 子選項。)

3. 選擇相應的設備並選擇 Next 選項。

4. 選擇一個或多個你想要模擬的 Android 版本的系統鏡像,然後選擇 Next 選項。推薦選擇 x86 或者 x86_64 鏡像。

5. 在 Emulated Performance 下選擇Hardware - GLES 2.0選項來開啟硬體加速。

6. 確保 AVD 選項配置正確,並選擇 Finish 選項。

想要查看上述步驟的更多詳細信息,請查看 Managing AVDs 頁面。

7. 在 Android Virtual Device Manager 中,點擊工具欄中的 Run 選項,模擬器會啟動並為你所選擇的系統版本和設備顯示出相應的界面。

文 / Flutter.dev;譯 / @楊棟;審校 / @脈脈不得語,感謝各位的貢獻!

推薦閱讀:

相关文章