widgets_kit 0.1.1

Send data from Flutter to native home screen widgets on Android, iOS and macOS, update them, and handle taps with Dart code.

0.1.1

• Added macOS support through WidgetKit: saving and reading data in an app group, reloading widgets, listing installed widgets, and widget taps through widgetClicked.
• Added Windows and Linux support for data: saveWidgetData, getWidgetData, saveFile, saveImage and renderFlutterWidget keep their data in widget_data.json in the app support directory. Widget refresh is not available there.
• Added the web as a safe no-op. Calls return a default (false, null, or an empty list) and nothing reaches a platform channel.
• Added WidgetsKit.isSupported, which is true on Android, iOS and macOS.
• saveFile, saveImage and renderFlutterWidget throw an UnsupportedError where there is no widget system and no storage, which is the web.
• Replaced dart:io Platform use in the plugin with defaultTargetPlatform so it is web-safe.
• Added an Android home screen screenshot.
• The example app now builds for macOS and the web, and has a macOS integration test.

0.1.0

• Initial release of widgets_kit, a fork of home_widget 0.10.0 by Anton Borries (BSD-3-Clause).
• Renamed the package, the Dart API (HomeWidget is now WidgetsKit), the Android package (com.widgetskit.widgets_kit), the iOS plugin and the method channels, so it can be installed beside home_widget.
• Removed the CLI and generator packages. Only the core plugin is included.
• Fixed saveWidgetData on Android: the disk write no longer runs on the platform main thread, which could cause ANRs, and an unsupported value type no longer replies twice.
• Fixed Android background callbacks not starting when the work resumes in a process where the Flutter loader was never initialised.
• Fixed registerInteractivityCallback crashing the app on Android and iOS when given a closure or instance method. Dart now throws an ArgumentError, and both native sides return an error instead of force-casting a null handle.
• The background dispatcher no longer throws when a stored callback handle can no longer be resolved.

---

Upstream history (home_widget)

The entries below are home_widget's own changelog up to the fork point. Names in them refer to the original package.

0.10.0

Note: This release has breaking changes.

