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

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

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

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

Flutter 無法處理 xcframeworks 的公共依賴項。如果宿主應用和 Flutter 模組的外掛都定義了相同的 pod 依賴項，並且您使用此選項整合 Flutter 模組，則會導致錯誤。這些錯誤包括諸如 Multiple commands produce 'CommonDependency.framework' 之類的問題。

為了解決此問題，請將 Flutter 模組 podspec 檔案中的每個外掛原始碼連結到宿主應用的 Podfile。連結原始碼而不是外掛的 xcframework 框架。下一節將解釋如何 生成該框架。

為防止出現公共依賴項導致的錯誤，請使用帶有 --no-plugins 標誌的 flutter build ios-framework。

以下示例假設您要將框架生成到 /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. 在 Project Navigator（專案導航器）中，點選您的專案。

   2. 點選 Build Phases（構建階段）選項卡。

   3. 展開 Link Binary With Libraries（用庫連結二進位制檔案）。

      

   4. 點選 +（加號）。

   5. 點選 Add Other...，然後點選 Add Files...。

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

   7. 按住 Cmd 點選該目錄中的框架，然後點選 Open。

      

2. 更新庫路徑以應對構建模式。

   1. 啟動 Finder。

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

   3. 右鍵點選 MyApp.xcodeproj 並選擇 Show Package Contents（顯示包內容）。

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

      

   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. 點選 Build Settings（構建設定）選項卡。

   2. 導航到 Search Paths（搜尋路徑）

   3. 雙擊 Framework Search Paths（框架搜尋路徑）右側的內容。

   4. 在組合框中，點選 +（加號）。

   5. 輸入 $(inherited)，然後按下 Enter。

   6. 點選 +（加號）。

   7. 輸入 $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/，然後按下 Enter。

      

連結框架後，它們應該會顯示在目標 (target) 的 General（常規）設定的 Frameworks, Libraries, and Embedded Content（框架、庫和嵌入內容）部分中。

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

1. 導航到 General > Frameworks, Libraries, and Embedded Content。

2. 點選您的每個動態框架並選擇 Embed & Sign（嵌入並簽名）。

   

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

3. 點選 Build Phases（構建階段）選項卡。

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

   

5. 構建專案。

   1. 在 Xcode 中開啟 MyApp.xcworkspace。

      請務必開啟 MyApp.xcworkspace，而不是開啟 MyApp.xcodeproj。.xcworkspace 檔案包含 CocoaPod 依賴項，而 .xcodeproj 則不包含。

   2. 選擇 Product > Build 或按下 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 初始化檔案。

   1. 轉到 Product > Scheme > Edit Scheme。

   2. 選擇左側邊欄中的 Run（執行）部分。

   3. 將 LLDB Init File 設定為以下內容

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

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

      例如，如果您的 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 無法處理 xcframeworks 的公共依賴項。如果宿主應用和 Flutter 模組的外掛都定義了相同的 pod 依賴項，並且您使用此選項整合 Flutter 模組，則會導致錯誤。這些錯誤包括諸如 Multiple commands produce 'CommonDependency.framework' 之類的問題。

為了解決此問題，請將 Flutter 模組 podspec 檔案中的每個外掛原始碼連結到宿主應用的 Podfile。連結原始碼而不是外掛的 xcframework 框架。下一節將解釋如何 生成該框架。

為防止出現公共依賴項導致的錯誤，請使用帶有 --no-plugins 標誌的 flutter build ios-framework。

此方法僅適用於 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. 在 Project Navigator（專案導航器）中，點選您的專案。

   2. 點選 Build Phases（構建階段）選項卡。

   3. 展開 Link Binary With Libraries（用庫連結二進位制檔案）。

      

   4. 點選 +（加號）。

   5. 點選 Add Other...，然後點選 Add Files...。

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

   7. 按住 Cmd 點選該目錄中的框架，然後點選 Open。

      

2. 更新庫路徑以應對構建模式。

   1. 啟動 Finder。

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

   3. 右鍵點選 MyApp.xcodeproj 並選擇 Show Package Contents（顯示包內容）。

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

      

   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. 點選 Build Settings（構建設定）選項卡。

   2. 導航到 Search Paths（搜尋路徑）

   3. 雙擊 Framework Search Paths（框架搜尋路徑）右側的內容。

   4. 在組合框中，點選 +（加號）。

   5. 輸入 $(inherited)，然後按下 Enter。

   6. 點選 +（加號）。

   7. 輸入 $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/，然後按下 Enter。

      

連結框架後，它們應該會顯示在目標 (target) 的 General（常規）設定的 Frameworks, Libraries, and Embedded Content（框架、庫和嵌入內容）部分中。

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

1. 導航到 General > Frameworks, Libraries, and Embedded Content。

2. 點選您的每個動態框架並選擇 Embed & Sign（嵌入並簽名）。

   

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

3. 點選 Build Phases（構建階段）選項卡。

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

   

5. 構建專案。

   1. 在 Xcode 中開啟 MyApp.xcworkspace。

      請務必開啟 MyApp.xcworkspace，而不是開啟 MyApp.xcodeproj。.xcworkspace 檔案包含 CocoaPod 依賴項，而 .xcodeproj 則不包含。

   2. 選擇 Product > Build 或按下 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 初始化檔案。

   1. 轉到 Product > Scheme > Edit Scheme。

   2. 選擇左側邊欄中的 Run（執行）部分。

   3. 將 LLDB Init File 設定為以下內容

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

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

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

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

      content_copy