terminate_restart

• Fix iOS crash (Issue #9): Remove crash-prone engine recreation with
  non-existent destroyContext(), simplify UI restart to use method channel
  communication, replace deprecated keyWindow/windows APIs with connectedScenes
• Add web platform support (PR #10 by @dario-valles): page reload with
  browser storage clearing (localStorage, sessionStorage, cookies, IndexedDB)
• Fix duplicate TerminateRestartOptions/TerminateRestart class definitions
  in terminate_restart_base.dart that caused compile conflicts
• Migrate restartApp to platform interface pattern instead of direct MethodChannel
• Fix podspec version mismatch (was 1.0.9, now synced to 1.1.0)
• Update iOS minimum deployment target from 10.0 to 12.0
• Add working unit tests (previously 100% commented out)
• Add gc method handler and kIsWeb guard in iOS/Dart plugins

Closes #9

New Features

• Web platform support: Full restart functionality for web browsers (PR #10 by @dario-valles)
  • Page reload for both terminate and UI-only restart modes
  • Browser storage clearing: localStorage, sessionStorage, cookies, IndexedDB, Cache API
  • Configurable data preservation matching native API
• wrapWithRestart widget: New TerminateRestart.wrapWithRestart() method that wraps your app to enable proper UI-only restart (terminate: false) with full widget tree rebuild

Bug Fixes

• Fixed iOS crash (Issue #9): Resolved crash on iOS when performing UI-only restart
  • Removed crash-prone new engine creation approach (destroyContext() did not exist on FlutterEngine)
  • UI-only restart now recreates FlutterViewController with the same engine (safe, no crash)
  • Sends resetToRoot to Dart side to trigger full widget tree rebuild via wrapWithRestart
  • Replaced deprecated keyWindow/windows APIs with connectedScenes for iOS 13+
  • Fixed keychain clearing query that prevented proper deletion
  • Added specific error codes and messages for better debugging
• Fixed web double-tap issue: location.replace(sameUrl) doesn't trigger a reload in most browsers — now uses location.reload() for both modes with scheduleMicrotask for immediate response
• Fixed duplicate class definitions: Removed conflicting TerminateRestartOptions, RestartMode, and TerminateRestart class definitions from terminate_restart_base.dart
• Fixed podspec version mismatch: Synced podspec version with pubspec
• Fixed Android dead code: Removed unreachable engine recreation code that ran on a finishing Activity

Improvements

• Migrated restartApp to use platform interface pattern instead of direct MethodChannel
• Updated iOS minimum deployment target from 10.0 to 12.0
• Added 7 working unit tests (previously 100% commented out)
• Added gc method handler in iOS plugin
• Added kIsWeb guard for internal method channel setup
• Cleaned up unused Android imports (AlarmManager, PendingIntent, Process, exitProcess)
• Updated example app to use wrapWithRestart and upgraded google_fonts to 6.3.3 for Flutter 3.38+ web compatibility

• Fixed Swift compiler error in Xcode 16.2 with Flutter 3.29.0:
  • Modified engine property access to handle non-optional FlutterEngine type
• Added documentation for required iOS configuration:
  • Detailed URL scheme configuration in Info.plist for iOS restart functionality
• Improved compatibility with latest Flutter versions

• Documentation improvements:
  • Improved README.md formatting and organization
  • Removed emoji icons for better readability
  • Made code examples more concise
  • Fixed markdown formatting issues

• Documentation improvements:
  • Streamlined Getting Started section
  • Removed redundant sections
  • Made code examples more concise
  • Added feature comparison table
  • Improved overall readability

• Updated deprecated platform message handling to use channelBuffers.push
• Enhanced documentation:
  • Added Quick Start guide for faster onboarding
  • Added iOS App Store compliance section
  • Added comprehensive usage table with examples
  • Added confirmation dialog examples
  • Improved code formatting and organization
• Updated README with clearer installation and usage instructions
• Fixed code examples and method signatures

• Code maintenance and improvements
• Updated dependencies to latest compatible versions
• Enhanced code documentation
• Minor bug fixes and performance improvements

• Improved code formatting and organization
• Enhanced error handling with specific PlatformException handling
• Updated method channel naming for better consistency
• Added comprehensive API documentation
• Fixed UI restart functionality
• Added back navigation handling for Android
• Improved static analysis compliance

• Added TerminateRestart.instance singleton pattern for better state management

• Enhanced initialization with comprehensive state reset examples

• Added support for different state management solutions (GetX, Provider, Bloc)

• Improved documentation with real-world examples

• Updated all code examples to use the new instance pattern

• Fixed UI-only restart implementation

• Added proper error handling for timeouts and platform-specific errors

• Enhanced Android restart functionality:

  • Using makeRestartActivityTask for more reliable app restart
  • Improved activity recreation and state management
  • Better handling of process termination

• Improved iOS implementation:

  • Better URL scheme handling for app restart
  • Enhanced view controller management
  • Proper state preservation during restarts

• General improvements:

  • More reliable UI-only restart on both platforms
  • Better error handling and logging
  • Code cleanup and documentation updates

🚀 New Features

• Improved UI-only restart functionality:
  • Maintains WebSocket and HTTP connections
  • Properly resets to root state
  • Smooth transition animations
  • Added initialize method with onRootReset callback
• Better platform-specific implementations:
  • iOS: Uses proper view controller transitions
  • Android: Maintains Flutter engine while resetting activity

🛠️ Improvements

• Added comprehensive documentation
• Added comparison of restart modes
• Added best practices guide
• Improved error handling
• Added example code for common use cases

🐛 Bug Fixes

• Fixed UI-only restart not properly resetting to root
• Fixed Android activity recreation issues
• Fixed iOS view controller transition glitches

• Initial release with the following features:
  • Support for both Android and iOS platforms
  • Two restart modes: UI-only and full process termination
  • Optional data clearing during restart
  • Configurable data preservation options (keychain, user defaults)
  • Confirmation dialog support with customizable messages
  • Comprehensive example app demonstrating all features
  • Fixed data clearing functionality in both UI and terminate modes
  • Added extensive error handling and logging
  • Added type-safe API with null safety support

Features

• Full app restart functionality
• UI-only refresh option
• Data clearing with selective preservation
• Extensive customization options
• Cross-platform support (Android & iOS)
• Comprehensive logging
• Type-safe implementation

Android Implementation

• Proper process termination
• Activity/task management
• Intent flag handling
• State preservation options

iOS Implementation

• Clean process termination
• State restoration
• Data management
• Background task handling

Documentation

• Comprehensive README
• API documentation
• Usage examples
• Common issues & solutions