open_mail

Added

• Comprehensive migration documentation for v1.2.0 API changes
• Complete usage examples for custom mail app picker implementation
• Detailed explanation of MailAppPickerDialog replacement patterns
• Professional response to semantic versioning concerns raised by users
• Step-by-step migration guide from v1.1.0 to v1.2.0 with working code examples

Improved

• README documentation with better structure and clearer examples
• Added complete before/after code comparisons for migration
• Enhanced API documentation with new usage patterns

Documentation

• Updated README with Basic Usage and Advanced Usage sections
• Added migration benefits and rationale for API changes
• Provided professional explanation of versioning decisions

What's Changed

• chore: set minSdkVersion & compileSdkVersion to follow Flutter by @AkhmadRamadani in #12

New Contributors

• @AkhmadRamadani made their first contribution in #12

Full Changelog: v1.0.0...v1.2.0

Breaking Changes

• OpenMail.openMailApp: removed the nativePickerTitle parameter. Android now uses the system default chooser title.
• OpenMail.openSpecificMailApp: signature changed to openSpecificMailApp(String name). It now opens the target app’s inbox only and returns OpenMailAppResult, similar to openMailApp.

Changed

• iOS: Apple Mail inbox scheme switched from mailto:// to message:// for opening the inbox reliably.
• Android: native implementation for openMailApp ignores custom titles and uses Intent chooser with default title.
• Example and tests updated to match new APIs.

Fixed

• iOS detection of Gmail and other apps: clarified and enforced LSApplicationQueriesSchemes requirements so canOpenURL works and Gmail appears in the list when installed.

iOS Setup Notes

• Ensure these URL schemes are added to your app’s Info.plist under LSApplicationQueriesSchemes for detection:
  • googlegmail, x-dispatch, readdle-spark, airmail, ms-outlook, ymail, fastmail, superhuman, protonmail, message

Migration

• Replace OpenMail.openMailApp(nativePickerTitle: '...') with OpenMail.openMailApp().
• Replace OpenMail.openSpecificMailApp(name, emailContent) with OpenMail.openSpecificMailApp(name).

Added

• Robust fallback logic for Apple Mail on iOS: always uses mailto: for compose, ensuring pre-filled fields work reliably.
• Improved compose URL generation for Gmail and other supported apps.
• Comprehensive error handling and fallback to mailto: for all mail apps if custom scheme fails.

Changed

• Cleaned up and productionized code: removed all debug/print statements and development-only code.
• Ready for production release.

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

Bug Fixes

• Fixed mail app detection in Android release builds.
• Resolved "Abstract classes can't be instantiated!" error caused by GSON serialization issues in release mode.
• Updated the JSON serialization for app data to use JSONObject directly instead of GSON to prevent ProGuard/R8 obfuscation problems.
• Added proper null safety handling in native code for email content fields.
• Updated ProGuard rules to correctly keep necessary classes and their members.
• Ensured consistent creation of App objects in Kotlin code.

Major Upgrade

• Migrated Android plugin to v2 embedding and modern APIs.
• Updated Android build to use AGP 8.2.2, Kotlin 1.8.22, compileSdk 35, and minSdk 26.
• Improved compatibility with latest Flutter and Android versions.
• Fixed platform channel and plugin registration issues.

Fix and Improve Documentation

• Fix some deprecated dependency and update documentaiton.

Improvement

• Downgrade platform version from 3.1.6 to 3.1.0 to remove conflict dependecies.

Added
Improved documentation for better clarity on package usage.
Fixed
Minor typos and formatting issues in the README file.

Added

• Improved documentation for better clarity on package usage.

Fixed

• Minor typos and formatting issues in the README file.

Updated

• Enhanced documentation with additional examples.

Changed

• Updated README with clearer instructions and added Key Features section.

Fixed

• Resolved minor inconsistencies in the example code.

Updated

• Improved documentation with better usage guidelines.

Initial Release

• First release of open_mail, providing basic functionality to open mail applications on supported platforms.