@exodus/image-editor

中文文档
2.3.0-exodus.2发布于 2026/04/27MITTypeScriptCommonJS零依赖近 30 天下载 6357

为 iOS & Android 执行本地图像编辑本地模块

中文使用文档
文档目录7 节
  1. 开始
  2. 安装
  3. 安装布德
  4. 链接
  5. 使用量
  6. 裁剪图像
  7. 裁剪数据

反应-内生-图像编辑器

React Industrial 的图像编辑器本地模块 .

Build Status Version MIT License PRs Welcome Lean Core Badge

开始

安装

yarn add @react-native-community/image-editor

或者说

npm install @react-native-community/image-editor --save

安装布德

npx pod-install

react-native link @react-native-community/image-editor

使用量

从导入库开始 :

import ImageEditor from "@react-native-community/image-editor";

裁剪图像

裁剪 URI param 指定的图像 。 如果URI指向远程图像,则会自动被下载. 如果图像无法装入/下載,则承诺会被拒绝.

如果裁剪过程成功,由此产生的裁剪图像会被存储在缓存路径中,而URI在承诺中返回会指向缓存路径中的图像. 记住在完成时从缓存路径中删除剪接的图像 .

  ImageEditor.cropImage(uri, cropData).then(url => {
    console.log("Cropped image uri", url);
  })

裁剪数据

财产需求说明
offset对剪接图像的左上角, 在原始图像的坐标空间中指定
size对剪切图像的大小( dimensions)
displaySize没有要缩放已裁剪的图像的大小
resizeMode没有缩放图像时调整模式的大小( iOS, 机器人缩放模式总是“ 覆盖 ”) 默认值:"夹"
  cropData = {
    offset: {x: number, y: number},
    size: {width: number, height: number},
    displaySize: {width: number, height: number},
    resizeMode: 'contain' | 'cover' | 'stretch',
  };

更高级的用途检查我们 示例应用程序。 。 。 .

版本与发布记录

@exodus/image-editor 共发布 3 个版本,首次发布于 2021/09/27;过去 12 个月发布了 1 个版本。

版本发布日期距今
2.3.0-exodus.2latest2026/04/276 个月前
2.3.0-exodus.12021/11/294 年前
2.3.12021/09/275 年前

关于 @exodus/image-editor 的常见问题

@exodus/image-editor 是什么?

为 iOS & Android 执行本地图像编辑本地模块

如何安装 @exodus/image-editor?

在项目目录运行 npm install @exodus/image-editor,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=16.0)、react-native(>=0.57 <0.65)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@exodus/image-editor 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@exodus/image-editor 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@exodus/image-editor 可以商用吗?

@exodus/image-editor 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@exodus/image-editor 的下载量有多少?

根据 npm 官方下载统计,@exodus/image-editor 在 2026/10/14 – 2026/11/12 这 30 天内被下载 6,357 次,日均约 212 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@exodus/image-editor 还在维护吗?

最新版本 2.3.0-exodus.2 发布于 2026/04/27(6 个月前);至今共发布 3 个版本,其中过去 12 个月发布了 1 个;首次发布于 2021/09/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。