HarmonyOS 鸿蒙Next 开源第三方组件——uCrop_ohos图片裁剪组件

HarmonyOS 鸿蒙Next 开源第三方组件——uCrop_ohos图片裁剪组件 前言

基于安卓平台的图片裁剪组件uCrop（ https://github.com/Yalantis/uCrop），实现了鸿蒙化迁移和重构。目前代码已经开源到（https://gitee.com/isrc_ohos/u-crop_ohos），欢迎各位下载使用并提出宝贵意见！

背景

uCrop组件是开源的图片裁剪库，支持对图片的缩放和裁剪等操作，是安卓平台比较受欢迎的组件，在Github上已有1万多个Star和近2千个Fork。uCrop组件具有封装程度高、使用流畅、自定义程度高的优点，被广泛应用于多种APP中。

组件效果展示

安卓和鸿蒙UI组件的差异较大，uCrop_ohos的实现完全重构了安卓版uCrop的UI部分，所以uCrop_ohos的组件效果看上去会和uCrop完全不同。

本组件的效果展示可分为两个步骤：图片选择和图片裁剪。下面依次对其进行讲解和展示。

1、uCrop_ohos图片选择

uCrop_ohos支持裁剪系统选择相册图片或网络图片，用户可以在主菜单中选择对应的功能，如图1所示。

图 1 主菜单界面

（1）uCrop_ohos读取相册图片

当用户赋予组件相应权限后，uCrop_ohos可以自动读取手机相册中每一张图片，并将它们的缩略图作为一个列表呈现在UI界面上，用户可以上下滑动列表寻找目标图片，如图2所示。当用户点击某张缩略图时，会跳转到uCrop_ohos的裁剪界面，执行后续操作。

图 2 选择系统相册图片

（2）uCrop_ohos读取网络图片

用户需要将图片网址键入到输入框内并点击确定按钮，如图3所示。uCrop_ohos会自动下载图片并跳转到裁剪界面，执行后续操作。

图 3 选择网络图片

2、uCrop_ohos图片裁剪

图4 uCrop_ohos的裁剪界面

图4是uCrop_ohos的裁剪界面。使用者可以通过手势对图片进行缩放、旋转和平移的操作，也可以通过按钮、滑块等控件进行相应操作。将图片调整至满意状态时，点击裁剪按钮即可获得裁剪后的新图片，并将其保存至手机相册。且本组件的图片与裁剪框具有自适应能力，能够保证裁剪框时刻在图片范围内，防止由于裁剪框的范围大于图片导致的一系列问题。

Sample解析

图5 Sample的工程结构

uCrop_ohos的核心能力都由其Library提供，Sample主要用于构建UI，并调用Library的接口。从图5可以看出Sample的工程结构较为简单，主要由4个文件构成，下面进行详细的介绍。

1、CropPicture

CropPicture文件提供了裁剪界面，其最主要的逻辑是通过图片Uri实例化Library中UCropView类。由于uCrop_ohos的逻辑是先将用户选择的原图创建一个副本，然后对副本执行裁剪，所以为了将图片传入UCropView需要两个Uri：一个名为uri_i，从intent中获得，标识的是用户选择的原图，可以是本地图片也可以是网络图片；另一个名为uri_o，标识的是原图副本，一定是一张本地图片。