image_cropper

fix bug and bump version

• iOS:

• upgrade TOCropViewController to v3.1.1 (new Liquid Glass UI)
• support UISceneDelegate #608

• Android: fix Android release build compile error #599

• 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)

• 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)

• correct README document for Android (removed workaround note because uCrop now fully supports edge-to-edge feature)

• Web: fix bug on Flutter WASM #567
• Android: fix deprecated API #546

• iOS: add support for Swift Package Manager (PR #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

<resources>
  ....
  <style name="Ucrop.CropTheme" parent="Theme.AppCompat.Light.NoActionBar"/> <!--add this line-->
</resources>

• Create new file android/app/src/main/res/values-v35/styles.xml and add the following code to it:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <style name="Ucrop.CropTheme" parent="Theme.AppCompat.Light.NoActionBar">
      <item name="android:windowOptOutEdgeToEdgeEnforcement">true</item>
  </style>
</resources>

• Modify the decleration of UCropActivity in your AndroidManifest.xml (if you have not modified it yet)

<activity
  android:name="com.yalantis.ucrop.UCropActivity"
  android:screenOrientation="portrait"
  android:theme="@style/Ucrop.CropTheme"/> <!--this line is updated-->

• Android: workaround edge-to-adge issue on Android 15

  Before:

    <activity
      android:name="com.yalantis.ucrop.UCropActivity"
      android:screenOrientation="portrait"
      android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>
  

  After:

    <activity
      android:name="com.yalantis.ucrop.UCropActivity"
      android:screenOrientation="portrait"
      android:theme="@style/Ucrop.CropTheme"/> <!-- This line is updated -->
  

• Android: fix deprecated API
• web: correct constraints of flutter version (>=3.22.0)

• use >=0.5.0 < 2.0.0 version range for package:web

• 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

• upgrade platform_interface dependency
• increase Dart SDK constraints (>=3.3.0)
• Android: Removes references to Flutter v1 android embedding classes.

• Web: support config type of output image (jpg or png)

• Web: update dependencies

• Web: improve cropper UI

• Web:
  • fix bug cropper not get correct container's size
  • improve cropper UI
• correct document

• correct document

• 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***:
```
<head>
    ....

    <!-- Croppie -->
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/croppie/2.6.5/croppie.css" />
    <script defer src="https://cdnjs.cloudflare.com/ajax/libs/exif-js/2.3.0/exif.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/croppie/2.6.5/croppie.min.js"></script>

    ....
</head>
```

***After***:
```
<head>
    ....

    <!-- cropperjs -->
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/cropperjs/1.6.2/cropper.css" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/cropperjs/1.6.2/cropper.min.js"></script>

    ....
</head>
```

• Android: upgrade uCrop to v2.2.9
• iOS: upgrade TOCropViewController to v2.7.3
• web: upgrade js to v0.7.1

• Android: improve compression quality

• upgrade http to v1.0.0

• refactor CHANGELOG

• Android: support namespace, Gradle 8

• iOS: bump ios minimum version to 11

• Web: fix web translation issue

• Android: replace jcenter by mavenCentral
• Web: support localization

• 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

WebUiSettings(
  boundary: Boundary(
    width: 520,
    height: 520,
  ),
  viewPort: ViewPort(width: 480, height: 480, type: 'circle'),
)

AFTER

WebUiSettings(
  boundary: const CroppieBoundary(
    width: 520,
    height: 520,
  ),
  viewPort: const CroppieViewPort(width: 480, height: 480, type: 'circle'),
)

• correct importing JS library

• update document

• fix missing pubspec config on web

• 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

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

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',
        )
      ],
    );

• support rotate image on Web

• correct missing README document about Web support.

• BREAKING CHANGE: update result models to support web, replace File by CroppedFile

• 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

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

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',
        )
      ],
    );

• update README to introduce Web support experiment

• Upgrade uCrop to v2.2.8
• Upgrade TOCropViewController to v2.6.1
• PR: #309, #229, #294, #258, #251
• BREAKING CHANGE: change cropImage() to instance method

• Upgrade uCrop to v2.2.7

• Upgrade TOCropViewController to v2.6.0
• Migrate to nullsafety

• Upgrade uCrop to v2.2.6
• Fix bug: image compress file format (png)

• Update pubspec to new format
• Upgrade TOCropViewController to v2.5.4

• Android: fix bug

• Android: upgrade uCrop to v2.2.5
• BREAKING CHANGE: remove activeWidgetColor from AndroidUiSettings

• iOS: add more UI customization properties (title, initRect)
• update Flutter version constraint (>= v1.12.13)

• Android: migrate to embedding v2

• Android: fix bug crashing on Flutter v1.12.13

• Android: upgrade gradle version
• iOS: remove static_framework Pod configuration, upgrade TOCropViewController to 2.5.2

• 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)

• iOS: upgrade native library
• Android: fix bug #40

• Android: migrate to AndroidX
• upgrade native libraries

• Android: remove deprecated support libraries
• Android: target version to 28

• clarify code document

• set default value for circleShape

• support circular cropping

• upgrade TOCropViewController dependency to v2.3.8

• re-config to support Dart2
• fix bug: lock aspect ratio

• refactor: change toolbarColor type of int to Color