• FIX: Handle Dart null values in method-channel arguments (iOS) (#450). (31c93d62)
• FEAT: Support Baseline Alignment in Rows and handle Custom Font Alignment (#456). (4a5c696d)
• BREAKING FEAT: Support Custom Fonts and Icons (#452). (ebc5ce0a)
• BREAKING FEAT: Support Widget Previews (#448). (a7fe969e)

0.9.4

• FEAT: Add support for opening Widgets on Click from Generated Widgets (#442). (7e9e2102)
• FEAT: Add Time-Based Widget Content (#440). (70b27061)
• FEAT: Add support for Localized Text (#439). (a121e474)
• FEAT: Add Packages for home_widget_cli and home_widget_generator (#428). (05569013)

0.9.3

• FEAT: Support UIScene Lifecycle (#423). (bd899596)

0.9.2+1

• FIX: Apply kotlin plugin when not built in (#425). (fc7e800c)

0.9.2

• FIX: Add FlutterFramework to iOS SPM package (#419). (85aa4bf2)
• FIX: Support Android Gradle Plugin 9.x (#420). (cb2b4ad5)
• FIX: Pin android dependency versions to prevent pre-release pickup (#418). (e42f1f7c)
• FEAT: Support passing appGroupId directly with functions (#416). (55e6f435)

0.9.1

• FEAT: Configurable widgets for Android (#396). (faf16897)
• FEAT: Add support for HomeWidget.saveFile and HomeWidget.saveImage (#409). (bf965fbf)

0.9.0

Note: This release has breaking changes. See the migration guide for details on how to migrate.

• FIX: Fix Xcode 26 support for interactive Widgets (#391). (35047c6a)
• FIX: Fix iOS Widget Updating using only name parameter (#381). (77919dbb)
• BREAKING FIX: Add missing package name to HomeWidget Glance files (#365). (caf6a1fe)
• BREAKING FEAT: Add support for Swift Package Manager (#393). (8d3c1ddf)
• BREAKING CHORE: Upgrade to melos 7.0.0 (#382). (66bffb17)

0.8.1

• FIX: Use WorkManager for Interactivity on Android. Improves reliability of clicks (#361). (b25f8733)

0.8.0

Note: This release has breaking changes.

• FEAT: Configurable WIdgets support for iOS (#348). (e8809d89)
• FEAT: Add triggeredFromHomeWidget flag to updateWidget on Android (#315). (dc2b9302)
• BREAKING FEAT: Default to the device pixel ratio (#304). (90522de3)
• BREAKING CHORE: Enable strong language analyzer (#305). (1b5df0b3)

0.7.0+1

• FIX: Runtime error when starting App from Widget on Android 15 (#330). (64a38eb3)
• DOCS: Move Documentation to docs.page (#287). (52ee746a)
• DOCS: Improve pubspec metadata (#283). (f23c63e8)

0.7.0

• DOCS: Move Documentation to docs.page (#287). (52ee746a)
• DOCS: Improve pubspec metadata (#283). (f23c63e8)
• FIX: Fix iOS Background Worker (#244). (bb4895c)
• FIX: Fix storing Long on Android (#280). (284cd51)

0.6.0

• Require Flutter 3.20+ due to changes in ViewConfiguration

0.5.0

Breaking Changes

• The package now uses a library pattern so you should only import 'package:home_widget/home_widget.dart'

New Features

• Jetpack Glance Support
• Support requestPinWidget on Android
• Support getting Information about Widgets Users have currently added to their Home and Lock Screens
• Support saving Uint8List on iOS

Fixes

• iOS Background Work not working when App was fully closed
• Launching the App on Android 14+
• iOS not compiling when using interactive Widgets with Flutter 3.19+

0.4.1

• Fix First Background on iOS being ignored by mchudy in #188

0.4.0

• Add support for Interactive Widgets on iOS
• Rename registerBackgroundCallback to registerInteractivityCallback
• Restructure README

0.3.1

• fix: Fix Null Pointer when Saving renderFlutterWidget by milindgoel15 in #182
• fix: Update Gradle to 8 by milindgoel15 in #155
• docs: Fix syntax error in readme code example by mattrltrent in #154
• fix: Handle null check on Android when checking CallbackInformation by eliasto in #172

0.3.0

• Add renderFlutterWidget method to save a Flutter Widget as an Image #126 by leighajarett

0.2.1

• Update Gradle and Kotlin Versions
• Update to support Flutter 3.10

0.2.0+1

• Fix example annotation #115 by ColinSchmale

0.2.0

• Fix missing @pragma("vm:entry-point") for Background Callbacks #99 by linziyou0601
• Update HomeWidgetBackgroundService.kt #98 by roly151
• README Improvements by aaronkelton and hadysata

0.1.6

• Allow the specification of fully qualified android name #62 by NicolaVerbeeck

Fixes

• Fix paths in README #73 by AndyRusso
• Migrate example to Android embedding v2 #80 by ronnieeeeee
• Fix onNewIntent in Flutter 3 #84 by josepedromonteiro and stepushchik-denis-gismart

0.1.5

• Fix MissingPluginException for registerBackgroundCallback on iOS #39

0.1.4

• Fix HomeWidget.updateWidget not completing on iOS #26
• Fix casting Error on Registering Background Callback #31 by aljkor
• Fix collision for Deeplinks #42 by mgonzalezc
• Make Android PendingIntents immutable for Android 12 #49 by mgonzalezc
• Update Gradle Versions and target Android SDK 31
• Fix Issues relating to initiallyLaunchedFromHomeWidget
  • #48 Call not completing on iOS
  • #40 Cast exception on Android for cases launched from Widget but without data Uri

0.1.3

• Add GitHub Actions, Tests and Integration Tests to ensure further quality
• Fix double and null handling on Android
• Fix HomeWidget.updateWidget not completing on Android #26

0.1.2+1

• Fix #19 Receiver not registered bug

0.1.2

• Add Click Listeners
  • Detect if App has been launched via a view from the HomeScreen Widget
  • Execute Background Dart Code when clicking on a view in HomeScreen Widget [Android only]

0.1.1+2

• Set sdk bound correctly
• Workaround for analysis_options import error
• Cleanup Example

0.1.1+1

• Also allow older Flutter Versions

0.1.1

• Flutter 2

0.1.0+1

• More general Dart SDK Fixes Pub Score
• Add Pub Score and Like Badges

0.1.0

• Migrate HomeWidget to nullsafety.

0.0.2

• Background Updates
  • Add Paragraph on explaining background updates
  • Extend example to include background updates using flutter_workmanager

0.0.1+4

• Use absolute Image path to show images on pub.dev

0.0.1+3

• Compressed iOS and Android demo images in Readme (#16)
• Add README Entry to sync CFBundleVersion (#13)
• Format Examples into table (#10)
• Fix Build Error (#12)

0.0.1+2

• Add more documentation to README

0.0.1+1

• Add Images to README

0.0.1

• Initial Release of HomeWidget