HarmonyOS第三方组件——鸿蒙图片裁剪组件ohos-Image-Cropper

本文链接：https://blog.csdn.net/VincenZsw/article/details/113392390

ohos-Image-Cropper是基于HarmonyOS的图片裁剪组件，移植自Android-Image-Cropper，提供图片裁剪、旋转、翻转等功能。文章介绍了Sample的使用方法，包括如何跳转至功能选择界面、获取裁剪图片等，并详细解析了Library的实现原理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言

基于安卓的平台的图片裁剪组件（https://github.com/ArthurHub/Android-Image-Cropper），实现了鸿蒙平台的迁移和重构，代码已经开源到（https://gitee.com/isrc_ohos/android-image-cropper_ohos），欢迎各位开发者下载使用并提出宝贵意见~

背景

ohos-Image-Cropper组件是个简单、灵活、高效的图片裁剪工具，支持图片在裁剪前进行裁剪框移动、旋转、翻转（水平、垂直）的操作，并将最终裁剪结果反馈给用户。

Sample解析

在Sample中，向用户提供了三个界面，分别是：初始界面、功能选择界面、效果展示界面。初始界面包含一个按钮，点击可进入功能选择界面。功能选择界面可对图片进行裁剪、旋转、水平翻转、垂直翻转等操作。当用户选择图片裁剪功能时，会跳转到效果展示界面，展示裁剪后的图片。

1. 如何跳转至功能选择界面？

CropImage是个工具类，可以实现页面跳转功能。此处可以将下面代码放入Button按钮的点击事件中，执行下面代码可以实现从用户的初始界面跳转至功能选择界面。

CropImage.activity()  //初始化CropImage类         
    .setContext(this)//设置上下文               
    .setSource(ResourceTable.Media_baochi)//传入被裁减图片的ID         
    .setBundleName("com.huawei.mytestproject")//传入包名         
    .setAbilityName("com.huawei.mytestproject.MainAbility")//传入类名         
    .setRequset_code(1234)//请求参数设置         
    .start(super.getAbility(),this);//启动跳转

关于上代码有三点需要注意，一是：为了方便大家使用模拟器运行Sample，被裁减图片使用在鸿蒙的资源管理器ResourceTable中注册过的图片。图片需放在APP项目资源文件夹resource/base/media下面，ResourceTable会扫描资源文件夹，并为每个资源注册一个int型的数值作为资源id。图1展示了图片所在位置，图二展示了图片在ResourceTable中的注册。二是：代码中传入的包名和类名是用于指定图片裁剪后返回的Ability（即效果展示界面）。三是：被裁减图片必须为正方形。

图1. 被裁减图片存放位置

图2. 被裁减图片在ResourceTable中的注册

2. 如何跳转至效果展示界面？

当裁剪完毕时，会根据用户提供的包名和类名跳转至效果展示界面，来展示裁剪后的图片。具体使用代码参照如下：

//裁剪方法 
private void crop(Intent intentOriginal) 
{ ...     
    Intent intent = new Intent(); ...     
    Operation operation = new Intent.OperationBuilder()             
        .withDeviceId("")            //指定图片裁剪后返回的Ability包名和类名             
        .