# image_cropper 13.0.0
A Flutter plugin for Android, iOS and Web supports cropping images
## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com
flutter pub add image_cropper
```
Published: 2026-10-12T08:41:34.833069Z
Expected archive SHA-256: 4fb175bb30130389331a406da82e5c9bd31a866585cbb1e11e6e21a7e24b0ef2
Available in cache; verification: upstream_checksum
## Direct dependencies
- flutter: map[sdk:flutter]
- image_cropper_for_web: ^8.0.1
- image_cropper_platform_interface: ^9.0.0
## Package README (untrusted upstream documentation)
# Image Cropper
[](https://pub.dartlang.org/packages/image_cropper)
A Flutter plugin for Android, iOS and Web supports cropping images. This plugin is based on three different native libraries so it comes with different UI between these platforms.
## Introduction
**Image Cropper** doesn't manipulate images in Dart codes directly, instead, the plugin uses [Platform Channel](https://flutter.dev/docs/development/platform-integration/platform-channels) to expose Dart APIs that Flutter application can use to communicate with three very powerful native libraries ([uCrop](https://github.com/Yalantis/uCrop), [TOCropViewController](https://github.com/TimOliver/TOCropViewController) and [Cropper.js](https://github.com/fengyuanchen/cropperjs)) to crop and rotate images. Because of that, all credits belong to these libraries.
### uCrop - Yalantis
[](https://GitHub.com/Yalantis/uCrop/watchers/) [](https://GitHub.com/Yalantis/uCrop/stargazers/) [](https://GitHub.com/Yalantis/uCrop/network/) [](https://jitpack.io/#Yalantis/uCrop) [](https://opensource.org/licenses/Apache-2.0)
This project aims to provide an ultimate and flexible image cropping experience. Made in [Yalantis](https://yalantis.com/?utm_source=github)
### TOCropViewController - Tim Oliver
[](https://GitHub.com/TimOliver/TOCropViewController/watchers/) [](https://GitHub.com/TimOliver/TOCropViewController/stargazers/) [](https://GitHub.com/TimOliver/TOCropViewController/network/) [](https://cocoadocs.org/docsets/TOCropViewController) [](https://raw.githubusercontent.com/TimOliver/TOCropViewController/master/LICENSE)
`TOCropViewController` is an open-source `UIViewController` subclass to crop out sections of `UIImage` objects, as well as perform basic rotations. It is excellent for things like editing profile pictures, or sharing parts of a photo online. It has been designed with the iOS Photos app editor in mind, and as such, behaves in a way that should already feel familiar to users of iOS.
## How to install
### Android
- Add UCropActivity into your AndroidManifest.xml
````xml
````
#### Note:
- From v1.2.0, you need to migrate your android project to v2 embedding ([detail](https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects))
### iOS
- No configuration required
### Web
- Add following codes inside `` tag in file `web/index.html`:
```html
....
....
```
## Usage
### Required parameters
* **sourcePath**: the absolute path of an image file.
### Optional parameters
* **maxWidth**: maximum cropped image width.
* **maxHeight**: maximum cropped image height.
* **aspectRatio**: controls the aspect ratio of crop bounds. If this values is set, the cropper is locked and user can't change the aspect ratio of crop bounds.
* **compressFormat**: the format of result image, png or jpg (default is ImageCompressFormat.jpg).
* **compressQuality**: number between 0 and 100 to control the quality of image compression. Note: this field is ignored on Web.
* **uiSettings**: controls UI customization on specific platform (android, ios, web,...)
* Android: see [Android customization](#android-1).
* iOS: see [iOS customization](#ios-1).
* Web: see [Web customization](#web-1).
### Note
* The result file is saved in `NSTemporaryDirectory` on iOS and application Cache directory on Android, so it can be lost later, you are responsible for storing it somewhere permanent (if needed).
* The implementation on Web is much different compared to the implementation on mobile app. It causes some configuration fields not working (`compressQuality`) on Web.
* `WebUiSettings` is required for Web.
## Customization
### Android
Click to view detail
**Image Cropper** provides a helper class called `AndroidUiSettings` that wraps all properties can be used to customize UI in **uCrop** library.
| Property | Description | Type |
|-----------------------------|------------------------------------------------------------------------------------------------------------|---------------------------------|
| `toolbarTitle` | desired text for Toolbar title | String |
| `toolbarColor` | desired color of the Toolbar | Color |
| `statusBarLight` | set to true for light status bar (dark icons), false for dark status bar (light icons) | bool |
| `navBarLight` | set to true for light navigation bar (dark icons), false for dark navigation bar (light icons) | bool |
| `toolbarWidgetColor` | desired color of Toolbar text and buttons (default is darker orange) | Color |
| `backgroundColor` | desired background color that should be applied to the root view | Color |
| `activeControlsWidgetColor` | desired resolved color of the active and selected widget and progress wheel middle line (default is white) | Color |
| `dimmedLayerColor` | desired color of dimmed area around the crop bounds | Color |
| `cropFrameColor` | desired color of crop frame | Color |
| `cropGridColor` | desired color of crop grid/guidelines | Color |
| `cropFrameStrokeWidth` | desired width of crop frame line in pixels | int |
| `cropGridRowCount` | crop grid rows count | int |
| `cropGridColumnCount` | crop grid columns count | int |
| `cropGridStrokeWidth` | desired width of crop grid lines in pixels | int |
| `showCropGrid` | set to true if you want to see a crop grid/guidelines on top of an image | bool |
| `lockAspectRatio` | set to true if you want to lock the aspect ratio of crop bounds with a fixed value (locked by default) | bool |
| `freeStyleCropEnabled` | set to true to let the user resize the crop frame by dragging its corners. Independent of `lockAspectRatio` — set both to `true` to match iOS' "locked ratio + draggable corners" behaviour. When `null`, freestyle is enabled iff `lockAspectRatio` is `false` (legacy default). | bool |
| `freeStyleCropShrinkOnly` | set to true to launch `CmUCropActivity`: corners may shrink the crop frame but not expand it past the initial size (iOS `TOCropViewController` parity). Requires `freeStyleCropEnabled: true`. | bool |
| `hideBottomControls` | set to true to hide the bottom controls (shown by default) | bool |
| `initAspectRatio` | desired aspect ratio is applied (from the list of given aspect ratio presets) when starting the cropper | CropAspectRatioPreset |
| `cropStyle` | controls the style of crop bounds, it can be rectangle or circle style (default is `CropStyle.rectangle`). | CropStyle |
| `aspectRatioPresets` | controls the list of aspect ratios in the crop menu view. | List |
### iOS
Click to view detail
**Image Cropper** provides a helper class called `IOUiSettings` that wraps all properties can be used to customize UI in **TOCropViewController** library.
| Property | Description | Type |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| `minimumAspectRatio` | The minimum croping aspect ratio. If set, user is prevented from setting cropping rectangle to lower aspect ratio than defined by the parameter | double |
| `rectX` | The initial rect of cropping: x. | double |
| `rectY` | The initial rect of cropping: y. | double |
| `rectWidth` | The initial rect of cropping: width. | double |
| `rectHeight` | The initial rect of cropping: height. | double |
| `showActivitySheetOnDone` | If true, when the user hits 'Done', a `UIActivityController` will appear before the view controller ends | bool |
| `showCancelConfirmationDialog` | Shows a confirmation dialog when the user hits 'Cancel' and there are pending changes (default is false) | bool |
| `rotateClockwiseButtonHidden` | When disabled, an additional rotation button that rotates the canvas in 90-degree segments in a clockwise direction is shown in the toolbar (default is false) | bool |
| `embedInNavigationController` | Embed the presented TOCropViewController in a UINavigationController. (default is false) | bool |
| `hidesNavigationBar` | If this controller is embedded in `UINavigationController` its navigation bar is hidden by default. Set this property to false to show the navigation bar. This must be set before this controller is presented | bool |
| `rotateButtonsHidden` | When enabled, hides the rotation button, as well as the alternative rotation button visible when `showClockwiseRotationButton` is set to YES (default is false) | bool |
| `resetButtonHidden` | When enabled, hides the 'Reset' button on the toolbar (default is false) | bool |
| `aspectRatioPickerButtonHidden` | When enabled, hides the 'Aspect Ratio Picker' button on the toolbar (default is false) | bool |
| `resetAspectRatioEnabled` | If true, tapping the reset button will also reset the aspect ratio back to the image default ratio. Otherwise, the reset will just zoom out to the current aspect ratio. If this is set to false, and `aspectRatioLockEnabled` is set to true, then the aspect ratio button will automatically be hidden from the toolbar (default is true) | bool |
| `aspectRatioLockDimensionSwapEnabled` | If true, a custom aspect ratio is set, and the `aspectRatioLockEnabled` is set to true, the crop box will swap it's dimensions depending on portrait or landscape sized images. This value also controls whether the dimensions can swap when the image is rotated (default is false) | bool |
| `aspectRatioLockEnabled` | If true, while it can still be resized, the crop box will be locked to its current aspect ratio. If this is set to true, and `resetAspectRatioEnabled` is set to false, then the aspect ratio button will automatically be hidden from the toolbar (default is false) | bool |
| `title` | Title text that appears at the top of the view controller. | String |
| `doneButtonTitle` | Title for the 'Done' button. Setting this will override the Default which is a localized string for "Done" | String |
| `cancelButtonTitle` | Title for the 'Cancel' button. Setting this will override the Default which is a localized string for "Cancel" | String |
| `cropStyle` | controls the style of crop bounds, it can be rectangle or circle style (default is `CropStyle.rectangle`). | CropStyle |
| `aspectRatioPresets` | controls the list of aspect ratios in the crop menu view. | List |
### Web
Click to view detail
**Image Cropper** provides a helper class called `WebUiSettings` that wraps all properties can be used to customize UI in **cropperjs** library.
| Property | Description | Type |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| `size` | Display size of the cropper. Default = `{ width: 500, height: 500 }` | CropperSize |
| `viewMode` | Define the view mode of the cropper. Details of available options in [View Mode](#view-mode). Default = `0` | WebViewMode |
| `dragMode` | Define the dragging mode of the cropper. Details of available options in [Drag Mode](#drag-mode). Default = `crop` | WebDragMode |
| `initialAspectRatio` | Define the initial aspect ratio of the crop box. By default, it is the same as the aspect ratio of the canvas (image wrapper). Note: Only available when the aspectRatio option is set to NaN. | num |
| `checkCrossOrigin` | Check if the current image is a cross-origin. Default = `true` image. | bool |
| `checkOrientation` | Check the current image's Exif Orientation information. Note that only a JPEG image may contain Exif Orientation information. Requires to set both the rotatable and scalable options to true at the same time. Default = `true` | bool |
| `modal` | Show the black modal above the image and under the crop box. Default = `true` | bool |
| `guides` | Show the dashed lines above the crop box. Default = `true` | bool |
| `center` | Show the center indicator above the crop box. Default = `true` | bool |
| `highlight` | Show the white modal above the crop box (highlight the crop box). Default = `true` | bool |
| `background` | Show the grid background of the container. Default = `true` | bool |
| `movable` | Enable to move the image. Default = `true` | bool |
| `rotatable` | Enable to rotate the image. Default = `true` | bool |
| `scalable` | Enable to scale the image. Default = `true` | bool |
| `zoomable` | Enable to zoom the image. Default = `true` | bool |
| `zoomOnTouch` | Enable to zoom the image by dragging touch. Default = `true` | bool |
| `zoomOnWheel` | Enable to zoom the image by mouse wheeling. Default = `true` | bool |
| `wheelZoomRatio` | Define zoom ratio when zooming the image by mouse wheeling. Default = `0.1` | num |
| `cropBoxMovable` | Enable to move the crop box by dragging. Default = `true` | bool |
| `cropBoxResizable` | Enable to resize the crop box by dragging. Default = `true` | bool |
| `toggleDragModeOnDblclick` | Enable to toggle drag mode between "crop" and "move" when clicking twice on the cropper. Default = `true` | bool |
| `minContainerWidth` | The minimum width of the container. Default = `200` | num |
| `minContainerHeight` | The minimum height of the container. Default = `100` | num |
| `minCropBoxWidth` | The minimum width of the crop box. Default = `0` | num |
| `minCropBoxHeight` | The minimum height of the crop box. Default = `0` | num |
| `presentStyle` | Presentation style of cropper, either a dialog or a page (route). Default = `dialog` | WebPresentStyle |
| `context` | Current BuildContext. The context is required to show cropper dialog or route | BuildContext |
| `customDialogBuilder` | Builder to customize the cropper `Dialog` | WebDialogBuilder |
| `customRouteBuilder` | Builder to customize the cropper `PageRoute` | WebRouteBuilder |
| `barrierColor` | Barrier color for displayed `Dialog` | Color |
| `translations` | Translations to display | WebTranslations |
| `themeData` | Control UI customization | WebThemeData |
#### View Mode:
- `0`: no restrictions
- `1`: restrict the crop box not to exceed the size of the canvas.
- `2`: restrict the minimum canvas size to fit within the container. If the proportions of the canvas and the container differ, the minimum canvas will be surrounded by extra space in one of the dimensions.
- `3`: restrict the minimum canvas size to fill fit the container. If the proportions of the canvas and the container are different, the container will not be able to fit the whole canvas in one of the dimensions.
If you set `viewMode` to `0`, the crop box can extend outside the canvas, while a value of `1`, `2`, or `3` will restrict the crop box to the size of the canvas. `viewMode` of `2` or `3` will additionally restrict the canvas to the container. There is no difference between `2` and `3` when the proportions of the canvas and the container are the same.
#### Drag Mode:
- `crop`: create a new crop box
- `move`: move the canvas
- `none`: do nothing
#### Note:
If using `WebDialogBuilder` and `WebRouteBuilder` to customize cropper dialog and route, the customization codes must to call following functions:
- `initCropper()` to initialize `Cropper` object.
- `crop()` to trigger crop feature and then returning the cropped result data to the plugin by using `Navigator.of(context).pop(result)`.
````dart
class CropperDialog extends StatefulWidget {
...
}
class _CropperDialogState extends State {
@override
void initState() {
super.initState();
/// IMPORTANT: must to call this function
widget.initCropper();
}
@override
Widget build(BuildContext context) {
Dialog(
child: Column(
children: [
...
cropper,
...
TextButton(
onPressed: () async {
/// IMPORTANT: to call crop() function and return
/// result data to plugin, for example:
final result = await crop();
Navigator.of(context).pop(result);
},
child: Text('Crop'),
)
]
),
);
}
}
WebUiSettings(
...
customDialogBuilder: (cropper, initCropper, crop, rotate, scale) {
return CropperDialog(
cropper: cropper,
initCropper: initCropper,
crop: crop,
rotate: rotate,
scale: scale,
);
},
...
)
````
## Example
````dart
import 'package:image_cropper/image_cropper.dart';
CroppedFile croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
uiSettings: [
AndroidUiSettings(
toolbarTitle: 'Cropper',
toolbarColor: Colors.deepOrange,
toolbarWidgetColor: Colors.white,
aspectRatioPresets: [
CropAspectRatioPreset.original,
CropAspectRatioPreset.square,
CropAspectRatioPresetCustom(),
],
),
IOSUiSettings(
title: 'Cropper',
aspectRatioPresets: [
CropAspectRatioPreset.original,
CropAspectRatioPreset.square,
CropAspectRatioPresetCustom(), // IMPORTANT: iOS supports only one custom aspect ratio in preset list
],
),
WebUiSettings(
context: context,
),
],
);
class CropAspectRatioPresetCustom implements CropAspectRatioPresetData {
@override
(int, int)? get data => (2, 3);
@override
String get name => '2x3 (customized)';
}
````
## Credits
- Android: [uCrop](https://github.com/Yalantis/uCrop) created by [Yalantis](https://github.com/Yalantis)
- iOS: [TOCropViewController](https://github.com/TimOliver/TOCropViewController) created by [Tim Oliver](https://twitter.com/TimOliverAU)
- Web: [Cropper.js](https://github.com/fengyuanchen/cropperjs) created by [Fengyuan Chen](https://github.com/fengyuanchen)
## Changelog
## 13.0.0
- Android: add `freeStyleCropEnabled` to `AndroidUiSettings` so callers can opt into uCrop's draggable corner handles independently of `lockAspectRatio`. Lets Android match iOS' "locked aspect ratio + resizable corners" UX. Defaults to `null`, preserving the previous `!lockAspectRatio` behaviour.
- Android: add `freeStyleCropShrinkOnly` and `CmUCropActivity` so the crop frame can shrink but not expand past its initial size (iOS parity).
- iOS: upgrade `TOCropViewController` to v3.2.0
- Android: migrate `build.gradle` to the property-style DSL (`compileSdk`, `minSdk`, `testInstrumentationRunner`, `namespace`) and replace the removed `lintOptions` block with `lint`, so consumers no longer need `android.newDsl=false` under AGP 9 (#622).
## 12.2.1
- iOS: upgrade `TOCropViewController` to v3.1.2
## 12.2.0
- fix issue on iOS: `Lexical or Preprocessor Issue (Xcode): 'TOCropViewController/TOCropViewConstants.h' file not found`
## 12.1.1
- fix issue of fixed (locked) aspect ratio on iOS
## 12.1.0
- fix issue of `TOCropViewController` on Swift Package
## 12.0.0
* iOS:
- upgrade `TOCropViewController` to v3.1.1 (new Liquid Glass UI)
- support `UISceneDelegate` [#608](https://github.com/hnvn/flutter_image_cropper/pull/608)
* Android: fix Android release build compile error [#599](https://github.com/hnvn/flutter_image_cropper/pull/599)
## 11.0.0
* iOS: upgrade `TOCropViewController` to v2.8.0
**BREAKING CHANGES**:
- iOS: upgrade development target to 12
- Flutter constraint to minimum of 3.28 (due to constraint of `image_cropper_platform_interface`)
## 10.0.0+1
* correct README document for Android (removed workaround note because uCrop now fully supports edge-to-edge feature)
## 10.0.0
* Android: upgrade `uCrop` 2.2.11, it fully supports edge-to-edge now
* Android: `statusBarColor` is deprecated and no longer in use, introduce new properties `statusBarLight` and `navBarLight`
**BREAKING CHANGES**:
- Android: `compileSdkVersion` is set to 36
- Android: if you previously followed the migration guide in v9.0.0 to work around the edge-to-edge issue, please revert those changes (remove file `values-v35/styles.xml`)
## 9.1.0
* Web: fix bug on Flutter WASM [#567](https://github.com/hnvn/flutter_image_cropper/pull/567)
* Android: fix deprecated API [#546](https://github.com/hnvn/flutter_image_cropper/pull/546)
## 9.0.0
* iOS: add support for Swift Package Manager (PR [#555](https://github.com/hnvn/flutter_image_cropper/pull/555))
* Android: refactored edge-to-edge workaround solution by removing related code from the plugin and integrating it directly into the app.
***Migration guide***
- Add follwowing code to file `android/app/src/main/res/values/styles.xml`
```xml
....
```
- Create new file `android/app/src/main/res/values-v35/styles.xml` and add the following code to it:
```xml
```
- Modify the decleration of `UCropActivity` in your `AndroidManifest.xml` (if you have not modified it yet)
```xml
```
## 8.1.0
* Android: workaround edge-to-adge issue on Android 15
***Before***:
```xml
```
***After***:
```xml
```
## 8.0.2
* Android: fix deprecated API
* web: correct constraints of flutter version (>=3.22.0)
## 8.0.1
* use `>=0.5.0 < 2.0.0` version range for package:web
## 8.0.0
* upgrade `web` dependency
* relax flutter version constraints
* iOS: Prefer presented view controller if preset to Root view controller
* iOS: introduce `iOSUiSettings.embedInNavigationController` to support add2app environments
## 7.1.0
* upgrade `platform_interface` dependency
* increase Dart SDK constraints (`>=3.3.0`)
* Android: Removes references to Flutter v1 android embedding classes.
## 7.0.5
* Web: support config type of output image (jpg or png)
## 7.0.4
* Web: update dependencies
## 7.0.3
* Web: improve cropper UI
## 7.0.2
* Web:
- fix bug cropper not get correct container's size
- improve cropper UI
* correct document
## 7.0.1
* correct document
## 7.0.0
* refactor plugin to use new JS library, `cropperjs` instead of `croppie`
* support Wasm
* support customize `CropAspectRatioPreset`
**BREAKING CHANGES**:
- **WebUiSettings**: is totally re-implemented, please see plugin document for more details
- **cropImage()**: move `cropStyle` and `aspectRatioPresets` into `AndroidUiSettings` and `IOUiSettings` for sake of clean and clarity.
**Migration guides**:
***Before***:
```
File croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
cropStyle: CropStyle.circle,
aspectRatioPresets: [
CropAspectRatioPreset.square,
CropAspectRatioPreset.original,
],
uiSettings: [
AndroidUiSettings(
toolbarTitle: 'Cropper',
),
IOSUiSettings(
title: 'Cropper',
),
],
);
```
***After***:
```
File croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
uiSettings: [
AndroidUiSettings(
toolbarTitle: 'Cropper',
cropStyle: CropStyle.circle,
aspectRatioPresets: [
CropAspectRatioPreset.square,
CropAspectRatioPreset.original,
],
),
IOSUiSettings(
title: 'Cropper',
cropStyle: CropStyle.circle,
aspectRatioPresets: [
CropAspectRatioPreset.square,
CropAspectRatioPreset.original,
],
),
],
);
```
**Web integration**:
***Before***:
```
....
....
```
***After***:
```
....
....
```
## 6.0.0
* Android: upgrade `uCrop` to v2.2.9
* iOS: upgrade `TOCropViewController` to v2.7.3
* web: upgrade `js` to v0.7.1
## 5.0.1
* Android: improve compression quality
## 5.0.0
* upgrade `http` to v1.0.0
## 4.0.1
* refactor CHANGELOG
## 4.0.0
* Android: support namespace, Gradle 8
## 3.0.3
* iOS: bump ios minimum version to 11
## 3.0.2
* Web: fix web translation issue
## 3.0.1
* Android: replace `jcenter` by `mavenCentral`
* Web: support localization
## 3.0.0
* **BREAKING CHANGE**: move all setting models to platform interface packages.
* Separate Javascript codes from `WebSettings` model (so there's no need to use conditional import to config Web UI now)
### ***MIGRATION GUIDE***
#### **BEFORE**
```dart
WebUiSettings(
boundary: Boundary(
width: 520,
height: 520,
),
viewPort: ViewPort(width: 480, height: 480, type: 'circle'),
)
```
#### **AFTER**
```dart
WebUiSettings(
boundary: const CroppieBoundary(
width: 520,
height: 520,
),
viewPort: const CroppieViewPort(width: 480, height: 480, type: 'circle'),
)
```
## 2.0.3
* correct importing JS library
## 2.0.2
* update document
## 2.0.1
* fix missing pubspec config on web
## 2.0.0
* Support Web
**BREAKING CHANGE**:
- change result data type from `File` to `CroppedFile`.
- remove `androidUiSettings` and `iosUiSettings` parameter in `cropImage` method, they are replaced by `uiSettings`
### ***MIGRATION GUIDE***
#### **BEFORE**
```dart
File croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
androidUiSettings: AndroidUiSettings(
toolbarTitle: 'Cropper',
toolbarColor: Colors.deepOrange,
toolbarWidgetColor: Colors.white,
initAspectRatio: CropAspectRatioPreset.original,
lockAspectRatio: false),
iosUiSettings: IOSUiSettings(
minimumAspectRatio: 1.0,
)
);
```
#### **AFTER**
```dart
CroppedFile croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
uiSettings: [
AndroidUiSettings(
toolbarTitle: 'Cropper',
toolbarColor: Colors.deepOrange,
toolbarWidgetColor: Colors.white,
initAspectRatio: CropAspectRatioPreset.original,
lockAspectRatio: false),
IOSUiSettings(
title: 'Cropper',
)
],
);
```
## 2.0.0-beta.3
* support rotate image on Web
## 2.0.0-beta.2
* correct missing README document about Web support.
## 2.0.0-beta.1
* **BREAKING CHANGE**: update result models to support web, replace `File` by `CroppedFile`
## 2.0.0-beta
* migrate to federated plugins
* **BREAKING CHANGE**: remove `androidUiSettings` and `iosUiSettings`, they are replaced by `uiSettings` for sake of supporting multiple platforms in future.
### ***MIGRATION GUIDE***
#### **BEFORE**
```dart
File croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
androidUiSettings: AndroidUiSettings(
toolbarTitle: 'Cropper',
toolbarColor: Colors.deepOrange,
toolbarWidgetColor: Colors.white,
initAspectRatio: CropAspectRatioPreset.original,
lockAspectRatio: false),
iosUiSettings: IOSUiSettings(
minimumAspectRatio: 1.0,
)
);
```
#### **AFTER**
```dart
File croppedFile = await ImageCropper().cropImage(
sourcePath: imageFile.path,
uiSettings: [
AndroidUiSettings(
toolbarTitle: 'Cropper',
toolbarColor: Colors.deepOrange,
toolbarWidgetColor: Colors.white,
initAspectRatio: CropAspectRatioPreset.original,
lockAspectRatio: false),
IOSUiSettings(
title: 'Cropper',
)
],
);
```
## 1.5.1
* update README to introduce Web support experiment
## 1.5.0
* Upgrade `uCrop` to v2.2.8
* Upgrade `TOCropViewController` to v2.6.1
* PR: [#309](https://github.com/hnvn/flutter_image_cropper/pull/309), #[229](https://github.com/hnvn/flutter_image_cropper/pull/299), #[294](https://github.com/hnvn/flutter_image_cropper/pull/294), [#258](https://github.com/hnvn/flutter_image_cropper/pull/258), [#251](https://github.com/hnvn/flutter_image_cropper/pull/258)
* **BREAKING CHANGE**: change `cropImage()` to instance method
## 1.4.1
* Upgrade `uCrop` to v2.2.7
## 1.4.0
* Upgrade `TOCropViewController` to v2.6.0
* Migrate to nullsafety
## 1.3.1
* Upgrade `uCrop` to v2.2.6
* Fix bug: image compress file format (png)
## 1.3.0
* Update `pubspec` to new format
* Upgrade `TOCropViewController` to v2.5.4
## 1.2.3
* Android: fix bug
## 1.2.2
* Android: upgrade uCrop to v2.2.5
* **BREAKING CHANGE**: remove `activeWidgetColor` from `AndroidUiSettings`
## 1.2.1
* iOS: add more UI customization properties (title, initRect)
* update Flutter version constraint (>= v1.12.13)
## 1.2.0
* Android: migrate to embedding v2
## 1.1.2
* Android: fix bug crashing on Flutter v1.12.13
## 1.1.1
* Android: upgrade gradle version
* iOS: remove `static_framework` Pod configuration, upgrade `TOCropViewController` to 2.5.2
## 1.1.0
* **BIG UPDATES**: supports UI customization on both of Android and iOS, supports more image compress format and quality.
* **BREAKING CHANGE**: `ratioX` and `ratioY` are replaced by `aspectRatio`, `circleShape` is replaced by `cropStyle`, removed `toolbarTitle` and `toolbarColor` (these properties are moved into `AndroidUiSettings`)
* iOS: upgrade native library (TOCropViewController v2.5.1)
* Android: upgrade native library (uCrop v2.2.4)
## 1.0.2
* iOS: upgrade native library
* Android: fix bug #40
## 1.0.1
* Android: migrate to AndroidX
* upgrade native libraries
## 1.0.0
* Android: remove deprecated support libraries
* Android: target version to 28
## 0.0.9
* clarify code document
## 0.0.8
* set default value for `circleShape`
## 0.0.7
* support circular cropping
## 0.0.6
* upgrade `TOCropViewController` dependency to v2.3.8
## 0.0.5
* re-config to support Dart2
* fix bug: lock aspect ratio
## 0.0.4
* refactor: change `toolbarColor` type of `int` to `Color`
## 0.0.3
* fix bug: increasing image size after cropping
* add new feature: `toolbarTitle` and `toolbarColor` to customize title and color of copper `Activity`
## 0.0.2
* clarify document
## 0.0.1
* initial release.
