建立新的 Flutter 應用程式

本頁將提供逐步說明，協助你在偏好的開發環境中 快速啟動一個新的 Flutter 應用程式。

要建立新的 Flutter 應用程式，請先設定 Flutter，然後 選擇你偏好的開發環境，並依照對應的指引操作。

若要使用 VS Code 或其他基於 Code OSS 的編輯器建立 Flutter 應用程式， 請先安裝 Flutter並 設定 VS Code 以進行 Flutter 開發。 接著依照以下步驟操作：

1. 啟動 VS Code

   開啟 VS Code 或你偏好的 Code OSS 編輯器。

2. 開啟命令面板

   前往 檢視 > 命令面板， 或按下 Cmd/Ctrl + Shift + P。

3. 尋找 Flutter 指令

   在命令面板中開始輸入 flutter:。 VS Code 應會顯示來自 Flutter 外掛的相關指令。

4. 執行新專案指令

   選擇 Flutter: New Project 指令。 作業系統或 VS Code 可能會要求存取你的文件， 請同意以繼續下一步。

5. 選擇範本

   VS Code 應會提示你選擇 Which Flutter template?。 根據你想建立的 Flutter 專案類型， 選擇對應的範本。 若要建立新的 Flutter 應用程式，請選擇 Application。

6. 選擇專案位置

   應會出現檔案對話框。 請選擇或建立你希望放置專案的父目錄。 不需要自行建立專案資料夾，Flutter 工具會自動建立。 確認選擇後， 點擊 Select a folder to create the project in。

7. 輸入專案名稱

   VS Code 會提示你輸入新專案的名稱。 請輸入符合 lowercase_with_underscores 命名規範的應用程式名稱，並遵循 Effective Dart 指南。 確認後，按下 Enter。

8. 等待專案初始化

   根據你輸入的資訊， VS Code 會使用 flutter create 來啟動你的應用程式。 進度通常會以右下角通知顯示， 也可在 Output 面板中查看。

9. 執行你的應用程式

   你的新應用程式現在應已建立並在 VS Code 中開啟。 若要體驗新應用程式， 請依照 在 VS Code 執行與除錯 的步驟操作。

你已成功在 VS Code 中建立新的 Flutter 應用程式！ 若需要更多關於在 VS Code 開發 Flutter 的協助， 請參考 Flutter 的 VS Code 參考文件。

若要使用 Android Studio 建立 Flutter 應用程式， 請先安裝 Flutter並 設定 Android Studio 以進行 Flutter 開發。 接著依照以下步驟操作：

1. 啟動 Android Studio

   開啟已安裝 Dart 與 Flutter 外掛的 Android Studio。

2. 開始建立專案

   如果你在 IDE 歡迎畫面（顯示 Welcome to Android Studio）， 請在中央找到並點擊 New Flutter Project 按鈕。

   若你已開啟其他專案，可先關閉該專案，或 前往 File > New > New Flutter Project...。

3. 選擇專案類型

   在 New Project 對話框左側的 Generators 區塊中， 選擇 Flutter。

4. 確認 Flutter SDK 設定

   在右側面板頂部，請確保 Flutter SDK path 的路徑 與你要開發的 Flutter SDK 位置相符。 若不相符，請選擇或指定正確的路徑。

5. 設定專案

   點擊 Next 進入專案設定。 會出現多個設定選項。

   在 Project name 欄位，請輸入符合 lowercase_with_underscores 命名規範的應用程式名稱， 並遵循 Effective Dart 指南。

   若你不是要建立應用程式， 請從 Project type 下拉選單選擇其他範本。

   若你預計將來會發佈此應用程式， 請將 Organization 欄位設為你的公司網域。

   其他欄位可維持預設值，或依專案需求調整。

6. 完成專案建立

   完成專案設定後， 點擊 Create 開始初始化專案。

7. 等待工作區初始化

   Android Studio 會初始化你的工作區， 建立專案檔案結構， 並下載應用程式所需的相依套件。 這個過程可能需要一些時間，可在視窗底部追蹤進度。

8. 執行你的應用程式

   你的新應用程式現在應已建立並在 Android Studio 中開啟。 若要體驗新應用程式， 請依照 在 Android Studio 執行與除錯 的步驟操作。

你已成功在 Android Studio 中建立新的 Flutter 應用程式！ 若需要更多關於在 Android Studio 開發 Flutter 的協助， 請參考 Flutter 的 Android Studio 參考文件。

