Release notes from Android-Image-Cropper

4.7.0

2025-11-28T05:22:02Z

Security: Added URI validation to prevent file system manipulation (fixes #613) #680 (xronyx)
Fix issue #610: keep layout params #665 (isidro89)
Add danish language support #666 (andreastorp)
Removed file provider workaround to fix security issue #659 (M66B)
Add support for south indian languages #658 (the-alchemist-07)
Fix: Crop overlay jumps during multiple pointers active, but initial pointer is released #656 (dinaraparanid)
Renovate: Automerge updates. (vanniktech)
Update: Added missing translations, and support for Gujarati language #647 (Jaypatelbond)
Updations to the Hindi language #640 (the-alchemist-07)
Added new language - Malayalam #638 (the-alchemist-07)

4.6.0

2024-08-05T10:05:29Z

API: CropImageOptions#canChangeCropWindow option. #636 (vanniktech)
API: Deprecate CropImageActivity. #635 (vanniktech)
API: Deprecate CropImageContract. #637 (vanniktech)
Fixed bug when changing toolbar text color #556 (Husseinhj)
Resource: Missing Translations added for korean / japanese #552 (hubtwork)
Technical: Update to Kotlin 2.0.0 & more. #634 (vanniktech)

4.5.0

2022-11-02T10:35:53Z

README: Slightly improve the Migration section. #520 (vanniktech)
API: Deprecate CropImageView.croppedImage #519 (vanniktech)
API: Deprecate CropImageView.isSaveBitmapToInstanceState #518 (vanniktech)
API: Remove deprecated methods from Version 4.4.0 in CropImageContractOption. #513 (vanniktech)
API: Remove deprecated methods from Version 4.4.0 in CropImage. #512 (vanniktech)
Behavior Change: Always try to return resized bitmap in CropResult. #509 (vanniktech)
Behavior Change: The crop area for CropShapes (Rectangle, Rectangle vertical only, Rectangle horizontal only) can now also be adjusted by dragging outside the Crop Area just like it's always been possible for CropShape.OVAL. #508 (vanniktech)

4.4.0

2022-10-24T13:14:43Z

API: CropImageOptions is now a data class. Currently with mutable properties, this will change to immutable soon. #490 (vanniktech)
API: CropImageView gets a setImageCropOptions method. #500 (vanniktech)
API: Deprecate CropImageContractOptions functions to modify CropImageOptions instance. #492 (vanniktech)
API: Make BitmapCroppingWorkerJob internal. #478 (vanniktech)
API: Make BitmapLoadingWorkerJob internal. #465 (vanniktech)
API: Make CropException inner objects internal. #470 (vanniktech)
API: Make CropImageIntentChooser internal. #485 (vanniktech)
API: Make CropImageOptions class final. #487 (vanniktech)
API: Make CropOverlayView internal. #468 (vanniktech)
API: Make CropWindowMoveHandler & CropWindowHandler internal. #467 (vanniktech)
Behavior Change: By default always show the guidelines. #494 (vanniktech)
Behavior change: By default show crop window on the entire image. #474 (vanniktech)
Deprecate: CropImage#get* functions are now deprecated as they seem to be unused. #469 (vanniktech)
New API: CropImageView#expectedImageSize which returns the expected image size, if cropping the image right now. #496 (vanniktech)
Raise minSdk from 16 to 21. #456 (vanniktech)
Sample: Enable StrictMode. #464 (vanniktech)
Sample: Showcase expectedImageSize in CustomActivity. #503 (vanniktech)
Strict Mode: Fix UnsafeIntentLaunchViolation when using CropImageActivity. #502 (vanniktech)

In addition, this release contains a lot of documentation fixes and refactorings.

4.3.3

2022-10-19T14:04:35Z

⚠️ Maven Coordinates have changed ⚠️

This library will no longer be published to Jitpack. The Maven Coordinates have changed, and the library is now on Maven Central. In order to consume the new update please change:

-implementation("com.github.CanHub:Android-Image-Cropper:4.3.2")
+implementation("com.vanniktech:android-image-cropper:4.3.3")

For now, everything else stays the same. vanniktech has taken over the maintenance of this library.

Kotlin Build Script, proper Maven Publishing, new workflows, Gradle Catalogue & much more #450 (vanniktech)
Correctly close resources in BitmapUtils. #440 (vanniktech)
Bugfix/437 setting toolbar color to white does nothing #438 (Devenom1)

4.3.2

2022-09-08T12:10:27Z

What's Changed

Fixes #402 - Mistake in hindi conversion of "Crop" by @pratyaksh1610 in #410
Feature/421 add color customisations for crop image activity by @Devenom1 in #422
#417: Explain SecurityException in FAQs when having camera permission… by @PhilippNowak96 in #424
#423 Fixed accidentally swiping back on newer Android devices when tr… by @Janneman84 in #425
Bugfix/427 back button doesnt work when activity launched by @Devenom1 in #429

New Contributors

@pratyaksh1610 made their first contribution in #410
@PhilippNowak96 made their first contribution in #424
@Janneman84 made their first contribution in #425

Full Changelog: 4.3.1...4.3.2

4.3.1

2022-07-20T09:54:36Z

🚀 34 - ⬇️ 152.8k - ⭐ 643 - 🔎 15 - 🍴 155

What's Changed

Fix Ratio typo in sample app. by @vanniktech in #385
Documentation fixes. by @vanniktech in #388
Sample: Use a consistent name for flipping options. by @vanniktech in #389
CropImageOptions: Option to change progress bar color. by @vanniktech in #390
Sample: Showcase 2:1 aspect ratio by @vanniktech in #386
Update dependencies. by @vanniktech in #394
CropImageView: Use customOutputUri instance property as a fallback in startCropWorkerTask. by @vanniktech in #401
Remove the manifest hack by @PaulWoitaschek in #399
fix(exif-orientation): added support for exif values 2, 4, 5 and 7 by @Mouwrice in #409
Release/4.3.1 by @Canato in #411

New Contributors

@vanniktech made their first contribution in #385
@PaulWoitaschek made their first contribution in #399
@Mouwrice made their first contribution in #409

Full Changelog: 4.3.0...4.3.1

4.3.0

2022-06-10T12:14:01Z

🚀 33 - ⬇️ 147.7k - ⭐ 578 - 🔎 17 - 🍴 147

What's Changed

Translation of "Camera" and "Gallery" added in some languages by @yasmanets in #358
Pr/cropper text label support by @bhagyae5308 in #382

New Contributors

@yasmanets made their first contribution in #358
@fadsel made their first contribution in #360
@lazydevpro made their first contribution in #367
@Morons made their first contribution in #369

Full Changelog: 4.2.1...4.3.0

4.2.1

2022-04-04T16:02:39Z

🚀 32 - ⬇️ 116.3k - ⭐ 506 - 🔎 17 - 🍴 133

What's Changed

Bug fixed by adding setCancelable(false) by @RemiMabsout in #343
Added CropException class by @rempawl in #344
Added intent chooser for selecting image sources by @Devenom1 in #326

New Contributors

@RemiMabsout made their first contribution in #343
@rempawl made their first contribution in #344
@Devenom1 mad their second contribution in #326

Full Changelog: 4.2.0...4.2.1

4.2.0

2022-03-21T18:12:46Z

🚀 31 - ⬇️ 100.8k - ⭐ 478 - 🔎 17 - 🍴 126

Added

Added an option to skip manual editing and return entire image when required #324 @Devenom1

Fixed

Added missing support for ScaleType.CENTER_CROP #220 @scana
State is now preserved across configuration changes #296 @ClouddJR
Fix shadow bug #261 @kingspride

Changed

Update portuguese strings #321 @NowDev