Cross-Platform Support for Saving Images in JPG Format in .NET MAUI

[VishalOmprasad]

I am developing an image-saving feature in a .NET MAUI application and am seeking guidance on ensuring consistent, cross-platform behavior.
The goal is to allow users to save images in the following formats:

• PNG (.png)
• JPEG (.jpeg)
• BMP (.bmp)
• JPG (as an alternative to .jpeg for JPEG-encoded images)

While PNG, JPEG, and BMP are mostly supported across platforms, adding support for .jpg extension has revealed inconsistent behavior across platforms.

Current Implementation Status:

Windows:

• Saving works as expected for .png, .jpeg, .bmp, and .jpg by providing the format as a string.
• When saving JPEG-encoded data, the resulting .jpg and .jpeg files have identical sizes (e.g., both 300 KB). However, unclear whether this behavior is correct.

Android:

• PNG and BMP formats work correctly.
• When saving a JPEG image using Bitmap.CompressFormat.JPEG, Android's MediaStore automatically assigns a .jpg extension based on the image/jpeg MIME type, regardless of whether .jpeg was specified in the filename..
• Reference:
  • Issue in MediaStore - https://codingtechroom.com/question/https-www-yourwebsite-com-fix-android-mediastore-wrong-file-extension.
  • Bitmap.CompressFormat - https://developer.android.com/reference/android/graphics/Bitmap.CompressFormat.
  • Supported image formats - https://developer.android.com/media/platform/supported-formats#image-formats.
  • StackOverflow - https://stackoverflow.com/questions/59182066/wrong-file-extension-and-file-name-after-creating-image-file-with-androids-medi.

iOS/MacCatalyst:

• UIImage.AsJPEG() and UIImage.AsPNG() work reliably for saving files with .jpeg and .png extensions.
• However, saving a JPEG-encoded image with a .jpg extension results in:
  • Unexpected behavior (e.g., file saved with .png extension or not recognized).
  • Only .jpeg and .png extensions seem to work reliably.
• BMP is not supported natively for encoding, so fallback to PNG occurs.

Questions:

1. What is the recommended approach in .NET MAUI to reliably save a JPEG-encoded image with a .jpg extension on all platforms, especially iOS?
2. Is the behavior on iOS a known limitation of UIImage or the underlying OS, where it strictly prefers the .jpeg extension?
3. On Android, is there any way to override MediaStore's default behavior to enforce a user-specified extension, or should we align with the platform's convention and always use .jpg?
4. Should .jpg be treated as an alias for .jpeg within the application's logic, with platform-specific code to handle the final file extension, or is there a more unified approach?
5. Are there any plans in the .NET MAUI roadmap to abstract this file format and extension handling to ensure more consistent cross-platform behavior?

Any insights, workarounds, or roadmap updates would be greatly appreciated. Thanks in advance!