若要使用 IntelliJ 或其他 JetBrains IDE 建立 Flutter 應用程式， 請先安裝 Flutter並 設定 IntelliJ 以進行 Flutter 開發。 接著依照以下步驟操作：

1. 啟動 IntelliJ

   開啟 IntelliJ IDEA 或你偏好的 JetBrains IntelliJ 系列 IDE， 並確保已安裝 Dart 與 Flutter 外掛。

2. 開始建立專案

   如果你在 IDE 歡迎畫面（顯示 Welcome to IntelliJ IDEA）， 請在右上角找到並點擊 New Project 按鈕。

   若你已開啟其他專案，可先關閉該專案，或 前往 File > New > New Project...。

3. 選擇專案類型

   在 New Project 對話框左側的 Generators 區塊中， 選擇 Flutter。

4. 確認 Flutter SDK 設定

   在右側面板頂部，請確保 Flutter SDK path 的路徑 與你要開發的 Flutter SDK 位置相符。 若不相符，請選擇或指定正確的路徑。

5. 設定專案

   點擊 Next 進入專案設定。 會出現多個設定選項。

   在 Project name 欄位，請輸入符合 lowercase_with_underscores 命名規範的應用程式名稱， 並遵循 Effective Dart 指南。

   若你不是要建立應用程式， 請從 Project type 下拉選單選擇其他範本。

   若你預計將來會發佈此應用程式， 請將 Organization 欄位[設為你的公司網域][ij-set-org]。

   其他欄位可維持預設值，或依專案需求調整。

6. 完成專案建立

   完成專案設定後， 點擊 Create 開始初始化專案。

7. 等待工作區初始化

   IntelliJ 會初始化你的工作區， 建立專案檔案結構， 並下載應用程式所需的相依套件。 這個過程可能需要一些時間，可在視窗底部追蹤進度。

8. 執行你的應用程式

   你的新應用程式現在應已建立並在 IntelliJ 中開啟。 若要體驗新應用程式， 請依照 在 IntelliJ 執行與除錯 的步驟操作。

你已成功在 IntelliJ 中建立新的 Flutter 應用程式！ 若需要更多關於在 IntelliJ 開發 Flutter 的協助， 請參考 Flutter 的 IntelliJ 參考文件。

若要使用 [Firebase Studio][fbs] 建立 Flutter 應用程式， 你需要一個 Google 帳戶，並先[設定 Firebase Studio][fbs-setup]。 接著依照以下步驟操作：

1. 啟動 Firebase Studio

   在你偏好的瀏覽器中，前往 [Firebase Studio 控制台][Firebase Studio dashboard]， 網址為 studio.firebase.google.com/。 若尚未登入，請先登入你的 Google 帳戶。

2. 建立新工作區

   在 Firebase Studio 控制台中，找到 Start coding an app 區塊。 這裡會有多種範本可供選擇。 請選擇 Flutter 範本。 若找不到，可能在 Mobile 分類下。

3. 命名你的工作區

   Firebase Studio 會提示

   flutter create --empty

   若要瞭解可用的建立選項，請在另一個終端機視窗中執行 flutter create --help。

4. 輸入專案名稱

   作為 flutter create 唯一的非選項參數，請指定您的應用程式目錄及預設名稱。名稱應遵循 lowercase_with_underscores 命名慣例，並依照 Effective Dart 指南。

   例如，若您想建立一個名為 my_app 的應用程式：

   flutter create my_app

5. 執行已設定的指令

   若要依照你指定的設定建立專案， 請執行你在前一個步驟組成的指令。

6. 等待專案初始化

   flutter 工具現在會初始化你的專案檔案結構， 並下載所有必要的相依套件。 這個過程可能需要一些時間。

7. 進入專案目錄

   現在你的專案已經建立完成， 你可以在終端機或你偏好的編輯器中切換到該目錄。 例如，若你使用 bash shell，且專案名稱為 my_app：

   cd my_app

8. 執行你的應用程式

   若要嘗試你的新應用程式， 請在終端機中執行 flutter run 指令， 並依照提示選擇輸出裝置。

你已經成功在終端機中建立了一個全新的 Flutter 應用程式！ 如果你需要協助設定專案或使用 flutter 命令列介面 (Command Line Interface) 工具， 請參閱 Flutter CLI reference。