下載並設定專案

在本地運行專案

1. 從 專案程式庫 clone 專案至你的電腦。

   注意

   請勿將 Flutter 安裝/放置到以下目錄或路徑中：

   • 路徑包含特殊字元或空格。
   • 路徑需要較高權限。

   例： C:\Program Files\ 、 ~/dev/我的專案/ 皆屬上述情況。

2. 使用你的 IDE 開啟專案，並在終端執行下列指令為專案安裝相關依賴套件。

   flutter pub get

3. 輸入下列指令來自動化產生專案/套件需要的額外程式碼：

   flutter packages pub run build_runner build

   注意

   若有修改到會產生額外 dart code 檔案時，執行 flutter packages pub run build_runner build 會遇到產生檔衝突。
   請選擇 1. Delete 刪除既有的產生檔案 xxx.g.dart。
   或者直接使用此指令，在遭遇產生檔衝突時，直接以新產生檔覆蓋既有產生檔：

   flutter packages pub run build_runner build --delete-conflicting-outputs

4. 執行專案。

   選定編譯目標裝置後，執行啟動，在選定的裝置上執行起來。

   ▼ 在 Android Studio (右上) 選定 Pixel 7 Pro (mobile) 作為編譯目標裝置

   

   1. 選擇裝置：

      • 依照下圖 [1] 與 [2] 順序設定。

        INFO

        

      • 用熱鍵 ⌘ command + ⇧ shift + P (Windows: ctrl + shift + P) 開啟命令面板 (Command Palette)。
        輸入 flutter 找到並點擊 Flutter: Select Device。
        選擇裝置。

   2. 執行 app： Run ＞ Start Debugging 或按鍵 F5。

   使用以下指令：

   flutter run

   該指令會自動尋找可用裝置。
   若當前有多台可用裝置，請按照指令的訊息回覆來指定裝置，訊息應會類似：

   Connected devices:
   Pixel 6 (mobile)                • XxXxXxXxXxXxXx        • android-arm64 • Android ...
   sdk gphone64 arm64 (mobile)     • emulator-1234         • android-arm64 • Android ... (emulator)
   Mac Designed for iPad (desktop) • mac-designed-for-ipad • darwin        • macOS 14.5 23F79 darwin-arm64
   
   No wireless devices were found.
   
   [1]: Pixel 6 (XxXxXxXxXxXxXx)
   [2]: sdk gphone64 arm64 (emulator-1234)
   [3]: Mac Designed for iPad (mac-designed-for-ipad)
   Please choose one (or "q" to quit):

   依上為例，輸入 1, 2 或 3 來選定裝置。

小撇步

Flutter 在程式執行時支援 Hot Reload，能夠在不重新啟動 app 的狀態下，根據調整的內容更新 APP 畫面與邏輯。

更多關於 Hot Reload 的資訊可參考：官方文件。