Flutter图片裁剪接口插件 native_image_cropper_platform_interface 的使用

native_image_cropper_platform_interface 是一个用于 native_image_cropper 插件的公共平台接口。它允许 native_image_cropper 插件的不同平台实现（如 Android、iOS）遵循相同的接口规范。

使用方法

要实现一个新的平台特定的 native_image_cropper 实现，您需要扩展 NativeImageCropperPlatform 类，并在注册插件时通过调用 NativeImageCropperPlatform.instance = MyPlatformNativeImageCropper() 来设置默认的 NativeImageCropperPlatform。

示例代码

以下是一个完整的示例 demo，展示了如何使用 native_image_cropper_platform_interface 插件来裁剪图片。

1. 创建自定义的 NativeImageCropperExample 类

import 'package:flutter/services.dart';
import 'package:native_image_cropper_platform_interface/native_image_cropper_platform_interface.dart';

final class NativeImageCropperExample extends NativeImageCropperPlatform {
  final MethodChannel _methodChannel =
      const MethodChannel('biz.cosee/native_image_cropper_android');

  static void registerWith() =>
      NativeImageCropperPlatform.instance = NativeImageCropperExample();

  @override
  Future<Uint8List> cropRect({
    required Uint8List bytes,
    required int x,
    required int y,
    required int width,
    required int height,
    ImageFormat format = ImageFormat.jpg,
  }) async {
    final arguments = {
      'bytes': bytes,
      'x': x,
      'y': y,
      'width': width,
      'height': height,
      'imageFormat': format.name,
    };
    try {
      final croppedImage =
          await _methodChannel.invokeMethod<Uint8List>('cropRect', arguments);
      if (croppedImage == null) {
        throw const NativeImageCropperException(
          'NullPointerException',
          'Method channel cropRect() returns null!',
        );
      }
      return croppedImage;
    } on PlatformException catch (e) {
      throw NativeImageCropperException(e.code, e.message);
    }
  }

  @override
  Future<Uint8List> cropOval({
    required Uint8List bytes,
    required int x,
    required int y,
    required int width,
    required int height,
    ImageFormat format = ImageFormat.jpg,
  }) async {
    final arguments = {
      'bytes': bytes,
      'x': x,
      'y': y,
      'width': width,
      'height': height,
      'imageFormat': format.name,
    };
    try {
      final croppedImage =
          await _methodChannel.invokeMethod<Uint8List>('cropOval', arguments);
      if (croppedImage == null) {
        throw const NativeImageCropperException(
          'NullPointerException',
          'Method channel cropOval() returns null!',
        );
      }
      return croppedImage;
    } on PlatformException catch (e) {
      throw NativeImageCropperException(e.code, e.message);
    }
  }
}

2. 注册自定义的 NativeImageCropperExample 实现

在应用启动时，您需要注册您的自定义实现：

void main() {
  NativeImageCropperExample.registerWith();
  runApp(MyApp());
}

3. 使用 NativeImageCropperPlatform 进行图片裁剪

您可以使用 NativeImageCropperPlatform.instance 来调用裁剪方法：

Future<void> _cropImageRect() async {
  final Uint8List imageData = // 获取图片数据，例如从文件或网络加载
  try {
    final Uint8List croppedImage = await NativeImageCropperPlatform.instance.cropRect(
      bytes: imageData,
      x: 0,
      y: 0,
      width: 100,
      height: 100,
    );
    // 处理裁剪后的图片数据
  } catch (e) {
    print('Error cropping image: $e');
  }
}

Future<void> _cropImageOval() async {
  final Uint8List imageData = // 获取图片数据，例如从文件或网络加载
  try {
    final Uint8List croppedImage = await NativeImageCropperPlatform.instance.cropOval(
      bytes: imageData,
      x: 0,
      y: 0,
      width: 100,
      height: 100,
    );
    // 处理裁剪后的图片数据
  } catch (e) {
    print('Error cropping image: $e');
  }
}

注意事项

• 避免破坏性变更：强烈建议优先考虑非破坏性变更（如添加新方法），而不是对现有接口进行破坏性变更。
• 参考文档：关于为什么更倾向于不那么干净的接口而不是破坏性变更，请参阅 Flutter 平台接口破坏性变更讨论。

通过上述步骤，您可以成功地使用 native_image_cropper_platform_interface 插件来实现图片裁剪功能。