widget_hydrator 2.0.0

A powerful Flutter mixin for effortless StatefulWidget state persistence and hydration. Provides automatic saving and restoring of widget state across app restarts, with support for encryption, compre [...]

0.0.1

Changelog

[2.0.0] - 2025-01-06

Breaking Changes

• Refactored service initialization pattern to fix late initialization errors
• Changed direct service instantiation to lazy getters

Added

• Initialization guard system using static tracking map
• Proper cleanup in dispose method
• Additional error handling and logging for initialization failures

Fixed

• Platform-specific service multiple initialization issue
• Late initialization conflicts with singleton patterns
• Missing initialization guards in StorageService
• Box initialization redundancy
• State persistence reliability issues

Changed

• StorageService initialization logic to prevent duplicate initialization
• Error handling approach in initializeHydration method
• Service instantiation pattern to lazy loading
• Initialization state tracking mechanism

Development

• Added more comprehensive debug logging
• Improved error messages for initialization failures

Migration Guide

From 1.x to 2.0.0

1. Update initialization in StatefulWidget:

@override
void initState() {
  super.initState();
  initializeHydration(HydrationConfig(
    useCompression: true,
    enableEncryption: false,
  )).catchError((error) {
    print('Hydration initialization failed: $error');
  });
}

copied to clipboard

2. If manually accessing services, update to use getters:

// Old
final storage = StorageService();

// New
StorageService get storage => StorageService();

copied to clipboard

3. Add error handling for initialization: