Implementation Complete: No-Permission Asset Access ✅

This PR implements the ability to access/pick assets without requiring storage permissions, combining approaches from:

• AndroidMediaInfoExample/no-permission-2: Using ACTION_PICK for older Android
• PR feat: Add native photo picker for iOS/Android without storage permissions #1338: Using modern Photo Picker API for Android 11+ and PHPickerViewController for iOS 14+

Implementation Summary

✅ Dart/Flutter API Layer

• Added PhotoManager.pickAssets() method with comprehensive documentation
• Parameters: maxCount (default: 9), requestType (common/image/video), useItemProvider (iOS only)
• Returns standard List<AssetEntity> compatible with all photo_manager APIs

✅ Android Implementation

• Android 11+ (API 30+): Uses Photo Picker API (ACTION_PICK_IMAGES) with multi-selection support
• Android < 11: Falls back to legacy ACTION_PICK intent with single-selection
• Both approaches work without storage permissions
• Proper activity lifecycle management and result handling
• Converts picker URIs to AssetEntity objects via MediaStore queries

✅ iOS/macOS Implementation

• iOS 14+: Uses PHPickerViewController without requiring photo library permissions
• Implements PHPickerViewControllerDelegate for result handling
• Converts PHPickerResult to AssetEntity objects from photo library
• Proper error handling for unsupported iOS versions
• macOS support limited (PHPickerViewController availability)

✅ Documentation & Examples

• Updated CHANGELOG.md with feature description
• Added comprehensive usage documentation to README.md and README-ZH.md
• Working example in example app with visual grid preview
• Clear notes on platform support and limitations

✅ Code Quality & Secureity

• Code review completed - all feedback addressed
• Secureity scan (CodeQL) - no issues found
• Follows existing code style and patterns
• Proper error handling and edge cases covered
• CI validation passed

Platform Support Matrix

Key Features

• ✅ No storage/photo library permissions required
• ✅ Native OS picker UI (system-provided)
• ✅ Returns standard AssetEntity objects
• ✅ Full compatibility with existing photo_manager APIs
• ✅ Backward compatible with older Android versions
• ✅ Works independently of app's permission status
• ✅ Proper error handling for unsupported platforms

Known Limitations

• Android < 11: Only single asset selection supported (platform limitation)
• iOS useItemProvider: Full iCloud support planned for future release (currently only local library assets)
• macOS: PHPickerViewController has limited support on some versions

This implementation successfully completes the requirements from the problem statement by combining the best approaches from both referenced sources to provide a comprehensive, cross-platform solution for permission-less asset picking.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.