這一篇我們用Windows Azure 的Mobile Service 來實作iOS的推播通知,底下我們分成三個階段來探討如何實作推播通知的服務:
第一階段:
- 開啓你的Windows Aure服務
- 在Azure上建立一個Mobile Service服務
- 在Mobile Service 裡建立一個儲存要被推播資料的Table
- 建立你的iOS App(這裡我們直接下載Windows Azure上的Xcode 專案範本)
到這個階段完成的時候,在iPhone simulate模擬器裡執行Azure所提供的專案範本時,可以看到在手機上新增的資料會成功的被寫入到Azure mobile service 的Table裡面。
參考文獻:
Get started with Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/get-started-ios/?fb=zh-tw
第二階段:
- 回到MAC上去建立憑證授權的要求Generate the certificate signing request。
- 在Apple Developer 網站上去註冊你的APP以及推播服務。(註:要完成這個步驟你必須要有Apple的開發者帳號,這一年需要繳99元美金)
- 為你的iOS App建立一個provisioning profile。
這個階段主要完成iOS App的推播憑證需求。
第三階段
- 在Azure Mobile Service 上傳你的APNS憑證Configure Mobile Services。
- 在Xcode裡面為你的iOS App新增推播通知的程式。
- 修改Azure Mobile service 的Scripts 來傳送推播資訊。
- 測試程式(新增資料以及接收推播訊息)
參考文獻:
Get started with push notifications in Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/get-started-with-push-ios/?fb=zh-tw#test
1. 開啓你的Windows Aure服務(這個部分先跳過~喂)
2. 在Windows Azure上建立一個Mobile Service服務
n 在彈出的視窗中輸入完URL後,你需要等待Windows Azure驗證,看這個名稱有沒有被使用過。
資料庫的部分我們先選擇一個免費的20MB版的SQL database。然後按下右下角的箭頭。
3. 輸入你資料庫相關的資訊
建立你的資料庫名稱以及Login資料庫的使用者名稱還有密碼。
這個資料庫的相關資訊建議你記好,後續你再繼續建立其他的Mobile Service時,可以共用這一個資料庫。
4. 建立Data Table
點選剛才建立的Mobile Service(這邊我建立的是Benlutodolist),接著選到中間iOS的部分,我們要為iOS來建立一個儲存推播資料的iOS App以及Table。
5. 建立TodoItem Table
點選[Create TodoItem Table],這裡會自動幫你建立一個範例Table,用來儲存要推播的資料。
n 系統自動建立資料庫完成,這邊會看到系統提示你[We have created the TodoItem table for you]。
6. 下載Windows Azure網站上提供的iOS App專案
在這個步驟所下載的是Xcode的一個App專案,下載這個專案後,可以在Xcode裡直接編譯執行。
註:這時候若去執行這個Xcode專案,你會發現你新增的推播資料已經被寫入我們在上一個步驟建立的Table裡。
n 在模擬器的畫面中新增資料,資料會被寫入到我們在Mobile Service 裡面所建立的資料庫。
到目前為止第一階段已經完成,我們已經建立了一個Mobile Service以及DataBase,接下來我們要處理的是關於
Apple的推播憑證。
7. 在Mac主機上建立一個憑證要求
在OSX環境中選擇 [鑰匙圈存取] à[憑證輔助程式]à[從憑證授權要求憑證]。
n 在接下來的畫面輸入你的使用者電子郵件位置與一般名稱等資訊後,然後選擇儲存到磁碟。
8. 在Apple Developer網站上為App註冊一個推播通知
(註:接下來在Apple Developer網站上的操作,你必須要有Apple的開發者帳號授權才可以。)
要讓App可以傳送一個推播通知給裝置,必需要在Apple Developer註冊你的App。
首先在Apple Developer網站上建立一個App ID。
n 在畫面下方的Bundle ID這個部分要特別留意,這邊輸入的Bundle ID 必須要Xcode專案裡面的Bundle Identifier裡面一樣,在Apple Developer,如果Bundle ID設定錯誤,是不能改的。所以這時若設定錯誤,就必須回到專案裡面去做修正。
n 接著在畫面的最下方把Push Notifications的項目打勾,然後按下[Continue] 。
n 確認資訊是否都正確,然後按下[Done]來完成建立App ID。
n 完成後可以在iOS App IDs裡看到剛剛被我們建立好的APP IDs。
9. 點擊我們建立的App IDs來建立憑證
進到我們建立的App ID內容畫面,可以看到畫面中目前Push Notifications的Development跟Distribution這兩個部分都是黃色的燈號。
n 我們把畫面拉到最下方,選擇建立一個[Development SSL Certificate]憑證。
10. 在Apple Developer網站上建立憑證。
在這邊我們按下右下角的[Continue]按鈕進行到下一個畫面。
n 在底下畫面我們選擇[Upload CSR file]來上傳我們剛剛在[鑰匙圈存取]中建立的憑證要求。
n 憑證建立完成,在這邊選擇[Download]把憑證下載回來。
n 在下載項目裡面點選下載回來的憑證,這時系統就會自動安裝這個憑證,這時你可以在鑰匙圈存取中看見我們剛剛建立的憑證。
11. 在Apple Develpoer網站上建立provisioning profile
provisioning profile是要讓你的App可以裝在實機上面做測試的。所以在建立這個provisioning profile的時候必須要指定你的Device。
n 在這個畫面中我們選擇之前建立的APP ID
n 接下來選擇你的那張Apple開發者憑證,一般應該你只有一張憑證,除非你有繳很多錢給Apple。
n 選擇你要部署的Device。
n 輸入這個 provisioning profile 的名稱。
n 接著把這個provisioning profile下載回來,安裝起來。
n 到Organizer可以看到這個provisioning profile已經被安裝起來。
n 在Xcode的專案裡面,TARGETSàBuild SettingsàCode Singing Identity
的Debug項目修改為我們剛剛建立的那張provisioning profile。
目前OSX主機上的憑證設定都已經完成了,接下來又要再回到Azure上面作設定。
12. 匯出憑證並且上傳到Azure上
接著進到鑰匙圈存取中找到剛剛下載的憑證,按下[滑鼠右鍵]來輸出憑證。
將輸出的P12檔案儲存起來後,回到Azure的Mobile Service頁面。
13. 回到Windows Azure剛剛建立的Mobile Services
n 接著選到PUSH。
14. 在[apple push notification settings]頁面的CERTIFICATE項目選擇[Upload]。
n 上傳剛剛在電腦上匯出的P12憑證匯出檔案。在[MODE]裡面選擇DEV。
15. 修改Mobile Service裡的insert script。
關於insert function,這是一個Run在Server 端的Function。這是將資料寫入你Azure上的Table。
更詳細的說明可以參考下列網站:
http://msdn.microsoft.com/en-us/library/windowsazure/jj554229.aspx
http://msdn.microsoft.com/en-us/library/windowsazure/jj554218.aspx
n 將原先的insert function置換成下列的程式碼,然後儲存。
function insert(item, user, request) {
request.execute();
// Set timeout to delay the notification, to provide time for the
// app to be closed on the device to demonstrate toast notifications
setTimeout(function() {
push.apns.send(item.deviceToken, {
alert: "Toast: " + item.text,
payload: {
"inAppMessage": "Hey, a new item arrived: '" + item.text + "'"
}
});
}, 2500);
}
到目前為止,在Windows Azure Mobile Service的設定已經完成了。
16. 到Xcode裡修改程式
在 Xcode, 開啓QSAppDelegate.h 檔案新增 *window property
@property (strong, nonatomic) NSString *deviceToken;
17. 開啓 QSAppDelegate.m,在didFinishLaunchingWithOptions方法中註冊Remote notifications:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:
(NSDictionary *)launchOptions{
// Register for remote notifications
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:
UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound];
return YES;
}
18. 在 QSAppDelegate.m,新增儲存Device Token的程式:
// We are registered, so now store the device token (as a string) on the AppDelegate instance
// taking care to remove the angle brackets first.
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken: (NSData *)deviceToken {
NSCharacterSet *angleBrackets = [NSCharacterSet characterSetWithCharactersInString:@"<>"];
self.deviceToken = [[deviceToken description] stringByTrimmingCharactersInSet:angleBrackets];
}
19. 開啓 QSAppDelegate.m,新增下方的程式碼:
// Handle any failure to register. In this case we set the deviceToken to an empty
// string to prevent the insert from failing.
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:
(NSError *)error {
NSLog(@"Failed to register for remote notifications: %@", error);
self.deviceToken = @"";
}
20. 開啓 QSAppDelegate.m,新增下方的程式:
// Because toast alerts don't work when the app is running, the app handles them.
// This uses the userInfo in the payload to display a UIAlertView.
這部分是因為toast的通知形式在你正在用這個APP的時候並不會Work,所以我們要寫一個UIAlertView的彈出視窗來對使用者作推播的動作。
- (void)application:(UIApplication *)application didReceiveRemoteNotification:
(NSDictionary *)userInfo {
NSLog(@"%@", userInfo);
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Notification" message:
[userInfo objectForKey:@"inAppMessage"] delegate:nil cancelButtonTitle:
@"OK" otherButtonTitles:nil, nil];
[alert show];
}
21. 在 QSTodoListViewController.m,在標頭import QSAppDelegate.h file。
so that you can use the delegate to obtain the device token:
#import "QSAppDelegate.h"
22. 在 QSTodoListViewController.m,modify the (IBAction)onAdd action by locating the following line:
NSDictionary *item = @{ @"text" : itemText.text, @"complete" : @(NO) };
Replace this with the following code:
// Get a reference to the AppDelegate to easily retrieve the deviceToken
QSAppDelegate *delegate = [[UIApplication sharedApplication] delegate];
NSDictionary *item = @{
@"text" : itemText.text,
@"complete" : @(NO),
// add the device token property to our todo item payload
@"deviceToken" : delegate.deviceToken
};
23. 測試APP
編譯執行Xcode的專案。進入APP後,在彈出的推播通知要求,按下確定。
在畫面中的Textbox裡面輸入文字後按下+的Button。
n 接著畫面會彈出推播視窗通知,秀出剛剛輸入的文字。
n 若是在離開App的時候,推播通知會出現在你的主畫面上。
參考網站
Push notifications to users by using Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/push-notifications-to-users-ios/
Get started with push notifications in Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/get-started-with-push-ios/?fb=zh-tw
Get started with Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/get-started-ios/?fb=zh-tw
Get started with data in Mobile Services
http://www.windowsazure.com/en-us/develop/mobile/tutorials/get-started-with-data-ios/?fb=zh-tw
Windows Azure push object
http://msdn.microsoft.com/en-us/library/windowsazure/jj554217.aspx