抓取服务图片的样例工具 grabKit

https://github.com/pierrotsmnrd/grabKit

GrabKit

GrabKit is an iOS Objective-C library offering simple and unified methods to retrieve photo albums on Facebook, Flickr, Picasa, iPhone/iPad and Instagram (and more to come...)

Abstract

In your iPhone/iPad applications, you may want to let your users access their photo albums hosted on various social networks like Facebook or FlickR, or stored in the device. Unfortunately, the websites hosting these images offer different APIs and different libraries to authentify a user, grab its photo albums, etc.

GrabKit is made to wrap these differences into a simple library. Retrieve photo albums the same way for Facebook, FlickR, or any other implemented service !

So far, Grabkit allows you to retrieve photos from the following sources :

• Facebook
• FlickR
• Picasa
• Instagram
• iPhone/iPad

GrabKit is compatible with iOS 5.1 and further.

GrabKit is an ARC project.

Demo application

A few steps are needed to run GrabKit's demo application, please follow the detailled instructions in the wiki

How to use Grabkit in your app

Installation

To install and setup GrabKit in your project, follow the detailled instructions in the wiki

Configuration

In order to grab content from each service, you need to register your app and get an API key from each service.

Please follow the detailled instructions in the wiki

Examples

First example : retrieve 10 albums on user's Facebook account.

#import "GRKFacebookGrabber.h"

// create a grabber for Facebook
GRKFacebookGrabber * grabber = [[GRKFacebookGrabber alloc] init];

// Do you prefer a grabber for Picasa or FlickR ? simply create a GRKPicasaGrabber or a GRKFlickrGrabber.
// the following code would still work.

// Connect the grabber. the user will be prompted in Safari to authenticate and return to the app.
[grabber connectWithConnectionIsCompleteBlock:^(BOOL connected){

    if ( connected ){

        // ask for the first 10 albums of the user.
        [grabber albumsOfCurrentUserAtPageIndex:0 withNumberOfAlbumsPerPage:10 andCompleteBlock:^(NSArray *albums) {

            // albums is an NSArray of GRKAlbum, containing the 10 first albums of the user on Facebook.

        } andErrorBlock:^(NSError *error) {

            // Oop's, an error occured :)
        }];
    }

}];

Second example : Fill an album with its 10 first photos

GRKAlbum * firstAlbum = [albums objectAtIndex:0];

[grabber fillAlbum:firstAlbum withPhotosAtPageIndex:0 withNumberOfPhotosPerPage:10 andCompleteBlock:^(NSArray *addedPhotos) {

     // At this point, firstAlbum is filled with its 10 first photos, and the added photos are passed in the NSArray addedPhotos

      NSLog(@" already loaded photos of first album : %@", [firstAlbum photos]);
      NSLog(@" added photos : %@", addedPhotos);


  } andErrorBlock:^(NSError *error) {
      // Oop's, an error occured :)
  }] ;

Model

• an album is an instance of a GRKAlbum, having the following properties :

  • albumId : id of the album according to the service
  • count : total number of photos for the album, according to the service.
  • name : name of the album
  • coverPhoto : an instance of a GRKPhoto representing the cover photo of the album

• a photo is an instance of a GRKPhoto. It has a name (title of the photo), a caption(its description). A GRKPhoto has severalimages which represent the photo in different sizes.

• an image is an instance of GRKImage. it has a width, a height, an URL, and a flag (isOriginal) notifying if this image is the original image uploaded by the user.

Coming soon

• More tests and examples
• More services
• More documentation
• More content to grab
• Changes for iOS6