react-native-image-crop-picker 详解

github react-native-image-crop-picker

文章已更新2018/8/28日 有些问题问的比较多,这里做一个简叙,看客自己决定是否依赖。

1、需要裁剪可以用这个库, 不需要裁剪推荐react-native-image-picker
2、 Android是否支持多选?
笔者试了下小米、魅族、坚果、IOS是可以的。如作者所说,多个选择取决于手机制造商。一些制造商不支持它。这还取决于操作系统版本。尝试长按图片。
3、安装失败、不能运行等问题。移步 issues 很多问题都可以解决。

文章已更新2017/6/19日 如有错误不妥的地方,请及时联系我更正。谢谢

react-native-image-crop-picker是一款注重剪裁,相册单选、多选的第三方框架。在我集成了react-native-image-picker的时候发现,他的剪裁不太友好。作者推荐了这个react-native-image-crop-picker。看到搜索不到该中文的翻译,故此文作为学习总结。

实际效果:


我用的是魅族pro6, 实现和github作者图有点出入, 基本没有自己处理界面,我觉得还是可以接受的。

图1.照相机裁剪旋转.jpg

图2.相册选择.jpg

react-native-image-crop-picker 原文如下:

支持IOS/Android的相机,视频压缩,多个图像选择和裁剪处理。

github效果

Paste_Image.png

Paste_Image.png

使用


导入library
import ImagePicker from 'react-native-image-crop-picker';
从图库中选择

调用单图选择器与裁剪

  ImagePicker.openPicker({
      width: 300, 
      height: 400, 
      cropping: true
   }).then(image => { 
      console.log(image);
   });

选择多个图片的选择器

  ImagePicker.openPicker({
      multiple: true
  }).then(images => {
      console.log(images);
  });

从照相中选择
  ImagePicker.openCamera({
        width: 300, 
        height: 400, 
        cropping: true
  }).then(image => { 
        console.log(image);
  });
裁剪图片
  ImagePicker.openCropper({
    path: 'my-file-path.jpg',
    width: 300,
    height: 400
  }).then(image => {
     console.log(image);
  });
选择清理

模块创建临时文件图像将在未来的某个时间自动清理。 如果要强制清理,可以使用clean清理所有临时文件图像,或者使用cleanSingle(path)清除单个临时文件。

  ImagePicker.clean().then(() => { 
       console.log('removed all tmp images from tmp directory');
  }).catch(e => { 
       alert(e);
  });
请求对象

注:这里希望开发者不清楚的可以自己尝试,看下效果

参数 类型 描述
cropping bool (default false) 是否打开裁剪
width number 与cropping=true一起使用的,裁剪后的宽度
height number 与cropping=true一起使用的,裁剪后的高度
multiple bool (default false) 启用或禁用多个图像选择
includeBase64 bool (default false) 启用或禁用使用图像返回base64数据
cropperActiveWidgetColor (android only string (default "#424242") 裁剪图像时,确定工具栏和其他UX元素的颜色。
cropperStatusBarColor (android only string (default "#424242") 裁剪图像时,决定状态栏StatusBar颜色。
cropperToolbarColor (android only) string (default #424242) 裁剪图像时,决定状态栏Toolbar颜色.
cropperCircleOverlay bool (default false) 裁剪图像时候,是否打开圆形裁剪覆盖(注:我的理解是圆形裁剪框)
maxFiles (ios only) number (default 5) 最多能够选取的文件数,配合multiple=true
waitAnimationEnd (ios only) bool (default true) Promise will resolve/reject once ViewController completion block is called
compressVideo (ios only) bool (default true) 选择视频时,压缩它并将其转换为mp4
smartAlbums (ios only) array (default ['UserLibrary', 'PhotoStream', 'Panoramas', 'Videos', 'Bursts']) (列出可供选择的智能相册)List of smart albums to choose from
useFrontCamera (ios only) bool (default false) 相机打开时是否定义文字字体
compressVideoPreset (ios only) string (default MediumQuality) 选择预设一个视频压缩度
compressImageMaxWidth number (default none) 压缩图像最大宽度
compressImageMaxHeight number (default none) 压缩图像最大高度
compressImageQuality number (default 1) 压缩图片的质量(从0到1,1是最大质量)
loadingLabelText (ios only) string (default "Processing assets...") 图片加载时候文字显示
mediaType string (default any) 选择一个媒体类型 photo/video/any/
showsSelectedCount (ios only) bool (default true) 是否显示选中图片的数量
showCropGuidelines (android only) bool (default true) 裁剪过程中是否显示3x3的网格线
hideBottomControls (android only) bool (default false) 是否展示底部控件
enableRotationGesture (android only) bool (default false) 是否可以通过手势来旋转图像。
返回对象
参数 类型 描述
path string 选中文件的位置
width number 选中文件的宽度
height number 选中文件的高度
mime string 选中图片的MIME类型(image/jpeg, image/png)
size number 所选图像大小(以字节为单位)
data base64 (选择文件以base64表示)Optional base64 selected file representation

安装


npm i react-native-image-crop-picker --save
react-native link react-native-image-crop-picker
安装后步骤

iOS (IOS没了解,暂时没有去进行翻译)

cocoapods users
    Add platform :ios, '8.0'to Podfile (!important)
    Add pod 'RSKImageCropper' and pod 'QBImagePickerController'to Podfile

non-cocoapods users
     Drag and drop the ios/ImageCropPickerSDK folder to your xcode project. (Make sure    
     Copy items if needed IS ticked)
     Click on project General tab
          Under Deployment Info set Deployment Target to 8.0
          Under Embedded Binaries click + and add RSKImageCropper.framework  and 
             QBImagePicker.framework

Android

  • 保证你使用了 Gradle 2.2.x 以上 (project build.gradle)
buildscript {
    ...
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
        ...
    }
    ...
}
  • app build.gradle 中添加useSupportLibrary
  android {
    ...

    defaultConfig {
        ...
        vectorDrawables.useSupportLibrary = true
        ...
    }
    ...
}
  • [可选] 如果使用照相机在你的项目中, AndroidManifest.xml添加
<uses-permission android:name="android.permission.CAMERA"/>

构建

Android:
不需要其他操作

iOS

 cocoapods users
      你已经完成,不需要其他的操作;
 non-cocoapods users
     If you are using pre-built frameworks from ios/ImageCropPickerSDK
     , then before deploying app to production you should strip off simulator 
     ARCHs from these, or you can add frameworks 
     from Libraries/imageCropPicker/Libraries/_framework_name_.
     xcodeproj/Products/_framework_name_.framework
     to Embedded Binaries instead of pre-built ones. Related 
     issue: [https://github.com/ivpusic/react-native-image-crop-
     picker/issues/61](https://github.com/ivpusic/react-native-image-crop-
     picker/issues/61).

Details for second approach:
     1.  Remove the pre-built frameworks from Embedded Binaries
     2.  Build for Device
     3.  Add the newly built binaries for both frameworks to Embedded Binaries (located at Libraries/imageCropPicker/Libraries/_framework_name_.xcodeproj/Products/_framework_name_.framework)  

许可

MIT

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,069评论 4 358
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,212评论 1 287
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 105,912评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,424评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,741评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,194评论 1 206
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,553评论 2 307
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,289评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,923评论 1 237
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,251评论 2 240
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,775评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,144评论 2 249
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,698评论 3 228
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,936评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,658评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,214评论 2 267
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,159评论 2 258

推荐阅读更多精彩内容