Skip to content

CHANGELOG.md

Latest commit

 

History

History
259 lines (190 loc) · 6.6 KB

CHANGELOG.md

File metadata and controls

259 lines (190 loc) · 6.6 KB

Changelog

All notable changes to this project will be documented in this file.

[4.0.4] - 2025-07-20

Added

  • Release version 4.0.4

Changed

  • Updated package version to 4.0.4

Fixed

  • Various bug fixes and improvements

[4.0.3] - 2025-07-20

Added

  • Release version 4.0.3

Changed

  • Updated package version to 4.0.3

Fixed

  • Various bug fixes and improvements

[4.0.2] - 2025-07-20

Added

  • Release version 4.0.2

Changed

  • Updated package version to 4.0.2

Fixed

  • Various bug fixes and improvements

[4.0.1] - 2025-07-20

Added

  • Release version 4.0.1

Changed

  • Updated package version to 4.0.1

Fixed

  • Various bug fixes and improvements

[4.0.0] - 2024-01-XX

🚀 Major Refactoring & New Features

Added

  • Cross-platform support: Full Android Google Wallet integration alongside existing iOS Apple Wallet support
  • Unified API: Single codebase for both iOS and Android platforms
  • New WalletCard model: Comprehensive data structure supporting both platforms
  • Platform factory pattern: Automatic platform detection and appropriate implementation selection
  • Enhanced file management: Improved file operations with better error handling
  • Card generators: Separate generators for Apple Wallet (.pkpass) and Google Wallet (.json) files
  • Comprehensive test coverage: 90%+ test coverage with unit and integration tests
  • Location-based relevance: Support for location-triggered wallet cards
  • Date-based relevance: Support for time-sensitive wallet cards
  • Multiple card types: Support for boarding passes, coupons, event tickets, store cards, and generic cards
  • Custom styling: Enhanced color and visual customization options
  • Network operations: Improved URL downloading with better error handling
  • JSON serialization: Automatic JSON serialization/deserialization for all models

Changed

  • BREAKING: Complete API redesign for better consistency and platform unification
  • BREAKING: New model structure with WalletCard, WalletCardMetadata, and WalletCardVisuals
  • BREAKING: Method names updated for clarity and consistency
  • Improved error handling: Custom WalletException with detailed error information
  • Better dependency management: Updated to latest versions of all dependencies
  • Enhanced documentation: Comprehensive README with examples and migration guide
  • Modernized codebase: Updated to latest Flutter and Dart standards

Fixed

  • OpenSSL compatibility: Fixed legacy cipher support for older certificate formats
  • Memory management: Improved file cleanup and memory usage
  • Platform detection: More reliable platform-specific feature detection
  • Error propagation: Better error handling and user feedback

Removed

  • BREAKING: Removed deprecated methods from v3.x
  • BREAKING: Removed platform-specific APIs in favor of unified interface
  • Dependency cleanup: Removed unused dependencies

🔧 Technical Improvements

Architecture

  • Implemented clean architecture with separation of concerns
  • Added abstract platform interfaces for better testability
  • Introduced factory pattern for platform-specific implementations
  • Enhanced error handling with custom exception types

Code Quality

  • Added comprehensive linting rules
  • Implemented automated code generation for JSON serialization
  • Added mock generation for testing
  • Improved code documentation and inline comments

Testing

  • Added unit tests for all core functionality
  • Added integration tests for platform-specific features
  • Added mock testing for network operations
  • Added test coverage reporting

📱 Platform-Specific Features

iOS (Apple Wallet)

  • Enhanced Passkit integration
  • Support for multiple card addition
  • Improved certificate handling
  • Better error messages for iOS-specific issues

Android (Google Wallet)

  • NEW: Full Google Wallet API integration
  • NEW: JWT-based pass saving
  • NEW: Pass link generation
  • NEW: Google Pay integration

🔄 Migration Guide

From v3.x to v4.0

Old API:

// iOS specific
await FlutterWalletCard.addPasskit(passData);

// Platform checking
if (Platform.isIOS) {
  // iOS code
}

New API:

// Unified API
final card = WalletCard(/* ... */);
await FlutterWalletCard.addToWallet(card);

// Automatic platform handling
bool available = await FlutterWalletCard.isWalletAvailable();

Key Changes

  1. Replace PasskitFile with WalletCard
  2. Use unified methods instead of platform-specific ones
  3. Update model structure to new format
  4. Handle new exception types

📦 Dependencies

Updated

  • archive: ^3.4.10 (was ^3.3.0)
  • dio: ^5.4.0 (was ^4.0.6)
  • path_provider: ^2.1.2 (was ^2.0.11)
  • uuid: ^4.3.3 (was ^3.0.6)

Added

  • json_annotation: ^4.9.0
  • build_runner: ^2.4.7
  • json_serializable: ^6.7.1
  • mockito: ^5.4.4

🐛 Bug Fixes

  • Fixed OpenSSL legacy cipher compatibility issues
  • Fixed memory leaks in file operations
  • Fixed platform detection edge cases
  • Fixed error handling in network operations
  • Fixed certificate parsing on newer OpenSSL versions

🔒 Security

  • Enhanced certificate validation
  • Improved error message sanitization
  • Better handling of sensitive data
  • Secure file operations

[3.1.0] - 2023-06-15

Added

  • Support for Flutter 3.0
  • Improved error handling
  • Better documentation

Fixed

  • iOS compatibility issues
  • Memory management improvements

[3.0.0] - 2023-03-20

Added

  • Null safety support
  • Flutter 2.0 compatibility
  • Enhanced Passkit generation

Changed

  • BREAKING: Migrated to null safety
  • Updated minimum Dart SDK to 2.12.0

Fixed

  • Various stability improvements

[2.1.0] - 2022-08-10

Added

  • Support for custom pass fields
  • Enhanced image handling
  • Better error messages

Fixed

  • iOS 15 compatibility
  • Certificate handling improvements

[2.0.0] - 2022-02-15

Added

  • Complete rewrite of the plugin
  • Support for all Passkit features
  • Enhanced documentation

Changed

  • BREAKING: New API structure
  • Improved performance

[1.0.0] - 2021-09-01

Added

  • Initial release
  • Basic Passkit support for iOS
  • File-based pass generation
  • URL-based pass downloading

Legend

  • 🚀 Major Features: Significant new functionality
  • 🔧 Technical: Internal improvements and refactoring
  • 📱 Platform: Platform-specific changes
  • 🔄 Migration: Breaking changes and migration information
  • 📦 Dependencies: Dependency updates
  • 🐛 Bug Fixes: Bug fixes and stability improvements
  • 🔒 Security: Security-related changes