開始在 macOS 上建置 Flutter iOS 應用程式

若要使用這些指示安裝 Flutter，請確認您已安裝 Visual Studio Code 1.77 或更新版本，以及 適用於 VS Code 的 Flutter 擴充功能。

1. 啟動 VS Code。

2. 若要開啟命令選擇區，請按下 Command + Shift + P。

3. 在命令選擇區中，輸入 flutter。

4. 選取Flutter: New Project (Flutter：新專案)。

5. VS Code 會提示您在電腦上尋找 Flutter SDK。

   1. 如果您已安裝 Flutter SDK，請按一下Locate SDK (尋找 SDK)。

   2. 如果您尚未安裝 Flutter SDK，請按一下Download SDK (下載 SDK)。

      如果您尚未按照開發工具必要條件中的指示安裝 Git，此選項會將您傳送到 Flutter 安裝頁面。

6. 當提示Which Flutter template? (您要哪個 Flutter 範本？) 時，請忽略它。按下 Esc。您可以在檢查開發設定後建立測試專案。

1. 當顯示Select Folder for Flutter SDK (選取 Flutter SDK 的資料夾) 對話方塊時，請選擇您要安裝 Flutter 的位置。

   VS Code 會將您放在使用者設定檔中以開始。請選擇不同的位置。

   考慮 ~/development/

2. 按一下Clone Flutter (複製 Flutter)。

   下載 Flutter 時，VS Code 會顯示此快顯通知

   Downloading the Flutter SDK. This may take a few minutes.

   此下載需要幾分鐘的時間。如果您懷疑下載已停止，請按一下Cancel (取消)，然後重新開始安裝。

3. 下載 Flutter 完成後，會顯示輸出面板。

   Checking Dart SDK version...
   Downloading Dart SDK from the Flutter engine ...
   Expanding downloaded archive...

   成功時，VS Code 會顯示此快顯通知

   Initializing the Flutter SDK. This may take a few minutes.

   初始化時，輸出面板會顯示以下內容

   Building flutter tool...
   Running pub upgrade...
   Resolving dependencies...
   Got dependencies.
   Downloading Material fonts...
   Downloading Gradle Wrapper...
   Downloading package sky_engine...
   Downloading flutter_patched_sdk tools...
   Downloading flutter_patched_sdk_product tools...
   Downloading windows-x64 tools...
   Downloading windows-x64/font-subset tools...

   此程序也會執行 flutter doctor -v。在此程序中，請忽略此輸出。 Flutter Doctor 可能會顯示不適用於此快速入門的錯誤。

   Flutter 安裝成功時，VS Code 會顯示此快顯通知

   Do you want to add the Flutter SDK to PATH so it's accessible
   in external terminals?

4. VS Code 可能會顯示 Google Analytics 通知。

   如果您同意，請按一下OK (確定)。

5. 若要在所有終端機視窗中啟用 flutter

   1. 關閉然後重新開啟所有終端機視窗。
   2. 重新啟動 VS Code。

要準備在 iOS 模擬器上執行和測試您的 Flutter 應用程式，請依照此程序進行。

1. 要安裝 iOS 模擬器，請執行以下命令。

   xcodebuild -downloadPlatform iOS

2. 要啟動模擬器，請執行以下命令

   open -a Simulator

3. 將您的模擬器設定為使用 64 位元的裝置。這包括 iPhone 5s 或更新的機種。

   • 從 Xcode 中，選擇一個模擬器裝置類型。

     1. 前往視窗 > 裝置和模擬器。

        您也可以按下 Cmd + Shift + 2。

     2. 「裝置和模擬器」對話方塊開啟後，點擊模擬器。

     3. 從左側清單中選擇一個模擬器，或按下 + 以建立新的模擬器。

   • 從「模擬器」應用程式中，前往檔案 > 開啟模擬器 > 選擇您的目標 iOS 裝置。

   • 要在模擬器中檢查裝置版本，請開啟「設定」應用程式 > 一般 > 關於。

4. 模擬的高螢幕密度 iOS 裝置可能會超出您的螢幕。如果您的 Mac 上出現這種情況，請在「模擬器」應用程式中變更顯示的大小。

   顯示大小	選單命令	鍵盤快捷鍵
   小	視窗 > 實體大小	Cmd + 1
   中等	視窗 > 點精確	Cmd + 2
   HD 精確	視窗 > 像素精確	Cmd + 3
   符合螢幕大小	視窗 > 符合螢幕	Cmd + 4

要將您的 Flutter 應用程式部署到實體的 iPhone 或 iPad，您需要執行以下操作

• 建立一個 Apple Developer 帳號。
• 在 Xcode 中設定實體裝置部署。
• 建立開發佈建描述檔以自我簽署憑證。
• 如果您的應用程式使用 Flutter 外掛程式，請安裝第三方 CocoaPods 相依性管理員。

