grabKit 1.4

grabKit 1.4

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
发布上次发布2014年12月

未声明 维护。



 
依赖项
Facebook-iOS-SDK~> 3.2.0
ISO8601DateFormatter~> 0.6
MBProgressHUD~> 0.6
NVUIGradientButton~> 1.3.0
objectiveflickr~> 2.0.2
 


  • Pierre-Olivier Simonard

GrabKit

GrabKit 为 iOS 提供了一个易于使用的组件,可轻松从社交网络导入照片。

GrabKit 允许您从以下网络或应用中检索照片:

  • Facebook
  • FlickR
  • Picasa
  • Instagram
  • iPhone/iPad
  • ... 更多即将到来

摘要

在您的 iPhone/iPad 应用中,您可能希望让用户访问托管在各种社交网络上(如 Facebook 或 FlickR)的照片相册或设备上存储的照片。不幸的是,提供这些图像的网站提供了不同的 API 和不同的库来验证用户、提取其相册等。

GrabKit 被设计用来将这些差异包装成

  • 一个简单的库:GrabKitLib
  • 一个基于 GrabKitLib 的简单易用的组件:GrabKitPicker

GrabKitPicker 对开发者 友好

  • 兼容 iOS 5.1 及更高版本,适用于 iPhoneiPad,GrabKitPicker 已经与您的项目兼容。
  • 安装并配置后,您只需在 iPhone 上以模态方式展示,或在 iPad 上通过弹出菜单展示即可。
  • 易于使用,GrabKitPicker 提供了两个主要类:GRKPickerViewController 和其代理 GRKPickerViewControllerDelegate
  • 通过其代理协议,您可以轻松处理用户的交互。
  • 易于自定义,它将适应到您应用程序的设计中。
  • 当然,GrabKitPicker 使用 ARC,并包含丰富的文档和注释。

GrabKitPicker 也是 用户友好

  • 目前已翻译为法语和英语,但很快将翻译成其他语言。请随时提供帮助! :)
  • 默认界面简单易用,虽然经过严格测试,但仍能提供尽可能最佳的用户体验。

screenshot of the demo application
在 YouTube 上观看此演示:http://www.youtube.com/watch?v=6sOgy_3P4Ws

演示应用程序

探索 GrabKit 的强大功能,最佳方式是运行演示应用程序。只需几个步骤即可运行它,请根据 wiki 中的详细说明 操作。

如何在您的应用程序中使用 Grabkit

安装

要安装和设置 GrabKit 到您的项目中,请遵循 wiki 的详细说明

配置

为了从每个服务中抓取内容,您需要为您的应用程序在每个服务中注册并获取一个API密钥。

请参照wiki中的详细说明

在您的代码中添加GrabKitPicker

从您应用程序中的任何UIViewController,您只需要做的是类似这样

// Retrieve the singleton of GrabKitPicker
GRKPickerViewController * grabkitPickerViewController = [GRKPickerViewController sharedInstance];

// Set the picker's delegate. 
// Don't forget to add GRKPickerViewControllerDelegate in the list of protocols implemented by your controller.
grabkitPickerViewController.pickerDelegate = self;

 // We allow the selection 
grabkitPickerViewController.allowsSelection = YES;
grabkitPickerViewController.allowsMultipleSelection = YES;

[self presentViewController:grabkitPickerViewController animated:YES completion:^{
    // GrabKitPicker is now displayed        
}];

在iPad上,您可以在picker上调用此方法,通过UIPopover显示它

[grabkitPickerViewController presentInPopoverFromBarButtonItem:sender permittedArrowDirections:UIPopoverArrowDirectionAny animated:YES];

然后,在您的控制器中实现所需的代理方法。picker被取消时调用的代理方法,传入的是用户选择的图片数组,如下所示

-(void)picker:(GRKPickerViewController*)picker didDismissWithSelectedPhotos:(NSArray*)selectedPhotos {

    // selectedPhotos is an NSArray of GRKPhoto objects. Check the "Model" section below for more details.

}

模型

  • GRKAlbum 表示一个 照片专辑。此对象具有以下属性

    • albumId:专辑的id,由服务返回。
    • count:专辑中的照片总数,根据服务信息。
    • name:专辑的名称。
    • coverPhoto:一个代表专辑封面照片的 GRKPhoto 实例
  • GRKPhoto 表示一张 照片。它有一个 name(照片标题)、一个 caption(其描述)。一个 GRKPhoto 包含多个 图片,代表照片的不同大小。

  • 一张 图片 是一个 GRKImage 实例。它有一个 width(宽度)、一个 height(高度)、一个 URL,如果一个标志(isOriginal)设置为 YES,如果这张图片是用户上传的原始图片。

即将推出

  • 更多的测试和示例
  • 更多服务
  • 更多可抓取的内容

欢迎您帮助我们做出贡献!

GrabKit v1.3 更改

常见问题(FAQ)

所有问题都有答案。

使用GrabKit的应用程序

多个顶级应用使用GrabKit,如:

  • XnSketch:将您的照片转换成绘画,卡通或速写图像,一键创建即时艺术作品。
  • 1sleeve:1sleeve是一个酷炫创新的应用程序,用于设计、定制、个性化并在iPad,iPad mini和macbookAir 11"和13"上购买您自己的外壳。
  • Printzel:几分钟内创建优雅的相册!

捐赠

GrabKit是**100%免费**。但是,开发和维护此项目需付出大量努力和真实成本。请帮助支持GrabKit的开发!

10%的捐赠将捐赠给 自由软件基金会

donation

许可证

该项目受MIT许可证保护,请随时贡献和使用。

GrabKitPicker使用了Nicolas Verinaud制作的 NVUIGradientButton

PSTCollectionView由Peter Steinberger制作。

FlickR Grabber 使用 ObjectiveFlickR 项目: https://github.com/lukhnos/objectiveflickr

Picasa Grabber 使用 "Google Data APIs Objective-C 客户端库": https://code.google.com/p/gdata-objectivec-client/

特别感谢才华横溢的 Laurence Vagner 在演示视频中使用了她的相册 'Foodporn'。

在她的 FlickR 页面 上查看更多在创意共享许可证下的图片。

演示视频是用 CaptureRecord 制作的。 https://github.com/gabriel/CaptureRecord

联系方式

您在项目中使用 GrabKit 吗?您有什么建议吗?有什么问题吗?

Pierre-Olivier Simonard

[email protected]

www.twitter.com/pierrotsmnrd

www.linkedin.com/in/pierreoliviersimonard