【译】uCrop介绍 —— 我们自己的Android图片裁剪库

我们在 Yalantis 开发了许多不同的 Android 应用，经验告诉我们，几乎在所有的应用中，都需要图片裁剪的功能。图片裁剪的用途很广，从简单的用户头像调整到图片的比例裁剪、灵活变换等各种复杂的处理。

我们想为所有的用户提供最好的图片处理工具，所以决定创建Android的图片裁剪库 uCrop 。可以在 Product Hunt 上为 uCorp 投票。

也许你会好奇，为什么我们不使用现成的 Android 图片裁剪解决方案。毕竟，可以在 Github 或者 Android Arsenal 上找到很多这类的库。但是问题是，那些解决方案都不满足我们的需求。我们来看一些主流的开源图片裁剪库，为什么不符合我们的需求。

为什么其它的开源库不好用

SoundCloud 裁剪库

我在几个项目里面使用了 SoundCloud 库很成功，但是仍然有几个问题让我很头痛。

首先，你操作的是一个裁剪的框，而不是图片本身。当需要裁剪一个很小面积的图片时，这会你感觉有点痛苦。这是与用户使用习惯向悖的。我确信 Instagram 传授给我们的是一些优秀的 UX (用户体验)，可以移动的裁剪框也已经灭绝了。

其次，SoundCloud 裁剪库不允许用户旋转图片。Come on, guys! 所有人都知道，有成百上千“不可思议”的安卓手机给照片设置了错误的EXIF信息（谢天谢地，我们有 CWAC 来清理这个烂摊子）。而且，很大部分的用户是希望能够转动图片的（不仅仅是 90 度）。

最后同样重要的一点，使用 SoundCloud 库不能改变长宽比。当然，如果你使用它仅仅是需要获取一个方形的头像，那没有任何问题。但是，其它很多很有趣的头像形状，用这个库无法实现。
Edmodo Cropper

Edmodo Cropper 与 SoundCloud 库非常相似，缺点也同样相似。不过，这个库支持动态的改变裁剪框的长宽比。它也有参考线和一种旋转图片的方式（仅仅只有一种方式，所以你需要想办法解决手势检测或是一些控件来控制自己的手势）。
Scissors

Scissors 是一个新的库，不久前我在一个安卓问题周刊上看到它的时候特别激动。但 5 分钟内我的兴奋就消失了。引用一句关于 Scissors 的博文：

…我们研究了现有的库。都不符合我们的需求，因此我们决定构建自己库。

这确实是一个值得称赞的方法。实际上，我们找到又是一个不能旋转图片，也不能动态调整宽高比的库。尽管 Scissors 集成了一些主流的图片加载库，像 Picasso, Glide 以及 Universal Image Loader。希望 Scissors 在后续的版本中有更多实用的功能。

分析完这些现有库的缺点，我们决定创建自己的库，支持手势并且有一个良好的 UX。

uCrop：一个解决图片裁剪问题的库

安卓库 uCrop 允许你修剪图片来更好的使用。uCrop 重要的特性如下：

缩放图片
旋转图片
改变裁剪长宽比例
支持出手势：一根指头滑动图片，两根指头旋转图片，捏拉缩放，双击缩放。
上手即可用的 Activity 功能设计，精巧的控件实现更精确的图片旋转和缩放，以及一组通用的预设长宽比（1:1，4:3，3:4，2:3，3:2，16:9，9:16 + 图片原始比例）。

uCrop 有一个初始化的构建类型接口，来为你的应用配置一些适当的属性。uCrop 库最低的版本要求是 API 10，示例应用工作的版本是 API 15+ 。

如何在你的项目中使用 uCrop ?

添加 uCrop 库依赖作为本地项目库。

1	compile 'com.yalantis:ucrop:[latest version]'

使用构造者模式来创建 uCrop 及配置。

UCrop.of(sourceUri, destinationUri)
  .withAspectRatio(16, 9)
  .withMaxResultSize(maxWidth, maxHeight)
  .start(context);

覆写 onActivityResult 方法来捕获 uCrop 返回数据。

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    if (resultCode == RESULT_OK && requestCode == UCrop.REQUEST_CROP) {
        final Uri resultUri = UCrop.getOutput(data);
    } else if (resultCode == UCrop.RESULT_ERROR) {
        final Throwable cropError = UCrop.getError(data);
    }
}

如何自定义 uCrop

你可以改变下面这个设置：

压缩格式 (e.g. PNG, JPEG, WEBP)。
压缩的质量[0 - 100] (PNG 是无损的，会忽略质量设置)
支持并发的手势
Bitmap 最大的尺寸是从 Uri 中解码来的，并且同样会在裁剪的视图中。(如果你想覆盖默认的属性)
更多(e.g. color palette)

在下一篇文章中，将会展示我们构建 uCrop 的经历，敬请关注！

原文：Introducing uCrop, Our Own Image Cropping Library for Android

为什么其它的开源库不好用

uCrop： 一个解决图片裁剪问题的库

如何在你的项目中使用 uCrop ?

如何自定义 uCrop

uCrop：一个解决图片裁剪问题的库