您可以暫時跳過此步驟。在您準備好將您的應用程式發佈到 App Store 之前，您實際上不需要 Apple Developer 帳號。

如果您只需要測試部署您的應用程式，請完成第一個步驟並繼續進行下一節。

1. 如果您沒有 Apple ID，請建立一個。

2. 如果您尚未註冊 Apple Developer 計劃，請立即註冊。

   若要瞭解關於會員類型的更多資訊，請查看 選擇會員資格。

設定您的實體 iOS 裝置以連接到 Xcode。

1. 將您的 iOS 裝置連接到您 Mac 上的 USB 連接埠。

2. 當您第一次將 iOS 裝置連接到 Mac 時，您的 iOS 裝置會顯示「信任這部電腦？」對話方塊。

3. 點擊信任。

   

4. 出現提示時，請解鎖您的 iOS 裝置。

從 iOS 16 開始，Apple 要求您啟用「開發人員模式」以防止惡意軟體。在部署到執行 iOS 16 或更新版本的裝置之前，請啟用「開發人員模式」。

1. 點擊設定 > 隱私權與安全性 > 開發人員模式。

2. 點擊以將「開發人員模式」切換至開啟。

3. 點擊重新啟動。

4. 在 iOS 裝置重新啟動後，解鎖您的 iOS 裝置。

5. 當出現「開啟開發人員模式？」對話方塊時，點擊開啟。

   對話方塊會說明開發人員模式需要降低 iOS 裝置的安全性。

6. 解鎖您的 iOS 裝置。

要部署到實體 iOS 裝置，您需要建立您 Mac 與 iOS 裝置之間的信任關係。這需要您將簽署的開發人員憑證載入到您的 iOS 裝置。要在 Xcode 中簽署應用程式，您需要建立一個開發佈建描述檔。

要佈建您的專案，請依照 Xcode 簽署流程進行。

1. 啟動 Xcode。

2. 前往 Xcode > 設定...

   1. 前往 Xcode > 設定...
   2. 點擊帳號。
   3. 點擊 +。
   4. 選取 Apple ID 並點擊繼續。
   5. 出現提示時，輸入您的 Apple ID 和密碼。
   6. 關閉「設定」對話方塊。

   開發和測試支援任何 Apple ID。

3. 前往檔案 > 開啟...

   您也可以按下 Cmd + O。

4. 導覽至您的 Flutter 專案目錄。

5. 開啟您專案中的預設 Xcode 工作區：ios/Runner.xcworkspace。

6. 在執行按鈕右側的裝置下拉選單中，選取您打算部署到的實體 iOS 裝置。

   它應該會出現在「iOS 裝置」標題下方。

7. 在左側導覽面板中的「目標」下方，選取「Runner」。

8. 在「Runner」設定窗格中，點擊「簽署與功能」。

9. 在頂端選取全部。

10. 選取自動管理簽署。

11. 從「團隊」下拉式選單中選取一個團隊。

    團隊是在您的 Apple Developer 帳號頁面的「App Store Connect」區段中建立的。如果您尚未建立團隊，您可以選擇個人團隊。

    「團隊」下拉式選單會將該選項顯示為您的姓名 (個人團隊)。

    

    在您選取團隊之後，Xcode 會執行以下工作

    1. 建立並下載開發憑證
    2. 在您的帳號中註冊您的裝置，
    3. 如果需要，建立並下載佈建描述檔

如果自動簽署在 Xcode 中失敗，請確認專案的「一般」>「身分」>「套件識別碼」值是唯一的。

當您第一次連接實體 iOS 裝置時，請啟用您的 Mac 和 iOS 裝置上的開發憑證的信任。

當您將裝置連接到 Mac時，您應該已在您的 iOS 裝置上啟用您 Mac 的信任。

啟用憑證在不同版本的 iOS 中有所不同。

如果顯示「codesign 想要存取金鑰...」對話方塊

1. 輸入您的 macOS 密碼。

2. 點擊總是允許。

要使用 Wi-Fi 連線除錯您的裝置，請依照此程序進行。

1. 將您的 iOS 裝置連接到與您的 macOS 裝置相同的網路。

2. 為您的 iOS 裝置設定密碼。

3. 開啟 Xcode。

4. 前往視窗 > 裝置和模擬器。

   您也可以按下 Shift + Cmd + 2。

5. 選取您的 iOS 裝置。

6. 選取透過網路連接。

7. 一旦裝置名稱旁邊出現網路圖示，請將您的 iOS 裝置從 Mac 上拔除。

如果您在使用 flutter run 時看不到列出的裝置，請延長逾時時間。逾時時間預設為 10 秒。要延長逾時時間，請將值變更為大於 10 的整數。

flutter run --device-timeout 60