Aplicación móvil desarrollada con Flutter que integra Home Screen Widgets nativos tanto en Android (AppWidget) como en iOS (WidgetKit) utilizando el paquete home_widget. La aplicación permite visualizar noticias destacadas, renderizar gráficos vectoriales Flutter fuera de pantalla hacia imágenes bitmap y actualizar dinámicamente los widgets de la pantalla de inicio del sistema operativo con títulos, descripciones e imágenes sincronizadas.
- Flutter SDK (v3.x / Dart 3.x): Framework de desarrollo multiplataforma compilado a código nativo.
- Material UI / Material Design 3: Sistema de diseño y tematización visual con paletas generadas dinámicamente (
ColorScheme.fromSeed(seedColor: Colors.deepPurple)). - Home Widget (
home_widget): Librería encargada de la comunicación bidireccional entre la capa Flutter (Dart) y las APIs nativas de widgets de Android e iOS. - Shared Preferences (
shared_preferences): Persistencia clave-valor compartida para el paso de información entre procesos. - Cupertino Icons: Tipografía de glifos e iconos estilizados para iOS.
- Tipografía personalizada (
Chewy): Fuente TrueType (fonts/Chewy-Regular.ttf) registrada enpubspec.yamly cargada tanto en Flutter como a nivel nativo en iOS víaCoreText.
CustomPainter&Canvas API: Dibujo procedural a bajo nivel del componenteLineChartmediante trazos vectoriales (Path,Paint).- Renderizado Off-Screen (
HomeWidget.renderFlutterWidget): Captura del widgetLineCharten memoria a resolución lógica y pixel ratio del dispositivo para persistirlo como archivo PNG y enviarlo al widget nativo.
- Lenguaje: Kotlin & Java.
- Android AppWidget Framework: Implementación de
NewsWidget : AppWidgetProvidercon soporte para ciclo de vidaonUpdate. - Vistas Remotas (
RemoteViews): Maquetación declarativa XML enres/layout/news_widget.xmlconTextViewyImageView. - Gráficos Bitmap: Decodificación de imágenes locales mediante
BitmapFactory.decodeFile()y renderizado consetImageViewBitmap(). - Configuración XML de Proveedor: Metadatos en
res/xml/news_widget_info.xmldefiniendo tamaños mínimos (minWidth/minHeight), modos de redimensionamiento y periodicidad de actualización.
- Lenguaje & Framework: Swift, SwiftUI y WidgetKit.
- Arquitectura de Widgets:
NewsWidgets : WidgetyNewsWidgetsBundle : WidgetBundle.NewsWidgetsEntryView : View: Vista SwiftUI responsiva adaptada al tamaño del widget (displaySize).Provider : TimelineProvider: Generación de estados (TimelineEntry,NewsArticleEntry) y políticas de recarga (TimelineReloadPolicy.atEnd).
- Seguridad & Comunicación entre Procesos:
UserDefaults(suiteName: appGroupId)mediante App Groups, permitiendo a la extensión del widget (.appex) leer los datos guardados por la app principal. - Carga Dinámica de Tipografías (
CoreText): Acceso al bundle de assets compilados de Flutter (App.framework/flutter_assets) para registrar la tipografíaChewyen el proceso del widget medianteCTFontManagerRegisterFontsForURL.
homescreen_widgets/
├── android/
│ └── app/src/main/
│ ├── AndroidManifest.xml # Registro del receptor .NewsWidget
│ ├── java/.../NewsWidget.kt # Implementación Kotlin de AppWidgetProvider
│ └── res/
│ ├── layout/news_widget.xml # Layout nativo del widget Android
│ ├── xml/news_widget_info.xml # Metadatos de configuración del widget
│ └── values/ # Estilos, temas, dimensiones y strings
├── fonts/
│ └── Chewy-Regular.ttf # Fuente tipográfica Chewy
├── ios/
│ ├── NewsWidgets/
│ │ ├── NewsWidgets.swift # Extensión WidgetKit (Provider, Views, Entry)
│ │ └── NewsWidgetsBundle.swift # Punto de entrada de la extensión
│ └── Runner/ # Configuración y runner nativo de iOS
├── lib/
│ ├── main.dart # Punto de entrada de la app y configuración de tema
│ ├── news_data.dart # Modelo NewsArticle y repositorio de noticias simuladas
│ ├── home_screen.dart # Pantalla principal (lista y envío a widget)
│ └── article_screen.dart # Detalle de noticia y captura de LineChart a imagen
└── pubspec.yaml # Dependencias y registro de fuentes
Antes de arrancar la aplicación, asegúrate de tener instalado:
- Flutter SDK (versión 3.13 o superior):
flutter --version flutter doctor
- Entorno Android:
- Android Studio con Android SDK (API nivel 26 o superior).
- Emulador de Android configurado o dispositivo físico conectado por USB con depuración activada.
- Entorno iOS (opcional, requiere macOS):
- Xcode 14+ y CocoaPods.
- Simulador iOS configurado con iOS 14.0 o superior.
Para que el widget de iOS comparta información con la app Flutter:
- Abre
lib/home_screen.darty reemplaza el valor deappGroupId:const String appGroupId = 'group.com.mydomain.homescreenWidgets';
- Abre
ios/NewsWidgets/NewsWidgets.swifty coloca el mismo identificador:let userDefaults = UserDefaults(suiteName: "group.com.mydomain.homescreenWidgets")
- En Xcode, activa la capacidad App Groups tanto en el target
Runnercomo en el targetNewsWidgetsExtensionasignando dicho identificador.
Navega a la carpeta del proyecto y descarga los paquetes:
cd homescreen_widgets
flutter pub getComprueba qué emuladores o dispositivos físicos están detectados:
flutter devicesPara listar e iniciar un emulador de Android existente:
flutter emulators
flutter emulators --launch <ID_DEL_EMULADOR>Ejecuta el comando principal de Flutter. Esto iniciará el entorno de compilación, el servidor de depuración (Dart VM Service / Hot Reload Server) y lanzará la aplicación:
# Ejecutar en el dispositivo activo por defecto
flutter run
# O especificar explícitamente el dispositivo/plataforma
flutter run -d android
flutter run -d iosr: Hot Reload (recarga instantánea de cambios en la UI).R: Hot Restart (reinicio completo de la máquina virtual Dart).v: Abrir Flutter DevTools en el navegador para inspeccionar rendimiento, memoria y árbol de widgets.q: Detener la ejecución y cerrar la app.
Si deseas inspeccionar el estado de la app en un navegador web dedicado:
flutter run --observatory-port=8888Y en otra pestaña de la terminal:
dart devtools- Abre la aplicación en tu emulador o dispositivo y navega por las noticias.
- Presiona el botón flotante "Update Homescreen" en la pantalla de detalle de una noticia para renderizar el gráfico y guardar el titular actual.
- Minimiza la aplicación (botón Home).
- Mantén presionado un área vacía de la pantalla de inicio y selecciona Widgets.
- Busca homescreen_widgets o NewsWidget.
- Arrastra el widget a la pantalla de inicio: verás el título, la descripción y el gráfico
LineChartrenderizado.
- Compila y ejecuta la aplicación en el Simulador de iOS.
- Abre una noticia y pulsa "Update Homescreen".
- Ve a la pantalla de inicio del dispositivo, mantén presionado el fondo hasta que los iconos comiencen a temblar (Modo Jiggle).
- Toca el botón
+en la esquina superior izquierda. - Busca homescreen_widgets / NewsWidgets, elige el tamaño del widget y pulsa Add Widget.
- El widget se inicializará mostrando la tipografía
Chewyen el título y el gráfico de líneas correspondiente.
Para garantizar que no existan advertencias ni errores de análisis estático en el código Dart:
flutter analyze