Integrar un módulo Flutter en tu proyecto iOS (Heredado)

En este segundo método, edita tu proyecto de Xcode existente, genera los frameworks necesarios y embébelos en tu aplicación. Flutter genera frameworks de iOS para el propio Flutter, para tu código Dart compilado y para cada uno de tus plugins de Flutter. Embebe estos frameworks y actualiza los ajustes de compilación de tu aplicación existente.

No se requieren requisitos adicionales de software o hardware para este método. Utiliza este método en los siguientes casos de uso:

• Los miembros de tu equipo no pueden instalar el SDK de Flutter ni CocoaPods.
• No deseas usar CocoaPods como gestor de dependencias en aplicaciones iOS existentes.

Flutter no puede manejar dependencias comunes con xcframeworks. Si tanto la aplicación anfitriona como el plugin del módulo Flutter definen la misma dependencia de pod e integras el módulo Flutter utilizando esta opción, se producirán errores. Estos errores incluyen problemas como Multiple commands produce 'CommonDependency.framework'.

Para solucionar este problema, vincula cada origen de plugin en su archivo podspec desde el módulo Flutter al Podfile de la aplicación anfitriona. Vincula el origen en lugar del framework xcframework de los plugins. La siguiente sección explica cómo producir ese framework.

Para evitar el error que ocurre cuando existen dependencias comunes, utiliza flutter build ios-framework con la bandera --no-plugins.

El siguiente ejemplo asume que deseas generar los frameworks en /path/to/MyApp/Flutter/.

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

Ejecuta esto cada vez que cambies el código en tu módulo Flutter.

La estructura del proyecto resultante debería asemejarse a este árbol de directorios.

La forma en que vincules, embebas o ambas cosas los frameworks generados en tu aplicación existente en Xcode depende del tipo de framework.

• Vincular y embeber frameworks dinámicos.
• Vincula los frameworks estáticos. Nunca los embebas.

Los plugins de Flutter pueden producir frameworks estáticos o dinámicos. Vincula los frameworks estáticos, y nunca los embebas.

Si embebes un framework estático en tu aplicación iOS, no podrás publicar esa aplicación en la App Store. La publicación fallará con un error de archivo Found an unexpected Mach-O header code.

Para vincular los frameworks necesarios, sigue este procedimiento.

1. Elige los frameworks a vincular.

   1. En el Project Navigator, haz clic en tu proyecto.

   2. Haz clic en la pestaña Build Phases.

   3. Expande Link Binary With Libraries.

      

   4. Haz clic en + (signo más).

   5. Haz clic en Add Other... y luego en Add Files....

   6. En el cuadro de diálogo Choose frameworks and libraries to add:, navega al directorio /path/to/MyApp/Flutter/Release/.

   7. Haz clic con Command en los frameworks de ese directorio, luego haz clic en Open.

      

