【教學】Facebook SDK 首部曲：登入Facebook（這是我的一小步...卻是人類...咦？這麼多人啊？）

這篇我們會寫一個小App ，利用Facebook SDK進行登入。


App的流程：

使用者先看到LoginView，
如果已經登入Facebook並授權，帶使用者到MainView，否則使用者可以點擊FB Login按鈕進行登入，

MainView有按鈕可以讓使用者讀取自身的資料以及登出。

需要準備：
1. 已經設定好的專案，可以參考上一篇：【教學】Facebook SDK 前傳：準備Social一下
2. 先閱讀：Understanding FBSession，會有幫助。



開始吧！

先準備好專案要用的元件：

1. 建立一個LoginViewController，LoginView放上一個登入按鈕，加入點擊事件。

2. 建立一個MainViewController，MainView放上一個UILabel用來顯示‘已登入’，一個UITextView來顯示使用者資料，兩個UIButton一個抓使用者資料，一個登出。

準備好，要Coding了：

開始Copy，Coding之前我們根據看過'Understanding FBSessions'瞭解：

1. 'FBSession' class是用來管理、儲存、更新Token（憑證）的類別，所以我們不用在自己寫符合OAuth2.0流程的認證程序，讓FBSession去溝通就好，通常Session指的是FBSession Class的實體。
2. 'FBSession.activeSession'這個property是目前有效、使用的Session。
3. 透過'FBSession.activeSession.state'這個property，我們可以知道目前Session進行認證的程序狀況。

我們也瞭解'state'有下面幾種狀況：

    FBSessionStateCreated                       :已建立新的Session，未找到有可用的Token。
    FBSessionStateCreatedOpening         : 已建立新的Session，使用者登入授權中。
    FBSessionStateOpen                           : 使用者已登入並授權。
    FBSessionStateCreatedTokenLoaded : 已建立新的Session，並找到可用的Token。
    FBSessionStateClosedLoginFailed      : 登入失敗、取消、不授權或是按了Home鍵退出App（state = FBSessionStateCreatedOpening）
後返回（state = FBSessionStateClosedLoginFailed）。

    FBSessionStateClosed                         : 關閉Session，但Token留著。
    FBSessionStateExtended                     : 成功要求更多的存取權限，Token會更新。


所以，我們可以在使用者進到LoginView查看是否有可用的Token（state = 'FBSessionStateCreatedTokenLoaded'），
如果有，就建立一個新的Session（後面還要溝通用）然後把使用者帶到MainView，
否則就讓使用者自己登入。



我們來Coding吧！

LoginViewController.m

#import "LoginViewController.h"
#import <FacebookSDK/FacebookSDK.h>
#import "MainViewController.h"

@interface LoginViewController ()

@end

@implementation LoginViewController

- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
{
    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
    if (self) {
        
        self.permissions = @[@"basic_info",
                          @"user_location",
                          @"user_birthday",
                          @"user_likes"];
    }
    return self;
}

- (void)dealloc {
    [_permissions release];
    [super dealloc];
}

- (void)viewDidLoad
{
    [super viewDidLoad];
    //  cause this view is not even show on the screen, so if present a ViewController here will fail.
}

- (void)viewDidAppear:(BOOL)animated {
    [self checkState];
}

- (IBAction)loginButtonAction:(id)sender {
        NSLog(@"check session and token is vaild :");
        //  check if user already login or not
        //  little bug at LoginUI in webview, you can close it by click left-up corner.
    
    [FBSession openActiveSessionWithReadPermissions:_permissions
                                           allowLoginUI:YES
                                      completionHandler:^(FBSession *session,
                                                          FBSessionState status,
                                                          NSError *error) {
                                          //    called while state changed
                                          
                                          [self checkState];

                                      }];
}

- (void)checkState{
    
    FBSessionState nowState = FBSession.activeSession.state;
    
    switch (nowState) {
        case FBSessionStateClosed:
            NSLog(@"FBSessionStateClosed");
            break;
            
        case FBSessionStateClosedLoginFailed:
            NSLog(@"FBSessionStateClosedLoginFailed");
            break;
            
        case FBSessionStateCreated:
            NSLog(@"FBSessionStateCreated");
            NSLog(@"No Login");
            break;
            
        case FBSessionStateCreatedOpening:
            NSLog(@"FBSessionStateCreatedOpening");
            break;
            
        case FBSessionStateCreatedTokenLoaded:
            NSLog(@"Token Got!");
            //  even have vaild Token, still need a Session to do the communication.
            [FBSession openActiveSessionWithAllowLoginUI:NO];   //  create a session.
            
        case FBSessionStateOpen:
            NSLog(@"%@", (nowState==FBSessionStateOpen)?@"FBSessionStateOpen":@"FBSessionStateCreatedTokenLoaded");
            
            MainViewController *main = [[[MainViewController alloc] init] autorelease];
            [self presentViewController:main animated:YES completion:nil];
            break;
            
        case FBSessionStateOpenTokenExtended:
            NSLog(@"FBSessionStateOpenTokenExtended");
            break;
    }
}

@end

MainViewController.m

#import "MainViewController.h"
#import <FacebookSDK/FacebookSDK.h>

@interface MainViewController ()

@end

@implementation MainViewController

- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil
{
    self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
    if (self) {
        // Custom initialization
    }
    return self;
}

- (void)viewDidLoad
{
    [super viewDidLoad];

}

- (void)dealloc {
    [_infoLabel release];
    [_showView release];
    [super dealloc];
}

