# @bsky\.app/expo-image-crop-tool 中文文档

规范地址：https://npmcn.com/package/%40bsky.app/expo-image-crop-tool/

版本：0\.5\.1
npm 元数据更新时间：2026-05-04T12:24:58.640Z
中文译文更新时间：2026-11-08T17:16:44.702Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bsky.app/expo-image-crop-tool
原文对照：https://npmcn.com/package/%40bsky.app/expo-image-crop-tool/?lang=original
项目主页：https://github.com/bluesky-social/expo-image-crop-tool#readme
源码仓库：https://github.com/bluesky-social/expo-image-crop-tool

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：42.3 kB，39 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：expo \*，react \*，react-native \*
- 首次发布：2026-01-06T13:13:01.471Z
- 最新版本发布：2026-05-04T12:24:58.310Z
- 近 30 天下载量：81277（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

用于 Expo 的图像裁剪器

## 安装

```sh
npm install @bsky.app/expo-image-crop-tool
```

也可以使用：`pnpm add @bsky.app/expo-image-crop-tool`、`yarn add @bsky.app/expo-image-crop-tool`、`bun add @bsky.app/expo-image-crop-tool`

## README

# 曝光图像裁剪工具

用于 Expo 的图像裁剪工具, 可以裁剪给定图像 。 可以和图书馆一起使用 `expo-image-picker` 向用户提供更精致的收割经验.

# 在管理下的博览会项目安装

对于 [管理](https://docs.expo.dev/archive/managed-vs-bare/) 展览项目,请遵照 [最近稳定发行的API文档](https://npmcn.com/package/%40bsky.app/expo-image-crop-tool/#readme-api-documentation)。如果跟随链接,而且没有可用的文件,那么这个库在管理的项目中还无法使用——它很可能被包括在即将到来的世博会SDK发布中.

# 在赤裸反应原生项目中安装

对于赤裸反射原住民项目,您必须确保您有 [安装和配置 `expo` 软件包](https://docs.expo.dev/bare/installing-expo-modules/) 在继续之前.

### 将软件包添加到您的 npm 依赖性

```bash
npm install @bsky.app/expo-image-crop-tool
cd ios
pod install
```

> \[注\] 此软件包先前作为 `expo-image-crop-tool`但是现在叫 `@bsky.app/expo-image-crop-tool`。 。 。 .

# 使用量

基本例子见 `example/App.tsx`。 。 。 .

## `openCropperAsync(options: OpenCropperOptions) => Promise<OpenCropperResult>`

`openCropperAsync` 将路径返回到被剪切的图像中,或者如果出错会出错.

## `OpenCropperOptions`

| 密钥 | 类型 | iOS系统 | 机器人 | 说明 |
| --- | --- | --- | --- | --- |
| `imageUri` | `string` | ✅ | ✅ | 要剪切图像的路径 . |
| `shape` | `string` | ✅ | ✅ | 您想要返回图像的形状( E) :`'rectangle'` | `'circle'`) (中文(简体) ). 默认是 `rectangle`。 。 。 . |
| `aspectRatio` | `number` | ✅ | ✅ | 如果您想要强制输出图像的某个特定侧面比 . |
| `format` | `string` | ✅ | ✅ | 输出图像的格式( E)`'png'` | `'jpeg'`) (中文(简体) ). 默认是 `png`。 。 。 . |
| `compressImageQuality` | `number` | ✅ | ✅ | 如果输出出 JPEG 图像, 输出图像的压缩质量 . |
| `rotationEnabled` | `boolean` | ✅ | ✅ | 是否允许用户以 90 度段旋转图像 。 默认是 `true`。 。 。 . |
| `rotationControlEnabled` | `boolean` | ✅ |  | 是否显示旋转控制视图 。 默认是 `true`。 。 。 . |
| `cancelButtonText` | `string` | ✅ | ✅ | 自定义取消按钮的文本 . |
| `doneButtonText` | `string` | ✅ | ✅ | 自定义 Done 按钮的文本 . |

## `OpenCropperResult`

| 密钥 | 类型 | 说明 |
| --- | --- | --- |
| `path` | `string` | 输出图像的路径 |
| `size` | `number` | 以输出图像的字节表示大小 |
| `width` | `number` | 输出图像的宽度 |
| `height` | `number` | 输出图像的高度 |
| `mimeType` | `string` | 输出图像的 MIME 类型 |

## 常见问题

### @bsky\.app/expo-image-crop-tool 是什么？

用于 Expo 的图像裁剪器

### 如何安装 @bsky\.app/expo-image-crop-tool？

在项目目录运行 npm install @bsky\.app/expo-image-crop-tool，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：expo（\*）、react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bsky\.app/expo-image-crop-tool 支持 TypeScript 吗？

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

### @bsky\.app/expo-image-crop-tool 支持 ESM 还是 CommonJS？

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

### @bsky\.app/expo-image-crop-tool 可以商用吗？

@bsky\.app/expo-image-crop-tool 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bsky\.app/expo-image-crop-tool 的下载量有多少？

根据 npm 官方下载统计，@bsky\.app/expo-image-crop-tool 在 2026/10/09 – 2026/11/07 这 30 天内被下载 81,277 次，日均约 2,709 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bsky\.app/expo-image-crop-tool 还在维护吗？

最新版本 0\.5\.1 发布于 2026/05/04（6 个月前）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/01/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。