Skip to content

一个支持多选、选原图和视频的图片选择器,同时有预览、裁剪功能,支持iOS6+。 A clone of UIImagePickerController, support picking multiple photos、original photo、video, also allow preview photo and video, support iOS6+

License

Notifications You must be signed in to change notification settings

cochat/TZImagePickerController

 
 

Repository files navigation

TZImagePickerController

A clone of UIImagePickerController, support picking multiple photos、original photo、video, also allow preview photo and video, fitting iOS6789 system.
一个支持多选、选原图和视频的图片选择器,同时有预览功能,适配了iOS6789系统。

关于升级iOS10和Xcdoe8的提示: 在Xcode8环境下将项目运行在iOS10的设备/模拟器中,访问相册和相机需要额外配置info.plist文件。分别是Privacy - Photo Library Usage Description和Privacy - Camera Usage Description字段,详见Demo中info.plist中的设置。

  1. 当前最新版本1.6.5. 修复和优化了若干bug,新增单选模式、可自定义每行展示照片个数和支持了国际化,目前支持中文和英文两种语言。
  2. 如果发现pod search TZImagePickerController 搜索出来的不是最新版本,需要在终端执行cd转换文件路径命令退回到Desktop,然后执行pod setup命令更新本地spec缓存(可能需要几分钟),然后再搜索就可以了.
  3. 如果发现了bug请提一个issue,请尽可能详细地描述系统版本、手机型号和复现步骤等信息,当然最好能先更新到最新版再测试一下,许多旧版本存在的一些问题在新版本上已经解决了~

image image image

一. Installation 安装

  • CocoaPods:pod 'TZImagePickerController'
  • 手动导入:将TZImagePickerController文件夹拽入项目中,导入头文件:#import "TZImagePickerController.h"

二. Example 例子

TZImagePickerController *imagePickerVc = [[TZImagePickerController alloc] initWithMaxImagesCount:9 delegate:self];

// You can get the photos by block, the same as by delegate.
// 你可以通过block或者代理,来得到用户选择的照片.
[imagePickerVc setDidFinishPickingPhotosHandle:^(NSArray<UIImage *> *photos, NSArray *assets) {

}];
[self presentViewController:imagePickerVc animated:YES completion:nil];

三. Requirements 要求

iOS 6 or later. Requires ARC
iOS6及以上系统可使用. ARC环境.

When system version is iOS6 or iOS7, Using AssetsLibrary.
When system version is iOS 8 or later, Using PhotoKit.
如果运行在iOS6或7系统上,用的是AssetsLibrary库获取照片资源。
如果运行在iOS8及以上系统上,用的是PhotoKit库获取照片资源。

四. More 更多

If you find a bug, please create a issue.
Welcome to pull requests.
More infomation please view code.
如果你发现了bug,请提一个issue。
欢迎给我提pull requests。
更多信息详见代码,也可查看我的博客: 我的博客

2016.5.23更新: 刚刚更新了代码,现在版本更新到了1.4.5,新增了一些新功能,比如:在照片列表页新增了拍照按钮,可以全局记录哪个相册已选中了多少张图片,预览控制器可以在外界打开。同时Demo页面也做了一些优化,可以直接删除选中的照片、可以对照片进行长按排序等。当然期间也修复了许多小bug,表现更加好了。

最值得一提的是,1.4.5版本的性能大幅提升了,在我的iOS9.3.2系统6s设备上(870张照片),平均滑动帧数在58左右,滑动十分流畅,在iOS7.0.4的4s设备上(124张照片),平均滑动帧数在57左右,也十分流畅。经过对比,和QQ的图片选择器滑动帧数表现基本一致,都十分流畅,同时都强于微信的图片选择器。微信的图片选择器,在快速滑动的时候明显感到有一丝卡顿,通过Core Animation查看发现,微信的图片选择器在我的6s设备下帧数平均约52左右,好几次甚至低于50,在4s设备上则表现更糟一些。下面贴上帧数测试截图,大家也可以测试一下~(测试截图请去博客查看~)

tip: 如果你用的是老版本,建议你更新到新版,特别是需要适配iOS7甚至6的应用,因为旧版本在iOS7和6下性能比较糟糕...

2016.6.22更新: 刚刚更新了代码,现在版本更新到了1.5.0。更新如下: 1.可把拍照按钮放在外面了,可以设置弹出一个sheet提示用户选择相册或相机; 2.新增了sortAscendingByModificationDate属性,默认为YES,设置为NO时,照片会按修改时间降序,拍照按钮会在第一个; 3.优化了Demo页面的UI,新增6个开关控件,可方便地更改各个设置来打开选择器; 4.修复了若干bug;

最近更新: 1.7.7 支持GIF图片的播放和选择 1.7.6 支持对共享相册和同步相册的显示 1.7.5 允许不进入预览页面直接选择照片 1.7.4 支持单选模式下裁剪照片,支持任意矩形和圆形裁剪框 1.7.3 优化iCloud照片的显示与选择

About

一个支持多选、选原图和视频的图片选择器,同时有预览、裁剪功能,支持iOS6+。 A clone of UIImagePickerController, support picking multiple photos、original photo、video, also allow preview photo and video, support iOS6+

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 99.7%
  • Ruby 0.3%