- (void)viewDidUnload {
    [self setInfoLabel:nil];
    [self setShowView:nil];
    [super viewDidUnload];
}

- (void)didReceiveMemoryWarning
{
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

- (IBAction)getInfo:(id)sender {
    NSLog(@"Connecting");
    
    [FBRequestConnection
     startForMeWithCompletionHandler:^(FBRequestConnection *connection,
                                       id<FBGraphUser> user,
                                       NSError *error) {
         NSLog(@"Response done.");
         if (!error) {
             NSMutableString *userInfo = [[[NSMutableString alloc] init] autorelease];
             NSLog(@"user : %@", user);
             // Example: typed access (name)
             // - no special permissions required
             [userInfo appendString: [NSString stringWithFormat:@"Name : %@\n\n",user.name]];

             // Example: typed access, (birthday)
             // - requires user_birthday permission
             [userInfo appendString: [NSString stringWithFormat:@"Birthday : %@\n\n",user.birthday]];
             
             // Example: partially typed access, to location field,
             // name key (location)
             // - requires user_location permission
             [userInfo appendString: [NSString stringWithFormat:@"Location : %@\n\n", user.location[@"name"]]];

             // Example: access via key (locale)
             // - no special permissions required
             [userInfo appendString: [NSString stringWithFormat:@"Locale : %@\n\n", user[@"locale"]]];

             // Example: access via key for array (languages)
             // - requires user_likes permission
             if (user[@"languages"]) {
                 NSArray *languages = user[@"languages"];
                 NSMutableArray *languageNames = [[NSMutableArray alloc] init];
                 for (int i = 0; i < [languages count]; i++) {
                     languageNames[i] = languages[i][@"name"];
                 }
                 [userInfo stringByAppendingString:
                        [NSString stringWithFormat:@"Languages: %@\n\n", languageNames]];
             }

             // Display the user info
             self.showView.text = userInfo;
             
         }else {
             NSLog(@"error : %@", error);
         }
     }];
    
}

- (IBAction)logoutAction:(id)sender {
    [FBSession.activeSession closeAndClearTokenInformation];
    [self dismissViewControllerAnimated:YES completion:nil];
}

@end

OK！Coding完你可能會問：

那...認證呢？

 好問題！見到LoginViewController.m登入按鈕裡用的

[FBSession openActiveSessionWithReadPermissions:allowLoginUI:completionHandler:]

方法了？

這個方法有三個參數：

1. Permission：要使用者授權讓我們可以讀取的項目，可以在這裡找到。

2. allowLoginUI：是否要跳出授權視窗？
    跳出的方法預設是：
    a. iOS6 Native Login Dialog（如果系統是iOS6 up，直接使用手機預設帳號）。
    b. Facebook App Native Login Dialog（如果手機有裝Facebook App，使用目前登錄的帳號）。
    c. Facebook Web Native Login Dialog（推出一個WebView，但每一次使用者都要進行登入）。
    d. 內建瀏覽器Safari（推出Safari，進入到Facebook認證網頁，很lol）。

    你可以在這裡找到詳細說明。

3. completionHandler：Block，認證不論有沒有成功，會執行。


這個方法會先建立一個Session，然後試著找有沒有可用的Token，
如果找到，state = FBSessionStateCreatedTokenLoaded，載入Token，不推出LoginUI，
否則會檢查allowLoginUI:推出LoginUI進行認證，
認證期間，state = FBSessionStateCreatedOpening，
認證成功，state = FBSessionStateOpen，
認證失敗，state = FBSessionStateClosedLoginFailed。

所以成功的完成認證。

 
注意，要完整跑完流程一次，記得要把模擬器重設以及Facebook帳號要刪掉App的授權。

那...有沒有另一種方法呢？

FBSession提供的靜態方法有openActiveSession...開頭的都可以玩看看，參考文件。

也可以建立實體：
FBSession *session = [FBSession alloc]，再選擇合適的init...方法，
利用實例方法openWith...開起Sesion，都可試試。
如果要自己設定LoginUI的方式，可以用openWithBehavior:completionHandler:，設定Behavior參數來達到。


那...資料怎麼抓的呢？

好問題！我們下一部曲再說吧！XD

App畫面：

 

 

如果你的Facebook帳號有設定登入碼認證，則會多一確認步驟。

 如果有開登入提醒的話然後會收到簡訊，像最後一條簡訊一樣。

Note :

a. 如果出現：
Error Domain=com.facebook.sdk Code=5 "The operation couldn’t be completed. (com.facebook.sdk error 5.)" UserInfo=0xa1580e0 {com.facebook.sdk:ParsedJSONResponseKey={
    body =     {
        error =         {
            code = 2500;
            message = "An active access token must be used to query information about the current user.";
            type = OAuthException;
        };
    };
    code = 400;
}, com.facebook.sdk:HTTPStatusCode=400}

表示讀到可用Token但沒有Session可用，讀到Token用FBSession建一個Session就好了。


b. 如果出現：
FBSDKLog: Cannot use the Facebook app or Safari to authorize, ?????? is not registered as a URL Scheme

App Secret無法辨識，如果用上面的??????把.plist的App Secret換掉就不會出現，但是LoginUI會變成用Safari開啓而不是WebView。


c. 如果出現：認證期間出現錯誤，可能a狀況出現太多次，暫時被擋掉，稍待一會就好了。

繼續前進：【教學】Facebook SDK 二部曲：從Facebook抓取資料

參考文件：

Understanding FBSessions

FBSession Reference

Permissions

Using Facebook Login


參考範例：

Fetch User Data for iOS