file_saver_ffi 0.0.4

file_saver_ffi: ^0.0.4 copied to clipboard

Added #

• SaveLocation Feature: Explicit control over save locations with platform-specific enums
  • Android: pictures, movies, music, downloads (default), dcim
  • iOS: photos (Photos Library), documents (default, no permission)
  • Type-safe sealed class design with platform defaults

Changed #

• Added optional saveLocation parameter to saveBytes()
• Standardized parameter order: saveLocation now before subDir

Breaking Changes #

• Default locations changed for better UX:
  • Android: All files → Downloads (was type-based: Images→Pictures, Videos→Movies, etc.)
  • iOS: All files → Documents (was Images/Videos→Photos Library)
• Migration: Explicitly set saveLocation to maintain old behavior:

  saveLocation: Platform.isAndroid
    ? AndroidSaveLocation.pictures
    : [PlatformX]SaveLocation.photos
  

Added #

• OVERWRITE Functionality: Fully implemented overwrite conflict resolution
  • Android (Legacy): Delete existing file and save new one
  • Android 10+: Delete existing file via ContentResolver
  • iOS: Optimized with early return check
• Platform Behavior Documentation: Comprehensive guide for overwrite behavior
  • iOS Photos: Own files overwritten; other apps' files create duplicates
  • iOS Documents: Full overwrite capability (sandboxed per app)
  • Android 10+: Only detects/overwrites own files; other apps' files auto-renamed
  • Platform comparison table in README
• iOS 14+ Dialog Prevention: Added PHPhotoLibraryPreventAutomaticLimitedAccessAlert key
  • Prevents automatic "Select More Photos" prompt on iOS 14+
  • Provides better user experience with limited photos access
  • Documented in README with setup instructions

Refactored #

• iOS Code Quality: Extracted common logic from ImageSaver and VideoSaver
  • Moved findOrCreateAlbum() to BaseFileSaver extension
  • Moved handlePhotosConflictResolution() to BaseFileSaver extension
  • Removed 38 lines of duplicated code for better maintainability

• Refactor FileSaverIos to use NativeFinalizer + Arena for safer native resource management, more robust, and less prone to native memory leaks while maintaining performance.
• Make FileSaverPlatform.instance a true singleton
• Update document and README.md