app_store_metadata 2.1.0 copy "app_store_metadata: ^2.1.0" to clipboard
app_store_metadata: ^2.1.0 copied to clipboard

A comprehensive Dart SDK for fetching rich app metadata from Google Play Store and Apple App Store with complete iTunes API coverage

Changelog #

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.1.0 - 2025-01-28 #

Added #

  • Batch Processing API: New methods to efficiently fetch multiple apps at once
  • getMultipleGooglePlayAppInfo(): Fetch multiple Google Play Store apps concurrently
  • getMultipleAppleAppStoreInfo(): Fetch multiple Apple App Store apps using native iTunes batch API
  • Resilient Error Handling: Failed individual lookups don't affect successful ones in batch requests
  • Comprehensive Testing: Unit tests covering all batch processing scenarios

Enhanced #

  • Apple App Store Efficiency: Leverages iTunes API's native support for up to 200 apps per request
  • Google Play Store Performance: Concurrent HTTP requests for optimal throughput
  • Example Applications: Updated examples to demonstrate batch processing capabilities
  • API Documentation: Complete documentation for all new batch methods

Technical #

  • Return Type: Batch methods return Map<String, AppInfo> for easy ID-to-result mapping
  • Backward Compatibility: All existing APIs remain unchanged and fully supported
  • Error Resilience: Batch operations continue processing even if individual apps fail
  • Performance Optimized: Minimal overhead with efficient request batching strategies

2.0.0 - 2025-01-28 #

Added #

  • Enhanced AppInfo Model: Comprehensive expansion to support all iTunes/App Store fields
  • Multiple Screenshot Types: Separate fields for screenshots, ipadScreenshots, and appletvScreenshots
  • Multiple Artwork Sizes: Support for artworkUrl60, artworkUrl100, and artworkUrl512
  • Detailed Rating Information: Separate overall and current version ratings with counts
  • Rich Developer Information: Artist ID, view URL, seller name and URL
  • Comprehensive Technical Metadata: File size, minimum OS version, supported devices, languages
  • Gaming Features: Game Center support detection
  • Enterprise Features: VPP device-based licensing support
  • Enhanced Genre Support: Multiple genres and genre IDs
  • Content Advisory Information: Detailed content ratings and advisories
  • Release Date Tracking: Both original release date and current version release date
  • Factory Constructor: AppInfo.fromItunesJson() for direct iTunes API data parsing

Enhanced #

  • dart_mappable Integration: Full adoption of dart_mappable for efficient serialization/deserialization
  • Apple App Store Implementation: Complete rewrite to utilize all available iTunes fields
  • Google Play Store Compatibility: Updated to work seamlessly with expanded model
  • Backward Compatibility: All existing APIs continue to work, additionalInfo still populated
  • Screenshot Handling: Combined screenshots for backward compatibility while providing separate access

Technical #

  • Generated Code: Automatic code generation via dart_mappable for better performance
  • Type Safety: Enhanced type safety with proper null handling
  • Test Coverage: All tests updated and passing with expanded model
  • Real API Testing: Verified with live Apple App Store and Google Play Store APIs

Migration Guide #

  • Existing code continues to work without changes
  • New fields are available for enhanced metadata access
  • Use AppInfo.fromItunesJson() for direct iTunes API integration
  • Access specialized screenshot arrays via ipadScreenshots and appletvScreenshots
  • Rich artwork available through artworkUrl60, artworkUrl100, artworkUrl512

1.0.0 - 2025-06-12 #

Added #

  • Initial release of app_store_metadata package
  • Support for fetching app metadata from Google Play Store
  • Support for fetching app metadata from Apple App Store
  • Support for searching apps in Apple App Store
  • Comprehensive AppInfo model with all relevant app metadata
  • Custom exception classes for better error handling
  • Full test coverage with unit tests
  • Example usage in example/main.dart
  • Complete documentation and README

Features #

  • Unified API for both Google Play Store and Apple App Store
  • Country and language localization support
  • Rich metadata including ratings, screenshots, pricing
  • Type-safe Dart models
  • HTTP client abstraction for testing
  • Comprehensive error handling
2
likes
160
points
22
downloads

Publisher

verified publisherdanhtran.me

Weekly Downloads

A comprehensive Dart SDK for fetching rich app metadata from Google Play Store and Apple App Store with complete iTunes API coverage

Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

dart_mappable, equatable, html, http

More

Packages that depend on app_store_metadata