image_cropper

本项目基于 image_cropper@9.1.0 开发。

1. 安装与使用

1.1 安装方式

进入到工程目录并在 pubspec.yaml 中添加以下依赖：

pubspec.yaml

...

dependencies:
  image_cropper:
    git: 
      url: https://gitcode.com/openharmony-sig/fluttertpc_image_cropper.git
      path: ./image_cropper
      ref: br_v9.1.0_ohos

...

执行命令

flutter pub get

1.2 使用案例

使用案例详见 example

2. 约束与限制

2.1 兼容性

在以下版本中已测试通过

1. Flutter: 3.27.5-ohos-0.0.1; SDK: 5.0.0(12); IDE: DevEco Studio: 5.1.0.828; ROM: 5.1.0.130 SP8;

2.2 权限要求

以下权限中有system_basic 权限，而默认的应用权限是 normal ，只能使用 normal 等级的权限，所以可能会在安装hap包时报错9568289，请参考 文档 修改应用等级为 system_basic

2.2.1在 entry 目录下的module.json5中添加权限

打开 entry/src/main/module.json5，添加：

"requestPermissions": [
  {
   "name": "ohos.permission.INTERNET",
    "reason": "$string:network_reason",
    "usedScene": {
      "abilities": [
        "EntryAbility"
      ],
      "when":"inuse"
    }
  },
]

2.2.2在 entry 目录下添加申请以上权限的原因

打开 entry/src/main/resources/base/element/string.json，添加：

...
{
  "string": [
    {
      "name": "network_reason",
      "value": "使用网络"
    },
  ]
}

3. API

[!TIP] "ohos Support"列为 yes 表示 ohos 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。

Name	return value	Description	Type	ohos Support
Future cropImage(required String sourcePath, int? maxWidth, int? maxHeight, CropAspectRatio? aspectRatio, List<CropAspectRatioPreset> aspectRatioPresets, CropStyle cropStyle = CropStyle.rectangle, ImageCompressFormat compressFormat = ImageCompressFormat.jpg, int compressQuality = 90, List<PlatformUiSettings>? uiSettings)	Future<CroppedFile?>	裁剪图像并获取结果文件	function	yes

4. 属性

Parameters

Name	Description	Type	ohos Support
sourcePath	镜像文件的绝对路径	String	yes
maxWidth	最大裁剪图像宽度	int	yes
maxHeight	最大裁剪图像高度	int	yes
compressQuality	值[0 - 100]用于控制图像压缩的质量	int	yes

CropAspectRatio

Name	Description	Type	ohos Support
CropAspectRatio.ratioX	水平方向的比例	double	yes
CropAspectRatio.ratioY	竖直方向的比例	double	yes

CropAspectRatioPreset

Name	Description	Type	ohos Support
CropAspectRatioPreset.original	原始比例	enum	yes
CropAspectRatioPreset.square	正方形比例	enum	yes
CropAspectRatioPreset.ratio3x2	3*2矩形比例	enum	yes
CropAspectRatioPreset.ratio5x3	5*3矩形比例	enum	yes
CropAspectRatioPreset.ratio4x3	4*3矩形比例	enum	yes
CropAspectRatioPreset.ratio5x4	5*4矩形比例	enum	yes
CropAspectRatioPreset.ratio7x5	7*5矩形比例	enum	yes
CropAspectRatioPreset.ratio16x9	16*9矩形比例	enum	yes

CropStyle

Name	Description	Type	ohos Support
CropStyle.rectangle	矩形	enum	yes
CropStyle.circle	圆形	enum	yes

ImageCompressFormat

Name	Description	Type	ohos Support
ImageCompressFormat.jpg	JPG类型有损压缩	enum	yes
ImageCompressFormat.png	PNG类型无损压缩	enum	yes

CroppedFile

Name	Description	Type	ohos Support
CroppedFile.path	裁剪后文件的完整路径	string	yes
CroppedFile._initBytes	裁剪操作前的原始图像字节数据	Unit8List	yes

PlatformUiSettings

5. 遗留问题

6. 其他

7. 开源协议

本项目基于 BSD-3-Clause ，请自由地享受和参与开源。