2. Actualizar las rutas a las bibliotecas para tener en cuenta los modos de compilación.

   1. Lanzar el Finder.

   2. Navega al directorio /path/to/MyApp/.

   3. Haz clic derecho en MyApp.xcodeproj y selecciona Show Package Contents.

   4. Abre project.pbxproj con Xcode. El archivo se abre en el editor de texto de Xcode. Esto también bloquea el Project Navigator hasta que cierres el editor de texto.

      

   5. Busca las líneas que se asemejen al siguiente texto en la sección /* 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. Modifica el texto Release resaltado en el paso anterior y cámbialo a $(CONFIGURATION). También encierra la ruta entre comillas.

      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. Actualizar las rutas de búsqueda (Search Paths).

   1. Haz clic en la pestaña Build Settings.

   2. Navega a Search Paths

   3. Haz doble clic a la derecha de Framework Search Paths.

   4. En el cuadro combinado, haz clic en + (signo más).

   5. Escribe $(inherited) y presiona Enter.

   6. Haz clic en + (signo más).

   7. Escribe $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/ y presiona Enter.

      

Después de vincular los frameworks, deberían mostrarse en la sección Frameworks, Libraries, and Embedded Content de los ajustes General de tu target.

Para embeber tus frameworks dinámicos, completa el siguiente procedimiento.

1. Navega a General > Frameworks, Libraries, and Embedded Content.

2. Haz clic en cada uno de tus frameworks dinámicos y selecciona Embed & Sign.

   

   No incluyas ningún framework estático, incluyendo FlutterPluginRegistrant.xcframework.

3. Haz clic en la pestaña Build Phases.

4. Expande Embed Frameworks. Tus frameworks dinámicos deberían mostrarse en esa sección.

   

5. Compilar el proyecto.

   1. Abre MyApp.xcworkspace en Xcode.

      Verifica que estás abriendo MyApp.xcworkspace y no abriendo MyApp.xcodeproj. El archivo .xcworkspace tiene las dependencias de CocoaPods, el .xcodeproj no las tiene.

   2. Selecciona Product > Build o presiona Cmd + B.

1. Generar archivos LLDB de Flutter.

   1. Dentro de tu aplicación flutter, vuelve a ejecutar el comando flutter build ios-framework si no lo has hecho ya:

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

   content_copy

   Esto generará los archivos LLDB en el directorio /path/to/MyApp/Flutter/.

2. Establecer el archivo LLDB Init.

   1. Ve a Product > Scheme > Edit Scheme.

   2. Selecciona la sección Run en la barra lateral izquierda.

   3. Establece el LLDB Init File en lo siguiente:

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

      Si tu scheme ya tiene un archivo LLDB Init File, puedes añadir el archivo LLDB de Flutter a él. La ruta al archivo LLDB Init de Flutter debe ser relativa a la ubicación del archivo LLDB Init de tu proyecto.

      Por ejemplo, si tu archivo LLDB está ubicado en /path/to/MyApp/.lldbinit, añadirías lo siguiente:

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

      content_copy

Este método genera Flutter como un podspec de CocoaPods en vez de distribuir el gran Flutter.xcframework a otros desarrolladores, máquinas o sistemas de integración continua. Flutter sigue generando frameworks de iOS para tu código Dart compilado, y para cada uno de tus plugins de Flutter. Embebe estos frameworks y actualiza los ajustes de compilación de tu aplicación existente.

No se requieren requisitos adicionales de software o hardware para este método. Utiliza este método en los siguientes casos de uso:

• Los miembros de tu equipo no pueden instalar el SDK de Flutter ni CocoaPods.
• No deseas usar CocoaPods como gestor de dependencias en aplicaciones iOS existentes.

Flutter no puede manejar dependencias comunes con xcframeworks. Si tanto la aplicación anfitriona como el plugin del módulo Flutter definen la misma dependencia de pod e integras el módulo Flutter utilizando esta opción, se producirán errores. Estos errores incluyen problemas como Multiple commands produce 'CommonDependency.framework'.

Para solucionar este problema, vincula cada origen de plugin en su archivo podspec desde el módulo Flutter al Podfile de la aplicación anfitriona. Vincula el origen en lugar del framework xcframework de los plugins. La siguiente sección explica cómo producir ese framework.

Para evitar el error que ocurre cuando existen dependencias comunes, utiliza flutter build ios-framework con la bandera --no-plugins.

Este método solo funciona con los canales de lanzamiento beta o stable.

El siguiente ejemplo asume que deseas generar los frameworks en /path/to/MyApp/Flutter/.

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

Ejecuta esto cada vez que cambies el código en tu módulo Flutter.

La estructura del proyecto resultante debería asemejarse a este árbol de directorios.

Las aplicaciones anfitrionas que utilizan CocoaPods pueden añadir el motor de Flutter a su Podfile.

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

Los plugins de Flutter pueden producir frameworks estáticos o dinámicos. Vincula los frameworks estáticos, y nunca los embebas.

Si embebes un framework estático en tu aplicación iOS, no podrás publicar esa aplicación en la App Store. La publicación fallará con un error de archivo Found an unexpected Mach-O header code.

Para vincular los frameworks necesarios, sigue este procedimiento.

1. Elige los frameworks a vincular.

   1. En el Project Navigator, haz clic en tu proyecto.

   2. Haz clic en la pestaña Build Phases.

   3. Expande Link Binary With Libraries.

      

   4. Haz clic en + (signo más).

   5. Haz clic en Add Other... y luego en Add Files....

   6. En el cuadro de diálogo Choose frameworks and libraries to add:, navega al directorio /path/to/MyApp/Flutter/Release/.

   7. Haz clic con Command en los frameworks de ese directorio, luego haz clic en Open.

      

2. Actualizar las rutas a las bibliotecas para tener en cuenta los modos de compilación.

   1. Lanzar el Finder.

   2. Navega al directorio /path/to/MyApp/.

   3. Haz clic derecho en MyApp.xcodeproj y selecciona Show Package Contents.

   4. Abre project.pbxproj con Xcode. El archivo se abre en el editor de texto de Xcode. Esto también bloquea el Project Navigator hasta que cierres el editor de texto.

      

   5. Busca las líneas que se asemejen al siguiente texto en la sección /* 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. Modifica el texto Release resaltado en el paso anterior y cámbialo a $(CONFIGURATION). También encierra la ruta entre comillas.

      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. Actualizar las rutas de búsqueda (Search Paths).

   1. Haz clic en la pestaña Build Settings.

   2. Navega a Search Paths

   3. Haz doble clic a la derecha de Framework Search Paths.

   4. En el cuadro combinado, haz clic en + (signo más).

   5. Escribe $(inherited) y presiona Enter.

   6. Haz clic en + (signo más).

   7. Escribe $(PROJECT_DIR)/Flutter/$(CONFIGURATION)/ y presiona Enter.

      

Después de vincular los frameworks, deberían mostrarse en la sección Frameworks, Libraries, and Embedded Content de los ajustes General de tu target.

Para embeber tus frameworks dinámicos, completa el siguiente procedimiento.

1. Navega a General > Frameworks, Libraries, and Embedded Content.

2. Haz clic en cada uno de tus frameworks dinámicos y selecciona Embed & Sign.

   

   No incluyas ningún framework estático, incluyendo FlutterPluginRegistrant.xcframework.

3. Haz clic en la pestaña Build Phases.

4. Expande Embed Frameworks. Tus frameworks dinámicos deberían mostrarse en esa sección.

   

5. Compilar el proyecto.

   1. Abre MyApp.xcworkspace en Xcode.

      Verifica que estás abriendo MyApp.xcworkspace y no abriendo MyApp.xcodeproj. El archivo .xcworkspace tiene las dependencias de CocoaPods, el .xcodeproj no las tiene.

   2. Selecciona Product > Build o presiona Cmd + B.

1. Generar archivos LLDB de Flutter.

   1. Dentro de tu aplicación flutter, vuelve a ejecutar el comando flutter build ios-framework si no lo has hecho ya:

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

   content_copy

   Esto generará los archivos LLDB en el directorio /path/to/MyApp/Flutter/.

2. Establecer el archivo LLDB Init.

   1. Ve a Product > Scheme > Edit Scheme.

   2. Selecciona la sección Run en la barra lateral izquierda.

   3. Establece el LLDB Init File en lo siguiente:

      $(PROJECT_DIR)/Flutter/flutter_lldbinit
      

      content_copy

      Si tu scheme ya tiene un archivo LLDB Init File, puedes añadir el archivo LLDB de Flutter a él. La ruta al archivo LLDB Init de Flutter debe ser relativa a la ubicación del archivo LLDB Init de tu proyecto.

      Por ejemplo, si tu archivo LLDB está ubicado en /path/to/MyApp/.lldbinit, añadirías lo siguiente:

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

      content_copy