iPhone 開發教學 - 使用 Google Data APIs 以 Login 為例 @ 第二十四個夏天後

Google 有一系列的免費服務，大部分都有提供豐富的 APIs 以便其他開發者善加利用，其清單如下：

然而，雖然知道要使用大多是透過網路連線，回傳如 XML 格式的處理，但要自己親手處理還是有些繁雜，幸運的，這些都已經有人處理好囉！

Google Data APIs Objective-C Client Library

以下就實作一個簡單使用的範例，稍稍繁雜的地方是設定編譯的環境：

下載程式碼，此例使用 gdata-objectivec-client-1.9.1.zip ，解壓縮後開啟其目錄下的 Source/GData.xcodeproj
建立一個新的 Project ，[Xcode]->[NewProject]->[iPhone OS]->[Application]->[Window-based Application]，以 UseGoogleAPI 為例
接著將 GData 中的 GData Sources 拖拉到 UseGoogleAPI 下面，不勾選 Copy items into destination group's folder
設定 UseGoogleAPI 的編譯環境：
- 參考 Compiling the Source Files Directly into a Mac or iPhone Application
- [Xcode]->[Project]->[Edit Project Settings]->[Build]
  - C Language Dialect: C99 [-std=c99]
  - Other C Flags: -DDEBUG=1
    - 開發時可以用的 debug mode
  - Header Search Paths: /usr/include/libxml2
  - Other Linker Flags: -lxml2
  - Other C Flags: -DGDATA_REQUIRE_SERVICE_INCLUDES=1 -DGDATA_INCLUDE_CONTACTS_SERVICE=1
    - 可以精簡編出來的大小，將沒用到的去除
    - 建議最後才加！因為我嘗試一開始就加了反而有些物件宣告會出現 error ，如 expected specifier-qualifier-list before 'GDataServiceGoogleBlogger' ，但明明我已經加了 GDataServiceGoogleBlogger.h 過了！反而試 GDataServiceGoogleContact 沒出錯，完整 code 片段：
      - #import <UIKit/UIKit.h>
        #import "GDataServiceGoogleBlogger.h"
        //#import "GDataServiceGoogleContact.h"
        
        @interface UseGoogleAPIAppDelegate : NSObject <UIApplicationDelegate> {
            UIWindow *window;
           GDataServiceGoogleBlogger *service;
        //   GDataServiceGoogleContact *service;
        }
        @property (nonatomic, retain) IBOutlet UIWindow *window;
        @end
以上設定完後，可以先按 Build 一下，即使還沒寫什麼程式，也可以先編看看是否正確，此測試編譯檔案有 282 個。

開始測試 Google Data APIs：

UseGoogleAPIAppDelegate.h

#import <UIKit/UIKit.h>
#import "GDataBlogger.h"
//#import "GDataServiceGoogleBlogger.h"

@interface UseGoogleAPIAppDelegate : NSObject <UIApplicationDelegate> {
    UIWindow *window;
   IBOutlet UITextField *username;
   IBOutlet UITextField *password;
   IBOutlet UIButton *button;

   GDataServiceGoogleBlogger *service;
   GDataServiceTicket *ticket;
   BOOL logged;
}

@property (nonatomic, retain) IBOutlet UIWindow *window;
- (IBAction)doLoginOrLogout;

@end

UseGoogleAPIAppDelegate.m

#import "UseGoogleAPIAppDelegate.h"

@implementation UseGoogleAPIAppDelegate

@synthesize window;

- (IBAction)doLoginOrLogout {
   username.userInteractionEnabled = NO;
   password.userInteractionEnabled = NO;
   if ( logged ) {   // do logout
       [button setTitle: @"登入" forState:UIControlStateNormal];
       logged = NO;
   } else if( [username.text isEqualToString:@""] || [password.text isEqualToString:@""] ) {
       [button setTitle: @"帳密不可為空, 請重新登入" forState:UIControlStateNormal];
       username.userInteractionEnabled = YES;
       password.userInteractionEnabled = YES;
   } else {           // do login
       [button setTitle: @"登入中..." forState:UIControlStateNormal];
       [service setUserCredentialsWithUsername:username.text password:password.text];
       ticket = [service fetchFeedWithURL:[GDataServiceGoogleBlogger blogFeedURLForUserID:kGDataServiceDefaultUser]
                       feedClass:[GDataFeedBlog class]
                       delegate:self
                       didFinishSelector:@selector(checkLogin:finishedWithFeed:error:)];
   }
}

- (void)checkLogin:(GDataServiceTicket *)ticket
      finishedWithFeed:(GDataFeedBase *)feed
                 error:(NSError *)error {
   if (error == nil) {
       logged = YES;
       [button setTitle: @"登出" forState:UIControlStateNormal];
   } else {
       logged = NO;
       username.userInteractionEnabled = YES;
       password.userInteractionEnabled = YES;
       [button setTitle: @"帳密錯誤, 請重新登入" forState:UIControlStateNormal];
   }
}

- (void)applicationDidFinishLaunching:(UIApplication *)application {
   username.keyboardType = UIKeyboardTypeEmailAddress;
   username.returnKeyType = UIReturnKeyDone;
   password.keyboardType = UIKeyboardTypeEmailAddress;
   password.returnKeyType = UIReturnKeyDone;

   service = [[GDataServiceGoogleBlogger alloc] init];
   [service setShouldCacheDatedData:YES];
   [service setServiceShouldFollowNextLinks:YES];

   logged = NO;
    // Override point for customization after application launch
    [window makeKeyAndVisible];
}

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

@end

UseGoogleAPIAppDelegate.xib

排好後，別忘了幫按鈕接上 doLoginOrLogout 事件，除此之外，也接另一條線跟 button 變數結合，這樣才能透過程式去更改按鈕上的文字，其他部分則是把 UITextField 也接好變數，這樣才能從 UI 上把物件的數值取下來。

起始畫面：

輸入帳密錯誤：

帳密欄位空白：

正確登入後：

最後一提的，其實 Google Data APIs Objective-C Client Library 裡頭有附上豐富的 Example 囉，不過一開始編譯時，我是在 Mac OS X 10.6.2 環境，最後會出現找不到 MacOSX10.4u.sdk ，在此我是直接用 MacOSX10.6.sdk 替代，程式至少還跑的起來囉

$ cd /Developer/SDKs/
$ sudo ln -s MacOSX10.6.sdk MacOSX10.4u.sdk