將 Flutter 模組整合到您的 iOS 專案中

在第二種方法中，編輯您現有的 Xcode 專案，生成必要的框架，並將它們嵌入到您的應用中。Flutter 為 Flutter 本身、您編譯的 Dart 程式碼以及每個 Flutter 外掛生成 iOS 框架。嵌入這些框架並更新您現有的應用程式的構建設定。

此方法不需要額外的軟體或硬體要求。在以下用例中使用此方法

• 您的團隊成員無法安裝 Flutter SDK 和 CocoaPods
• 您不想在現有的 iOS 應用中使用 CocoaPods 作為依賴項管理器

Flutter 無法處理 具有 xcframework 的常見依賴項。如果您同時使用主機應用和 Flutter 模組的外掛定義相同的 pod 依賴項，並且使用此選項整合 Flutter 模組，則會發生錯誤。這些錯誤包括類似 Multiple commands produce 'CommonDependency.framework' 的問題。

要解決此問題，請將 Flutter 模組的每個外掛源連結到主機應用的 Podfile 中的其 podspec 檔案中。連結源而不是外掛的 xcframework 框架。下一節解釋瞭如何 生成該框架。

為了防止由於公共依賴項存在而發生的錯誤，請使用 flutter build ios-framework 命令，並加上 --no-plugins 標誌。

以下示例假定您希望將框架生成到 /path/to/MyApp/Flutter/。

$ flutter build ios-framework --output=/path/to/MyApp/Flutter/

每次更改 Flutter 模組中的程式碼時，都必須執行此命令。

生成的專案結構應類似於以下目錄樹。

您將生成的框架連結、嵌入或同時進行連結和嵌入到您現有的 Xcode 應用中，取決於框架的型別。

• 連結並嵌入動態框架。
• 連結靜態框架。 切勿嵌入它們。

Flutter 外掛可能會生成 靜態或動態框架。連結靜態框架，切勿嵌入它們。

如果您將靜態框架嵌入到您的 iOS 應用中，您將無法將該應用釋出到 App Store。釋出會因 Found an unexpected Mach-O header code 存檔錯誤而失敗。

要連結必要的框架，請按照以下步驟操作。

1. 選擇要連結的框架。

   1. 在 專案導航器 中，單擊您的專案。

   2. 單擊 構建階段 選項卡。

   3. 展開 連結二進位制檔案與庫。

      

   4. 單擊 + (加號)。

   5. 單擊 新增其他...，然後單擊 新增檔案...。

   6. 在 選擇要新增的框架和庫： 對話方塊中，導航到 /path/to/MyApp/Flutter/Release/ 目錄。

   7. 命令單擊該目錄中的框架，然後單擊 開啟。

      

2. 更新庫的路徑以考慮構建模式。

   1. 啟動 Finder。

   2. 導航到 /path/to/MyApp/ 目錄。

   3. 右鍵單擊 MyApp.xcodeproj 並選擇 顯示包內容。

   4. 使用 Xcode 開啟 project.pbxproj。該檔案在 Xcode 的文字編輯器中開啟。這也會鎖定 專案導航器，直到您關閉文字編輯器。

      

   5. 在 /* Begin PBXFileReference section */ 中找到類似於以下文字的行。

      312885572C1A441C009F74FF /* Flutter.xcframework */ = {
        isa = PBXFileReference;
        expectedSignature = "AppleDeveloperProgram:S8QB4VV633:FLUTTER.IO LLC";
        lastKnownFileType = wrapper.xcframework;
        name = Flutter.xcframework;
        path = Flutter/Release/Flutter.xcframework;
        sourceTree = "<group>";
      };
      312885582C1A441C009F74FF /* App.xcframework */ = {
        isa = PBXFileReference;
        lastKnownFileType = wrapper.xcframework;
        name = App.xcframework;
        path = Flutter/Release/App.xcframework;
        sourceTree = "<group>";
      };
      

      content_copy

   6. 更改上一步中突出顯示的 Release 文字，並將其更改為 $(CONFIGURATION)。同時用引號將路徑括起來。

      312885572C1A441C009F74FF /* Flutter.xcframework */ = {
        isa = PBXFileReference;
        expectedSignature = "AppleDeveloperProgram:S8QB4VV633:FLUTTER.IO LLC";
        lastKnownFileType = wrapper.xcframework;
        name = Flutter.xcframework;
        path = "Flutter/$(CONFIGURATION)/Flutter.xcframework";
        sourceTree = "<group>";
      };
      312885582C1A441C009F74FF /* App.xcframework */ = {
        isa = PBXFileReference;
        lastKnownFileType = wrapper.xcframework;
        name = App.xcframework;
        path = "Flutter/$(CONFIGURATION)/App.xcframework";
        sourceTree = "<group>";
      };
      

      content_copy

