Added #

• Complete Property Discovery System
  • Flat properties fully supported (v1.0.7)
  • Nested ViewModels now fully supported (v1.0.8) ⚡
  • Together = complete Rive ViewModel coverage
  • Handles all property types at all nesting levels

Added #

• onDataBindingChange Callback Implementation: Previously defined but unused callback now fully functional

  • Added property listeners in _processViewModelInstance() for real-time property value updates
  • Supports String, Number, Boolean, Color, and Enum property types
  • Fires immediately when property values change in the animation
  • Enables reactive UI updates based on animation state changes

• Property Listener System: Automatic property change detection

  • Type-safe listener signatures for each property type
  • String properties: stringProp?.addListener((value) { ... })
  • Number properties: numberProp?.addListener((value) { ... })
  • Boolean properties: boolProp?.addListener((value) { ... })
  • Color properties: colorProp?.addListener((value) { ... })
  • Enum properties: enumProp?.addListener((value) { ... })

Fixed #

• Listener Type Signatures: Fixed callback parameter type mismatches

  • Corrected signature from void Function() to void Function(T value)
  • Proper handling of typed listener parameters for each property type
  • Eliminated "argument type can't be assigned" compilation errors

• Property Change Tracking: Fixed issue where property changes weren't being reported

  • onDataBindingChange callback now invokes correctly when properties update
  • Value parameter properly passed to callback function
  • Multiple property types handled with correct type safety

Improved #

• Complete Callback System: All 8 callbacks now fully functional

  • onInit - Animation initialization
  • onInputChange - State machine input changes
  • onHoverAction - Hover/boolean action handling
  • onTriggerAction - Trigger event firing
  • onViewModelPropertiesDiscovered - Property discovery
  • onDataBindingChange - Real-time property value updates ⚡ (NEW)
  • onEventChange - Rive event handling
  • onAnimationComplete - Animation completion

• Real-Time Data Binding: Complete reactive data binding pipeline

  • Properties update instantly as animation state changes
  • User interactions trigger immediate property callbacks
  • UI can react to property changes in real-time
  • Full support for Rive's data binding system

• Code Organization: Enhanced property management

  • Clear separation of property initialization and listener setup
  • Type-safe listener implementations
  • Improved property disposal with proper listener cleanup

Fixed #

• Missing type annotation in _paintShared callback: Added explicit Duration type to _paintShared parameter to resolve Dart linter warning and maintain strict type safety

Fixed #

• setState() During Build Phase: Fixed critical Flutter error by wrapping all async/post-initialization setState() calls with WidgetsBinding.instance.addPostFrameCallback()

  • Fixed _initRive() setState calls during initialization
  • Fixed _loadRiveFileStandard() setState after file loading
  • Fixed _loadRiveFileWithImageReplacement() setState after async operations
  • Fixed loadExternalFile() setState in Future.then() callback
  • Prevents "setState() called during build" runtime errors

• Trigger Property Discovery: Added missing trigger property discovery in data binding

  • Trigger properties are now properly discovered and stored in the properties list
  • Added trigger support in _processViewModelInstance method
  • Trigger properties can now be accessed via updateDataBindingProperty with type 'trigger'

Improved #

• Widget Lifecycle Safety: All state updates now respect Flutter's widget lifecycle

  • Uses proper post-frame callbacks for safe UI updates
  • Maintains mounted state checks before setState calls
  • Prevents memory leaks and runtime errors

• Property Disposal: Enhanced cleanup to properly dispose trigger properties

  • Added ViewModelInstanceTrigger to the disposal logic
  • Prevents memory leaks when triggers are used in animations

• Code Stability: Overall stability improvements through proper async handling

Fixed #

• Trigger Property Discovery: Fixed missing trigger property discovery in data binding
  • Trigger properties are now properly discovered and stored in the properties list
  • Added trigger support in _processViewModelInstance method
  • Trigger properties can now be accessed via updateDataBindingProperty with type 'trigger'

Improved #

• Property Disposal: Enhanced cleanup to properly dispose trigger properties
  • Added ViewModelInstanceTrigger to the disposal logic
  • Prevents memory leaks when triggers are used in animations

Fixed #

• Code formatting compliance with Dart formatter (dart format .)
• Fixed pubspec.yaml URL format (removed markdown link syntax)
• Fixed empty flutter: section in pubspec.yaml (added empty object)
• Updated CHANGELOG.md formatting for pub.flutter-io.cn compliance
• Fixed issue_tracker URL to properly point to GitHub issues

Improved #

• Better pub.flutter-io.cn score and validation
• Improved documentation clarity
• Enhanced code style consistency

Fixed #

• Code formatting compliance with Dart formatter (dart format .)
• Fixed pubspec.yaml URL format (removed markdown link syntax)
• Fixed empty flutter: section in pubspec.yaml (added empty object)
• Updated CHANGELOG.md formatting for pub.flutter-io.cn compliance
• Fixed issue_tracker URL to properly point to GitHub issues

Improved #

• Better pub.flutter-io.cn score and validation
• Improved documentation clarity
• Enhanced code style consistency

Added #

