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

Posted 2023-04-24

参考技术A 原文链接： https://yalantis.com/blog/introducing-ucrop-our-own-image-cropping-library-for-android

译者： Eirture

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ucrop onActivityMethod 不起作用

【中文标题】Ucrop onActivityMethod 不起作用

【英文标题】：Ucrop onActivityMethod not working

【发布时间】：2017-01-05 03:38:05

【问题描述】：

我使用了来自 ucrop 库的以下代码，并且裁剪窗口正在显示。

 Uri destinationUri = Uri.fromFile(new File(myContext.getCacheDir(), "IMG_" + System.currentTimeMillis()));
            UCrop.of(sourceUri, destinationUri)
                     .withMaxResultSize(maxWidth, maxHeight)
                    .start(myContext);

但是，控制并没有进入 onActivityResult 方法。如果/否则都不起作用。

@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);
    

知道怎么了，我错过了什么吗？

【问题讨论】：

是否有任何固定比例要裁剪？ 比如 16:9 , 4:3 , 1:1

【参考方案1】：

Uri destinationUri = Uri.fromFile(new File(myContext.getCacheDir(), "IMG_" + System.currentTimeMillis()));
                UCrop.of(sourceUri, destinationUri)
                .withMaxResultSize(1080, 768) // any resolution you want
                .start(mContext, YourFragment/YourActivity.this);

【讨论】：

你拯救了我的一天，tnx

【参考方案2】：

将调用代码更改为以下工作。

    Uri destinationUri = Uri.fromFile(new File(myContext.getCacheDir(), "IMG_" + System.currentTimeMillis()));
    startActivityForResult(UCrop.of(sourceUri, destinationUri)
             .withMaxResultSize(maxWidth, maxHeight)
            .getIntent(getContext()),UCrop.REQUEST_CROP);

【参考方案3】：

我必须通过context 和fragment 所以这就是我在kotlin 中的做法

UCrop.of(sourceFile.toUri(), destinationFile.toUri())
   .withAspectRatio(1.toFloat(), 1.toFloat())
   .start(requireContext(), this)