flutter_image_compress

2.5.1

• FIX(Android): handle Gradle 9 Kotlin modes safely (#401). (e4bbccae)

• FIX(Android): handle Gradle 9 Kotlin modes safely (#401). (e4bbccae)

• REFACTOR(common): drop go-flutter plugin, rebuild example native shell (#368). (6d3898b0)
• FIX(Android): preserve source EXIF on PNG and WebP output (refs #130) (#395). (4ddf1390)
• FIX(iOS): preserve full source metadata on keepExif=true via direct CGImage passthrough (#168) (#391). (2d6b7fe4)
• FIX(dart): reject compressAndGetFile when source == target (#240) (#386). (c1dbe754)
• FIX(iOS): don't crash on WebP + keepExif when ImageIO can't rewrite metadata (#369). (46e59a4b)
• FEAT(darwin): migrate to Swift Package Manager (#323). (a77d6c49)
• DOCS(Android): surface HEIC + keepExif limitation via Log.w + README matrix (refs #130) (#394). (3d47a609)

• REFACTOR(common): drop go-flutter plugin, rebuild example native shell (#368). (6d3898b0)
• FIX(Android): preserve source EXIF on PNG and WebP output (refs #130) (#395). (4ddf1390)
• FIX(iOS): preserve full source metadata on keepExif=true via direct CGImage passthrough (#168) (#391). (2d6b7fe4)
• FIX(dart): reject compressAndGetFile when source == target (#240) (#386). (c1dbe754)
• FIX(iOS): don't crash on WebP + keepExif when ImageIO can't rewrite metadata (#369). (46e59a4b)
• FEAT(darwin): migrate to Swift Package Manager (#323). (a77d6c49)
• DOCS(Android): surface HEIC + keepExif limitation via Log.w + README matrix (refs #130) (#394). (3d47a609)

What's Changed

• Bump compileSdk to 34 by @MominRaza in #312
• Migrate js interop fixes #297 by @myxzlpltk in #306
• Throw more descriptive error when user has not included pica in their html by @ShreyashKore in #302
• feat: remove pica from web by @CaiJingLong in #324
• bump web package to 1.1.0 by @tainanfochesatto in #328
• Fix: Correct image size calculation for macOS with NSImage by @sejong2401 in #316

New Contributors

• @MominRaza made their first contribution in #312
• @myxzlpltk made their first contribution in #306
• @ShreyashKore made their first contribution in #302
• @tainanfochesatto made their first contribution in #328
• @sejong2401 made their first contribution in #316

Full Changelog: flutter_image_compress-v2.3.0...flutter_image_compress-v2.4.0

• FEAT: remove pica from web (#324). (b56ce0fa)

• FEAT: Update plugin structure for OpenHarmony (#301). (5e999c43)

• FEAT: support openharmony (#290). (e9f10b28)
• DOCS: The first version for OpenHarmony. (5fcab8da)

• FEAT: support macOS (#264). (06ab91ed)
• DOCS: Update README (#266). (235643ab)
• DOCS: Update README. (1e232a10)
• DOCS: Update changelog. (c847f5d5)

• DOCS: Update changelog. (c847f5d5)

• Bump dependencies version.
• Change sdk constraint to >=2.12.0 <4.0.0.

• Config default_plugin for web in pubspec.yaml.

• Include web support.

• Migrate platform interface

Breaking Change:

• The result File to XFile of cross_file

See the migration guide for more details.

• Fix converting from WebP causes app crash on iOS. (#222).

• Fix crashes on iOS with nil data. (#220)
• Adapt Flutter 3.3.

1.1.1

• FIX(Android): replace deprecated EXIF ISO tag (#403). (5c28723f)
• FIX(Android): handle Gradle 9 Kotlin modes safely (#401). (e4bbccae)

• FIX(Android): replace deprecated EXIF ISO tag (#403). (5c28723f)
• FIX(Android): handle Gradle 9 Kotlin modes safely (#401). (e4bbccae)

2026-07-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_image_compress - v2.5.0
• flutter_image_compress_common - v1.1.0
• flutter_image_compress_macos - v1.1.0
• flutter_image_compress_ohos - v0.0.3+1
• flutter_image_compress_platform_interface - v1.1.0
• flutter_image_compress_web - v0.1.5+1

• Merge effective PRs that improve the plugin from various aspects, including: #192, #207, #208, #210, #214. Thanks to these contributors.
• Repo cleanup.

• FIX(*): translate native compress failures to CompressError instead of null (#397). (296af9a3)
• FIX(dart): validator throws in release + names the offending path (#189 #247) (#383). (c8e13e2a)
• FIX(dart): give UnsupportedFlutterImageCompress actionable error messages (#250 #303 #235) (#379). (54c13e61)

• REFACTOR(common): drop go-flutter plugin, rebuild example native shell (#368). (6d3898b0)
• FIX(*): translate native compress failures to CompressError instead of null (#397). (296af9a3)
• FIX(Android): preserve source EXIF on PNG and WebP output (refs #130) (#395). (4ddf1390)
• FIX(iOS): preserve full source metadata on keepExif=true via direct CGImage passthrough (#168) (#391). (2d6b7fe4)
• FIX(iOS): mkdir target parent before writeToURL (analog of #375) (#389). (ed265d8f)
• FIX(Android): recycle source bitmap in CommonHandler JPEG/PNG/WebP path (#77 #80 #136 partial) (#388). (2775be8b)
• FIX(Android): recycle HEIC bitmaps and always close HeifWriter (#136 partial) (#387). (38466e7b)
• FIX(Android): recycle intermediate bitmaps in scale/rotate pipeline (#77 #80 partial) (#382). (ef837251)
• FIX(iOS): detect HEIC/HEIF/AVIF via ISO BMFF ftyp box in mime sniffer (#381). (8c768f00)
• FIX(Android): delete HEIC tmp file + cache CI deps (#321 partial) (#380). (03230ba6)
• FIX(iOS): delete HEIC intermediate tmp file after read-back (#321 partial) (#377). (cfeb1344)
• FIX(Android): preserve full EXIF and stop leaking tmp .jpg in ExifKeeper (#376). (31558ae4)
• FIX(Android): mkdirs the target path's parent before writing (#194 #181 #90) (#375). (6616d101)
• FIX(iOS): reject non-image input files instead of returning a bogus XFile (#374). (7b2f5cc1)
• FIX(Android): decode into ARGB_8888 instead of RGB_565 (#373). (96fbaf08)
• FIX(iOS): compute rotated bbox off the main thread without UIKit (#353) (#370). (717690e8)
• FIX(Android): don't kill the process when the input file is unreadable (#122) (#372). (c88e4758)
• FIX(iOS): don't crash on WebP + keepExif when ImageIO can't rewrite metadata (#369). (46e59a4b)
• FIX(iOS): guard HEIC encoding against nil colorSpace and silent write failures (#358). (aa69d225)
• FIX: Remove AssetsLibrary usage for iOS 26 compatibility (#366). (966a1328)
• FIX: Update commons-io dependency from 2.6 to 2.16.1+ to fix security… (#340). (41f996cc)
• FEAT(Android): opt into Flutter's built-in Kotlin (KGP migration) (#390). (e6a8e769)
• FEAT(darwin): migrate to Swift Package Manager (#323). (a77d6c49)
• DOCS(Android): surface HEIC + keepExif limitation via Log.w + README matrix (refs #130) (#394). (3d47a609)

• FIX(macOS): offload compression off the AppKit main thread (#398). (3d458027)
• FIX(*): translate native compress failures to CompressError instead of null (#397). (296af9a3)
• FIX(macOS): guard remaining force-unwraps in handleImage (#378). (664c18f4)
• FIX(macOS): stop crashing when CGImageDestinationCreate returns nil (#339, #314) (#371). (99370c8d)
• FEAT(darwin): migrate to Swift Package Manager (#323). (a77d6c49)

• REFACTOR(common): drop go-flutter plugin, rebuild example native shell (#368). (6d3898b0)
• FIX(*): translate native compress failures to CompressError instead of null (#397). (296af9a3)
• FIX(Android): preserve source EXIF on PNG and WebP output (refs #130) (#395). (4ddf1390)
• FIX(iOS): preserve full source metadata on keepExif=true via direct CGImage passthrough (#168) (#391). (2d6b7fe4)
• FIX(iOS): mkdir target parent before writeToURL (analog of #375) (#389). (ed265d8f)
• FIX(Android): recycle source bitmap in CommonHandler JPEG/PNG/WebP path (#77 #80 #136 partial) (#388). (2775be8b)
• FIX(Android): recycle HEIC bitmaps and always close HeifWriter (#136 partial) (#387). (38466e7b)
• FIX(Android): recycle intermediate bitmaps in scale/rotate pipeline (#77 #80 partial) (#382). (ef837251)
• FIX(iOS): detect HEIC/HEIF/AVIF via ISO BMFF ftyp box in mime sniffer (#381). (8c768f00)
• FIX(Android): delete HEIC tmp file + cache CI deps (#321 partial) (#380). (03230ba6)
• FIX(iOS): delete HEIC intermediate tmp file after read-back (#321 partial) (#377). (cfeb1344)
• FIX(Android): preserve full EXIF and stop leaking tmp .jpg in ExifKeeper (#376). (31558ae4)
• FIX(Android): mkdirs the target path's parent before writing (#194 #181 #90) (#375). (6616d101)
• FIX(iOS): reject non-image input files instead of returning a bogus XFile (#374). (7b2f5cc1)
• FIX(Android): decode into ARGB_8888 instead of RGB_565 (#373). (96fbaf08)
• FIX(iOS): compute rotated bbox off the main thread without UIKit (#353) (#370). (717690e8)
• FIX(Android): don't kill the process when the input file is unreadable (#122) (#372). (c88e4758)
• FIX(iOS): don't crash on WebP + keepExif when ImageIO can't rewrite metadata (#369). (46e59a4b)
• FIX(iOS): guard HEIC encoding against nil colorSpace and silent write failures (#358). (aa69d225)
• FIX: Remove AssetsLibrary usage for iOS 26 compatibility (#366). (966a1328)
• FIX: Update commons-io dependency from 2.6 to 2.16.1+ to fix security… (#340). (41f996cc)
• FEAT(Android): opt into Flutter's built-in Kotlin (KGP migration) (#390). (e6a8e769)
• FEAT(darwin): migrate to Swift Package Manager (#323). (a77d6c49)
• DOCS(Android): surface HEIC + keepExif limitation via Log.w + README matrix (refs #130) (#394). (3d47a609)

• Add SDWebImage dependency for iOS. (#182)
• Repo cleanup.

October 08, 2025

androidx.heifwriter:heifwriter:1.1.0 is released. Version 1.1.0 contains these commits .

Modify the constraint version of flutter to 2.0.0

Migrate null-safety version.

• Fix memory leaked for android.
• Support android v2 plugin.

Breaking Change:

• Replace List<int> to Uint8List.

• Update Validate code.

Use the async GCD in iOS.

New feature

• Support webp on iOS.

Fix:

• Web format error
• Import header error for iOS.

New feature:

• Add Params inSampleSize for methods.
• Heif and webp Partially supported.

Fix:

• Android: When the register of the calling plugin is not in the main process or there is no Activity.

Optimization:

• Reduce the speed required for ios to add dependencies by copying the SYPictureMetadata source code into the project.

Fix:

• autoCorrectionAngle switches image width and height.

New feature:

• Keep exif (no have orientation), use keepExif

BREAKING CHANGE :

• remove method getImageInfo.

For the time being, the follow-dev branch is no longer used, but only the master branch is needed to unify the pub version number.

New Feature:

• It is now supported to set the compression target to png format.

Fix:

• #49: A problem of reading Exif information.

Change reportError with flutter stable version.

Breaking Change: The autoCorrectionAngle parameter causes a number of situations to behave differently than 0.4.0. See readme for details.

(don't use)

Breaking Change: Because FlutterError.reportError method's param context type changed. So this library will add the constraints of flutter SDK so that users before 1.5.9 will not use version 0.5.0 incorrectly.

Some code has been added to ensure that parameters that do not pass in native do not trigger crash.

Fix:

• Android close file output stream.

Fix:

• optimize compress scale.

Updated Kotlin version

Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to also migrate if they're using the original support library.

change iOS return type

add some dart doc

update readme

The version number is updated so that people who can use the higher version of gradle can use it. see pr #8

if android run error, you must update your kotlin's version to 1.2.71+

• DEPS: Update js to >=0.6.0 <0.8.0.

2023-10-20

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• flutter_image_compress - v2.1.0
• flutter_image_compress_common - v1.0.3
• flutter_image_compress_platform_interface - v1.0.3
• flutter_image_compress_web - v0.1.3+2
• flutter_image_compress_macos - v1.0.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• flutter_image_compress_macos - v1.0.1

add optional params rotate

fix bug

update example

fix the ios flutter.h bug

update readme

first version