• Enhanced LogManager with reactive UI support

  • ValueNotifier<List<Map<String, dynamic>>> logMessages for real-time log streaming
  • Detailed log entries with timestamps and event types
  • Log filtering capabilities (info vs warning/error)
  • Log search functionality
  • Export logs as string or JSON format
  • Log count statistics (total, info, error)
  • Multiple logs batch addition

• New LogManager Methods

  • getLogsByType(bool isExpected) - Filter logs by type
  • searchLogs(String query) - Search logs by text
  • exportAsString() - Export all logs as formatted string
  • exportAsJSON() - Export logs in JSON format
  • getLastLogsAsStrings(int count) - Get last N logs as strings (backward compatible)
  • addMultipleLogs(List<String> messages) - Add multiple logs at once
  • logCount, errorCount, infoCount - Get log statistics

Changed #

• LogManager now stores detailed log information
  • Each log entry contains: message, text, timestamp, type, isExpected
  • Improved timestamp formatting (HH:MM:SS)
  • Better structured logging data

Fixed #

• LogManager listeners now properly update UI
• Resolved issue where LogManager.logs.addListener() wasn't working (was List<String>, now supports ValueNotifier)

Improved #

• LogManager documentation with complete usage examples
• Better code organization in LogManager
• Enhanced error tracking and logging capabilities

Added #

• Initial release of Rive Animation Manager

• Global Animation Management

  • Global singleton RiveAnimationController for centralized animation management
  • Per-animation state tracking and lifecycle management
  • Automatic resource cleanup and disposal

• Core Widget

  • RiveManager widget for displaying Rive animations with full input support
  • Support for both oneShot and stateMachine animation types
  • Multiple file loading options (asset, external, custom)
  • Responsive display with customizable fit and alignment

• Input Handling

  • State machine input handling (triggers, booleans, numbers)
  • Real-time input change callbacks
  • Input type detection and validation
  • Artboard selection by name

• Data Binding & Properties

  • Automatic property discovery from ViewModel instances
  • Data binding property management (number, boolean, string, color, enum, image, trigger)
  • Support for all Rive data types
  • Nested property updates with path caching for performance
  • Property value retrieval and bulk operations

• Image Management

  • Dynamic image replacement at runtime
  • Multiple image source support (asset, URL, bytes, RenderImage)
  • Image preloading and caching for instant swapping
  • Cache statistics and management

• Text Management

  • Text run value getting and setting
  • Path-based text targeting

• Event Handling

  • Rive event listening and callback handling
  • Event context with current state information
  • Animation completion callbacks

• Logging & Debugging

  • Comprehensive LogManager for debug logging
  • Cache statistics and performance monitoring
  • Detailed logging of animation lifecycle events

• File Support

  • Asset file loading via Flutter's asset system
  • External file support with File objects
  • Custom file loader interface for advanced use cases

Features #

• ✅ Global animation state management
• ✅ Real-time input callbacks
• ✅ Automatic property discovery
• ✅ Dynamic image updates from multiple sources
• ✅ Performance-optimized caching
• ✅ Debug logging with real-time monitoring
• ✅ Complete resource cleanup
• ✅ Nested property path support
• ✅ Event listener management
• ✅ Artboard selection

Supported Versions #

• Rive: ^0.0.16
• Flutter: >=3.13.0
• Dart: >=3.0.0

Version Compatibility #

Version	Release Date	Status	Highlights
1.0.8	2025-11-04	Latest	Nested properties + lint-free code ✅
1.0.7	2025-11-04	Stable	onDataBindingChange fully implemented ⚡
1.0.6	2025-11-01	Stable	Type annotation fixes
1.0.5	2025-11-01	Stable	setState() lifecycle fixes + trigger support
1.0.4	2025-10-31	Stable	Trigger property discovery
1.0.3	2025-10-31	Stable	Formatting and pub.flutter-io.cn compliance
1.0.2	2025-10-31	Stable	Formatting and pub.flutter-io.cn compliance
1.0.1	2025-11-01	Stable	Enhanced LogManager with ValueNotifier
1.0.0	2025-11-01	Archived	Initial production release

Migration Guide #

From 1.0.6 to 1.0.7 #

No breaking changes. To use the new onDataBindingChange callback:

RiveManager(
  animationId: 'myAnimation',
  riveFilePath: 'assets/animations/my.riv',
  // ✅ NEW: Callback now fires when properties change
  onDataBindingChange: (propertyName, propertyType, value) {
    print('Property $propertyName changed to $value');
    
    // Update your UI in real-time
    setState(() {
      _propertyValues[propertyName] = value;
    });
  },
)

From 1.0.0 to 1.0.1 #

No breaking changes. To use new LogManager features:

// Old code still works
LogManager.addLog('Message', isExpected: true);

// New: Listen to log updates
LogManager.logMessages.addListener(() {
  print('Logs updated');
});

// New: Use ValueNotifier in UI
ValueListenableBuilder<List<Map<String, dynamic>>>(
  valueListenable: LogManager.logMessages,
  builder: (context, logs, _) {
    // Build UI with logs
  },
);

Support #

For issues, feature requests, or contributions:

• GitHub Issues: rive_animation_manager/issues
• GitHub Discussions: rive_animation_manager/discussions

Contributors #

• Initial development and maintenance by the Flutter community

License #

MIT License - See LICENSE file for details