将 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