Integrar un módulo Flutter en tu proyecto Android

Para integrar un módulo Flutter con una aplicación Android existente de forma manual, sin utilizar el plugin de Android Studio de Flutter, sigue estos pasos:

Asumiendo que tienes una aplicación Android existente en some/path/MyApp, y que deseas que tu proyecto de Flutter esté en el mismo nivel, haz lo siguiente:

cd some/path/
flutter create -t module --org com.example flutter_module

Esto crea un proyecto de módulo Flutter en some/path/flutter_module/ con algo de código Dart para comenzar y una subcarpeta oculta .android/. La carpeta .android contiene un proyecto Android que puede ayudarte tanto a ejecutar una versión independiente básica de tu módulo Flutter con flutter run como a servir de envoltura para ayudar a preparar el módulo Flutter como una biblioteca Android embebible.

Flutter requiere que tu proyecto declare compatibilidad con Java 17 o posterior.

Antes de intentar conectar tu proyecto de módulo Flutter a tu aplicación Android anfitriona, asegúrate de que tu aplicación Android anfitriona declare la siguiente compatibilidad de origen dentro del archivo build.gradle de tu aplicación, bajo el bloque android { }.

android {
    // ...
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17 // The minimum value
        targetCompatibility = JavaVersion.VERSION_17 // The minimum value
    }
    // ...
}

A partir de Gradle 7, Android recomienda utilizar declaraciones de repositorio centralizadas en settings.gradle en lugar de declaraciones a nivel de proyecto o módulo en los archivos build.gradle.

Antes de intentar conectar tu proyecto de módulo Flutter a tu aplicación Android anfitriona, realiza los siguientes cambios en tu aplicación anfitriona:

1. Elimina el bloque repositories en todos los archivos build.gradle de tu aplicación.

   groovy

   // Remove the following block, starting on the next line
       repositories {
           google()
           mavenCentral()
       }
   // ...to the previous line
   

   content_copy

2. Añade el bloque dependencyResolutionManagement que se muestra en este paso al archivo settings.gradle.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    val storageUrl: String = System.getenv("FLUTTER_STORAGE_BASE_URL") ?: "https://storage.googleapis.com"
    repositories {
        google()
        mavenCentral()
        maven("$storageUrl/download.flutter.io")
    }
}

dependencyResolutionManagement {
    repositoriesMode = RepositoriesMode.PREFER_SETTINGS
    String storageUrl = System.env.FLUTTER_STORAGE_BASE_URL ?: "https://storage.googleapis.com"
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("$storageUrl/download.flutter.io")
        }
    }
}

Esta opción habilita una compilación en un solo paso tanto para tu proyecto Android como para tu proyecto Flutter. Esta opción es conveniente cuando trabajas en ambas partes simultáneamente e iteras rápidamente, pero tu equipo debe instalar el SDK de Flutter para compilar la aplicación anfitriona.

Incluye el módulo Flutter como un subproyecto en el archivo de la aplicación anfitriona settings.gradle. Este ejemplo asume que flutter_module y MyApp existen en el mismo directorio

Si estás usando Kotlin, aplica los siguientes cambios:

// Include the host app project. Assumed existing content.
include(":app")
// Replace "flutter_module" with whatever package_name you supplied when you ran:
// `$ flutter create -t module [package_name]
val filePath = settingsDir.parentFile.toString() + "/flutter_module/.android/include_flutter.groovy"
apply(from = File(filePath))

Si estás usando Groovy, aplica los siguientes cambios:

// Include the host app project.
include(":app")                                   // assumed existing content
setBinding(new Binding([gradle: this]))           // new
def filePath = settingsDir.parentFile.toString() + "/flutter_module/.android/include_flutter.groovy" // new
apply from: filePath                              // new

La vinculación y la evaluación del script permiten que el módulo Flutter se incluya a sí mismo (como :flutter) y cualquier plugin de Flutter utilizado por el módulo (como :package_info y :video_player) en el contexto de evaluación de tu settings.gradle.

Introduce una dependencia de implementation en el módulo Flutter desde tu aplicación:

dependencies {
    implementation(project(":flutter"))
}