更新记录

0.1.0（2026-11-11） 下载此版本

• 首次发布。提供鸿蒙全屏图片裁剪、旋转、还原和本地 JPEG 导出。
• 支持 EXIF 方向校正、系统返回取消，以及随窗口变化更新四边安全区。

平台兼容性

uni-app(5.07)

鸿蒙图片裁剪

适用于普通 uni-app Vue 3 鸿蒙 App 的 UTS API 插件。传入本地图片即可打开全屏裁剪器，支持自由矩形裁剪、八个拖动手柄、九宫格、平移缩放、90° 旋转和还原。确认后返回 JPEG 缓存路径和实际像素尺寸。

接入方式

将 uni_modules/lihuiyu-imagecropper 复制到宿主的 uni_modules 下。依赖 @candies/image_cropper@1.1.1 通过插件的 config.json 由 OHPM 安装。按需用 APP-HARMONY 条件编译保护调用。

// #ifdef APP-HARMONY
import { openImageCropper } from '@/uni_modules/lihuiyu-imagecropper'

openImageCropper({
  src: localImagePath,
  success: ({ tempFilePath, width, height }) => {
    console.log(tempFilePath, width, height)
  },
  cancel: () => {},
  fail: ({ errCode, errMsg }) => {
    console.error(errCode, errMsg)
  }
})
// #endif

src 接收宿主可读取的本地图片路径或 URI，可直接传入 uni.chooseImage 返回的路径。第一版导出 JPEG，tempFilePath 是应用缓存文件的绝对路径，宽高单位为像素。需要长期保留时由调用方将文件转存到持久位置。

验证记录

• HBuilderX 5.07 与 DevEco Studio 26.0.0.851 构建成功。生成的 HAP 使用 HarmonyOS SDK 26.0.0.105，目标 API 为 26。
• HarmonyOS 6.0.2（API 22）模拟器通过相册选图、全屏打开、拖动裁剪、90° 旋转、还原、系统返回取消、重新打开和导出预览。另一个普通 uni-app 项目通过复制插件目录完成接入，并验证了带 EXIF Orientation 6 的 JPEG。
• 贴边全图导出在实测中出现过少 1 px 的情况。返回尺寸来自实际导出的图片。
• HarmonyOS 7 真机、双指手感和高清原图的内存表现待验证。

第三方库使用 Apache-2.0 许可证。依赖由 OHPM 安装，许可证随上游包提供。 HarmonyCandies/image_cropper