3. 更新搜尋路徑。

   1. 單擊 構建設定 選項卡。

   2. 導航到 搜尋路徑

   3. 雙擊 框架搜尋路徑 右側。

   4. 在組合框中，單擊 + (加號)。

   5. 鍵入 $(inherited) 並按 Enter。

   6. 單擊 + (加號)。

   7. 鍵入 $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/ 並按 Enter。

      

連結框架後，它們應顯示在目標 常規 設定的 框架、庫和嵌入內容 部分中。

要嵌入您的動態框架，請完成以下步驟。

1. 導航到 常規 > 框架、庫和嵌入內容。

2. 單擊您的每個動態框架，然後選擇 嵌入 & 簽名。

   

   不要包含任何靜態框架，包括 FlutterPluginRegistrant.xcframework。

3. 單擊 構建階段 選項卡。

4. 展開 嵌入框架。您的動態框架應顯示在該部分中。

   

5. 構建專案。

   1. 在 Xcode 中開啟 MyApp.xcworkspace。

      驗證您是否正在開啟 MyApp.xcworkspace 而不是開啟 MyApp.xcodeproj。.xcworkspace 檔案具有 CocoaPod 依賴項，而 .xcodeproj 沒有。

   2. 選擇 產品 > 構建 或按 Cmd + B。

1. 生成 Flutter LLDB 檔案。

   1. 在您的 Flutter 應用程式中，如果您尚未這樣做，請重新執行 flutter build ios-framework

   $ flutter build ios-framework --output=/path/to/MyApp/Flutter/
   

   content_copy

   這將在 /path/to/MyApp/Flutter/ 目錄中生成 LLDB 檔案。

2. 設定 LLDB Init 檔案。

   1. 轉到 Product > Scheme > Edit Scheme。

   2. 在左側邊欄中選擇 Run 部分。

   3. 將 LLDB 初始化檔案 設定為以下內容

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

      如果您的方案已經具有 LLDB Init File，您可以將 Flutter 的 LLDB 檔案新增到其中。Flutter LLDB Init 檔案的路徑必須相對於您的專案的 LLDB Init 檔案的位置。

      例如，如果您的 LLDB 檔案位於 /path/to/MyApp/.lldbinit，您將新增以下內容

      command source --relative-to-command-file "Flutter/flutter_lldbinit"
      

      content_copy

此方法生成 Flutter 作為 CocoaPods podspec，而不是將大型 Flutter.xcframework 分發給其他開發人員、機器或持續整合系統。Flutter 仍然為您的編譯後的 Dart 程式碼以及您的每個 Flutter 外掛生成 iOS 框架。嵌入這些框架並更新您現有應用程式的構建設定。

此方法不需要額外的軟體或硬體要求。在以下用例中使用此方法

• 您的團隊成員無法安裝 Flutter SDK 和 CocoaPods
• 您不想在現有的 iOS 應用中使用 CocoaPods 作為依賴項管理器

Flutter 無法處理 具有 xcframework 的常見依賴項。如果您同時使用主機應用和 Flutter 模組的外掛定義相同的 pod 依賴項，並且使用此選項整合 Flutter 模組，則會發生錯誤。這些錯誤包括類似 Multiple commands produce 'CommonDependency.framework' 的問題。

要解決此問題，請將 Flutter 模組的每個外掛源連結到主機應用的 Podfile 中的其 podspec 檔案中。連結源而不是外掛的 xcframework 框架。下一節解釋瞭如何 生成該框架。

為了防止由於公共依賴項存在而發生的錯誤，請使用 flutter build ios-framework 命令，並加上 --no-plugins 標誌。

此方法僅適用於 beta 或 stable 釋出通道。

以下示例假定您希望將框架生成到 /path/to/MyApp/Flutter/。

$ flutter build ios-framework --output=/path/to/MyApp/Flutter/

每次更改 Flutter 模組中的程式碼時，都必須執行此命令。

生成的專案結構應類似於以下目錄樹。

可以使用 CocoaPods 的宿主應用將 Flutter 引擎新增到其 Podfile。

pod 'Flutter', :podspec => '/path/to/MyApp/Flutter/[build mode]/Flutter.podspec'

Flutter 外掛可能會生成 靜態或動態框架。連結靜態框架，切勿嵌入它們。

如果您將靜態框架嵌入到您的 iOS 應用中，您將無法將該應用釋出到 App Store。釋出會因 Found an unexpected Mach-O header code 存檔錯誤而失敗。

要連結必要的框架，請按照以下步驟操作。

1. 選擇要連結的框架。

   1. 在 專案導航器 中，單擊您的專案。

   2. 單擊 構建階段 選項卡。

   3. 展開 連結二進位制檔案與庫。

      

   4. 單擊 + (加號)。

   5. 單擊 新增其他...，然後單擊 新增檔案...。

   6. 在 選擇要新增的框架和庫： 對話方塊中，導航到 /path/to/MyApp/Flutter/Release/ 目錄。

   7. 命令單擊該目錄中的框架，然後單擊 開啟。

      

2. 更新庫的路徑以考慮構建模式。

   1. 啟動 Finder。

   2. 導航到 /path/to/MyApp/ 目錄。

   3. 右鍵單擊 MyApp.xcodeproj 並選擇 顯示包內容。

   4. 使用 Xcode 開啟 project.pbxproj。該檔案在 Xcode 的文字編輯器中開啟。這也會鎖定 專案導航器，直到您關閉文字編輯器。

      

   5. 在 /* Begin PBXFileReference section */ 中找到類似於以下文字的行。

      312885572C1A441C009F74FF /* Flutter.xcframework */ = {
        isa = PBXFileReference;
        expectedSignature = "AppleDeveloperProgram:S8QB4VV633:FLUTTER.IO LLC";
        lastKnownFileType = wrapper.xcframework;
        name = Flutter.xcframework;
        path = Flutter/Release/Flutter.xcframework;
        sourceTree = "<group>";
      };
      312885582C1A441C009F74FF /* App.xcframework */ = {
        isa = PBXFileReference;
        lastKnownFileType = wrapper.xcframework;
        name = App.xcframework;
        path = Flutter/Release/App.xcframework;
        sourceTree = "<group>";
      };
      

      content_copy

   6. 更改上一步中突出顯示的 Release 文字，並將其更改為 $(CONFIGURATION)。同時用引號將路徑括起來。

      312885572C1A441C009F74FF /* Flutter.xcframework */ = {
        isa = PBXFileReference;
        expectedSignature = "AppleDeveloperProgram:S8QB4VV633:FLUTTER.IO LLC";
        lastKnownFileType = wrapper.xcframework;
        name = Flutter.xcframework;
        path = "Flutter/$(CONFIGURATION)/Flutter.xcframework";
        sourceTree = "<group>";
      };
      312885582C1A441C009F74FF /* App.xcframework */ = {
        isa = PBXFileReference;
        lastKnownFileType = wrapper.xcframework;
        name = App.xcframework;
        path = "Flutter/$(CONFIGURATION)/App.xcframework";
        sourceTree = "<group>";
      };
      

      content_copy

3. 更新搜尋路徑。

   1. 單擊 構建設定 選項卡。

   2. 導航到 搜尋路徑

   3. 雙擊 框架搜尋路徑 右側。

   4. 在組合框中，單擊 + (加號)。

   5. 鍵入 $(inherited) 並按 Enter。

   6. 單擊 + (加號)。

   7. 鍵入 $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/ 並按 Enter。

      

連結框架後，它們應顯示在目標 常規 設定的 框架、庫和嵌入內容 部分中。

要嵌入您的動態框架，請完成以下步驟。

1. 導航到 常規 > 框架、庫和嵌入內容。

2. 單擊您的每個動態框架，然後選擇 嵌入 & 簽名。

   

   不要包含任何靜態框架，包括 FlutterPluginRegistrant.xcframework。

3. 單擊 構建階段 選項卡。

4. 展開 嵌入框架。您的動態框架應顯示在該部分中。

   

5. 構建專案。

   1. 在 Xcode 中開啟 MyApp.xcworkspace。

      驗證您是否正在開啟 MyApp.xcworkspace 而不是開啟 MyApp.xcodeproj。.xcworkspace 檔案具有 CocoaPod 依賴項，而 .xcodeproj 沒有。

   2. 選擇 產品 > 構建 或按 Cmd + B。

1. 生成 Flutter LLDB 檔案。

   1. 在您的 Flutter 應用程式中，如果您尚未這樣做，請重新執行 flutter build ios-framework

   $ flutter build ios-framework --output=/path/to/MyApp/Flutter/
   

   content_copy

   這將在 /path/to/MyApp/Flutter/ 目錄中生成 LLDB 檔案。

2. 設定 LLDB Init 檔案。

   1. 轉到 Product > Scheme > Edit Scheme。

   2. 在左側邊欄中選擇 Run 部分。

   3. 將 LLDB 初始化檔案 設定為以下內容

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

      如果您的方案已經具有 LLDB Init File，您可以將 Flutter 的 LLDB 檔案新增到其中。Flutter LLDB Init 檔案的路徑必須相對於您的專案的 LLDB Init 檔案的位置。

      例如，如果您的 LLDB 檔案位於 /path/to/MyApp/.lldbinit，您將新增以下內容

      command source --relative-to-command-file "Flutter/flutter_lldbinit"
      

      content_copy