Apple推送通知服务教程
Apple推送通知服務教程
生成APP ID和SSL證書
登錄iOS Provisioning Portal頁面
首先,我們將要新建一個App ID. 每一個推送APP都需要一個唯一的對應的App ID,推送的消息將被送達到這個ID對應的APP應用中(這里不能使用通配ID)。
在iOS Provisioning Portal頁面左側選擇App IDs,然后點擊New App ID的按鈕。
在例子中,對應的表單項填的值如下:
·Description: PushChat
·Bundle Seed ID: Generate New (this is the default option)(這是默認值)
·Bundle Identifier: com.hollance.PushChat
我的例子APP中對應的Bundle ID值為 – com.yoursite.PushChat – 這里最好替換成你自己的。同樣,你需要在 XCode中對應的工程的Bundle ID配置里指定為同一個值。
等一會,我們將生成一個SSL證書,讓你的推送服務器可以創建一個安全連接至APNS。這個證書會鏈接到你的這個App ID,你的推送服務器只能推送通知到特定的APP,而不是其它APP。:
在制作App ID后,應該顯示成像下面這樣:
在“Apple Push Notification service”這一欄中,有兩個橙燈,分別對應配置APP推送功能的“開發版”和“產品版”,這也就是說,這個App ID能接收推送消息,但是我們仍然需要設置好才可以。點擊Configure鏈接打開對應的配置頁面。
勾選“Enable for Apple Push Notification service”的復選框,接下來點擊Development Push SSL Certificate右邊的Configure按鈕,會彈出“Apple推送通知服務SSL證書助手”的頁面。
第一件事讓你生成一個證書簽名的請求,這一步我們已經做過了,所以點擊Continue。下一步是上傳CSR文件。選擇在前面步驟中我們已生成好的CSR文件,然后點擊Generate按鈕。
等待數秒鐘后便會生成SSL證書。當證書生成完成后,點擊Continue按鈕。
現在點擊Download按鈕下載這個生成好的文件名為“aps_developer_identity.cer”的證書。點擊Done關閉證書助手,回到配置App ID的界面。
現在可以看到,我們已經生成了一個可用的證書,現在推送通知功能已經為接下來的開發準備好了(開發版)。你可以在需要的時候重復下載這個證書文件。需要注意的是,這個開發證書只有3個月的有效期
當你準備好發布正式版APP時,需要在產品版的Configure里重復上述操作,步驟是一樣的。
注:產品版的證書有效期是一年,但如果你為了在失效期之前想重新生成這個證書,請事先確認這個app本身沒有過期。
雖然你可以通過雙擊下載下來的aps_developer_identity.cer文件,將這個證書加到你的鑰匙串中,但你并不一定需要這么做。當然如果你這么做了,你會發現這個證書關聯了那個私有密匙。
生成一個PEM文件
現在我們有3個相關文件
· CSR文件
· P12私有密鑰文件,PushChatKey.p12
· SSL證書文件,aps_developer_identity.cer
把這三個文件存到一個安全的地方。你可以扔掉CSR但我的意見是保留它更容易。當你證書過期時,你可以用相同的CSR產生一個新的。如果你想產生一個新的CSR,你也要產生一個新的私鑰。當你重復使用CSR時你繼續使用存在的私鑰,僅僅.cer文件將會改變。
我們必須轉換證書和私鑰成一個對我們更有用的格式。因為我們服務器的推送部分是用php寫的,我們將要把證書和私鑰整合到一個單獨PEM格式的文件里。
PEM的內容并不是很重要(事實上,我也不知道),但是它讓PHP使用我們的證書變得非常方便。如果你想用其他語言寫你的推送服務,以下的步驟對你來說也許會沒有作用
我們將要使用命令行OpenSSL工具來做這些,打開命令行然后執行以下的步驟。
前往你下載好文件的文件夾,我是放在Desktop上
$ cd /Users/matthijs/Desktop
把.cer文件轉換成.pem文件:
$ openssl x509 -in aps_developer_identity.cer -inform der
-out PushChatCert.pem
把私鑰.p12文件轉換成.pem文件:
$ openssl pkcs12 -nocerts -out PushChatKey.pem -in PushChatKey.p12
Enter Import Password:
MAC verified OK
Enter PEM pass phrase:
Verifying – Enter PEM pass phrase:
你首先需要為.p12文件輸入passphrase密碼短語,這樣OpenSSL可以讀它。然后你需要鍵入一個新的密碼短語來加密PEM文件。還是使用”pushchat”來作為PEM的密碼短語。你需要選擇一些更安全的密碼短語。
注意:如果你沒有鍵入一個PEM passphrase,OpenSSL將不會返回一個錯誤信息,但是產生的.pem文件里面將不會含有私鑰。
最后。把私鑰和證書整合到一個.pem文件里:
$ cat PushChatCert.pem PushChatKey.pem > ck.pem
為了測試證書是否工作,執行下面的命令:
$ telnet gateway.sandbox.push.apple.com 2195
Trying 17.172.232.226…
Connected to gateway.sandbox.push-apple.com.akadns.net.
Escape character is ‘^]’.
它將嘗試發送一個規則的,不加密的連接到APNS服務。如果你看到上面的反饋,那說明你的MAC能夠到達APNS。按下Ctrl+C 關閉連接。如果得到一個錯誤信息,那么你需要確保你的防火墻允許2195端口。
然后再次連接,這次用我們的SSL證書和私鑰來設置一個安全的連接:
$ openssl s_client -connect gateway.sandbox.push.apple.com:2195
-cert PushChatCert.pem -key PushChatKey.pem
Enter pass phrase for PushChatKey.pem:
你會看到一個完整的輸出,讓你明白OpenSSL在后臺做什么。如果連接是成功的,你可以鍵入一些字符。當你按下回車后,服務就會斷開連接。如果在建立連接時有問題,OpenSSL將會給你一個錯誤消息,但是你不得不向上翻輸出LOG,來找到它。
注意有2個不同的APNS服務器:沙盒服務器是用來做測試,而live服務器是為產品模式使用的。由于以上原因,我們用沙盒服務器,因為我們的證書是用來做開發的,不是產品使用的。
制作Provisioning Profile
在Provisioning Porta還沒有完成,點擊側邊欄Provisioning,點擊New Profile。
在上面的區域里我是這么填寫的:
Profile Name:PushChat Development
Certificates:勾選你的證書
App ID:PushChat
Devices:勾選你的設備
這和你以前做的任何provisioning profile都不同。我們需要做一個新的profile,因為每個推送app必須有它自己的profile來連接正確的App ID。
點擊提交然后profile就會產生。新的profile將會是Pending狀態。刷新Development Provisioning Profiles頁面,狀態就會變成Active然后你就可以下載文件了(名字是PushChat_Development.mobileprovision)。
通過雙擊它或者拖到Xcode的圖標添加provisioning profile到Xcode里。如果發布你的app,你將不得不重復這個過程來產生一個AdHoc或者App Store distribution profile。
在教程的中,你已經能讓你的iPhone應用接收推送消息,并且知道了怎樣使用一個PHP的腳本來推送一個測試消息。在這個第二部分和最后一個部分中,你將會學到如何用APNS來做一個簡單的應用,以及一個簡單的PHP Web服務來增強你的應用功能。
注意:這篇教程相對比較長,你需要做好一個較長的時間準備去看完它。但它是很值的,一旦你看完它,你就擁有了一個更強大的應用和使用推送消息的Web服務。
介紹PushChat
在這個教程中,我們將要做一個叫做PushChat的簡單的發消息應用,它采用推送消息來發信息。以下是它的樣子:
用戶看到的第一個屏幕是登陸界面。在這里用戶輸入他們的昵稱和一個secret code。用戶與他們的朋友們分享這個secret code。
每一個使用相同的secret code的人可以看到相互的消息。那么實際上,這個secret code相當于一個聊天室的名字。當然,如果你能猜到別人的code,那么你也能看到別人消息,所以它叫做secret code。
當用戶按了Start!按鈕,應用就給我們的服務器發送一條注冊聊天室的消息。然后登陸界面就跳轉到聊天界面:
Secret code 顯示在navigation bar上。本地用戶發送的消息顯示在屏幕的右邊,收到的消息則顯示在左邊。那么在這樣例子中,這個用戶和一個叫做SteveJ的人同時登陸到了這個叫做“TopSecretRoom123”的聊天室中。
第三個也是最后一個界面是輸入界面。
這里沒有什么特別的地方。它只是一個帶有鍵盤的text view。消息大小被限制在190個字節,屏幕的上方顯示了剩余字節數。
我添加這個限制的目的是因為一條推送消息的最大長度是256個字節,它包括了開頭的JSON內容。
當用戶按下保存按鈕的時候,消息將會被發送到我們的服務器,然后推送到其他登陸相同聊天室的用戶。
The Server API服務器API
在以上闡述PushChat如何工作的過程中,我提到了幾次“我們的服務器”。我們需要使用一臺服務器是因為我們要使不同的設備相互協作。當只有你一個人在說的時候,這也算不上什么聊天。
我用PHP和MySQL寫了一個簡單的Web服務。這個iPhone應用將會給我們的服務器發送以下命令:
加入當用戶在登陸界面登陸的時候,我們會給服務器發送他的昵稱、它的secret code和它的device token。服務器在活躍用戶列表中添加一條關于他的記錄。這以后,同一個聊天室成員發送的任何消息將會被發送到這個新用戶上。
LEAVE這與加入相反。用戶在聊天界面中通過按下Exit按鈕退出聊天。我們給服務器發送一條LEVEL的命令讓它從活躍用戶列表中刪除這個用戶。
MESSAGE.當一個用戶在輸入界面按下Sava按鈕的時候,我們會給我們的服務器發送一條新的文本消息。然后服務器將為每一個聊天室成員將這些消息轉換成推送消息,然后傳給APNS。過一會兒,ANPS就會將這些消息推送給那些用戶的設備。
UPDATE.這是讓服務器知道,這個用戶擁有了新的device token。 Token也許會經常更新,如果發現更新了,就必須讓服務器知道.關于這個之后會詳細討論
它的工作流程如圖所示
要頻繁的向服務器發送數據,要讓服務器知道用戶加入或離開一個聊天室或者她正在發送一條新的消息。服務器輪流創建推送消息然后發給APNS.蘋果服務器負責將這些消息發送給app。當app收到一條新的推送消息,它會在message.app的Chat View上顯示一條含有文字內容的聊天氣泡
啟用服務器
Setting up the server
如果你是WEB新手,你可以先看一下Ray’s tutorial on PHP and MySQL,我們將使用MAMP在mac上安裝服務器和數據庫,如果你的APP正在開發階段,這是個不錯的方案,MAMP容易安裝并且你也不必為一個分離的服務器付錢。
唯一的要求是你的MAC和你的iPhone共享一個本地網絡,否則APP將沒法和SERVER交互,很多人家里有WIFI,所以這不是個大問題。
當然,一旦你的APP上線了,你要安裝真正的和INTERNET連接的服務器。
你可以免費下載MAMP(也有付費版,但是免費版夠用了)
PDO,PDO_MYSQL,MBSTRING,OPENSSL.
MAMP 包含APACHE服務器,PHP腳本,MySQL數據庫,我們將使用這所有的三樣,如果你想在安裝了PHP設備上而不是MAMP上使用這個教程的服務器代碼,你要確保你額外安裝并啟動了以下擴展:
安裝MAMP很容易,將下載的文件解壓,打開DMG文件,接受License許可,將MAMP文件夾拖拽到你的應用的目錄,DONE!
啟動MAMP,打開APPLICATION/MAMP點擊MAMP圖標(有大象的那個),打開了MAMP窗口。
點擊OPENSTARTPAGE 按鍵,打開了默認瀏覽器,進入welcome界面。
Great!現在下載PUSHCHART SERVER代碼,解壓,確保在你的桌面上解壓了這玩意兒,我之所以說這話,因為我們需要為APACHE web服務器 配置將這些文件的路徑。
打開APPLICATIONS/MAMP/CONF/APACHE/HTTPD.CONF 添加如下代碼行:
Listen 44447
<VirtualHost *:44447>
DocumentRoot "/Users/matthijs/Desktop/PushChatServer/api"
ServerName 192.168.2.244:44447
ServerAlias pushchat.local
CustomLog "/Users/matthijs/Desktop/PushChatServer/log/apache_access.log" combined
ErrorLog "/Users/matthijs/Desktop/PushChatServer/log/apache_error.log"
SetEnv APPLICATION_ENV development
php_flag magic_quotes_gpc off
<Directory "/Users/matthijs/Desktop/PushChatServer/api">
Options Indexes MultiViews FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
有些需要修改的,我的PUSH CHAT SERVER 的安裝目錄是“/Users/matthijs/Desktop”.把它改成
你解壓的文件的位置。
在SERVERNAME 行里修改IP,改成你的MAC的IP,如果你不知道如何獲取IP,打開系統偏好設置,進入網絡面板.
我使用我的MACBOOK的WIFI的IP地址,不過 以太網的IP也可以. 注意你在SERVERNAME處將 端口號改為44447.
ServerName <your IP address>:44447
這里的WEB服務使用44447端口,這是 隨便 設定的值, 網頁服務 使用了80端口,默認的MAMP網頁服務在8888端口,這里只是選擇一個不會與其它服務沖突的端口.
“pushchat.local”作為服務器的別名,這就像一個域名,但它僅僅工作在本地網絡上,我們要把名字改成IP地址,完成這個的捷徑就是,編輯文件 “/ETC/HOSTS”在文件末尾添加如下代碼行:
127.0.0.1 pushchat.local
在MAMP窗口,點擊STOP SERVERS,等燈變紅,點擊START SERVERS,如果你 對HTTPD.CONF的修改沒有錯的話,兩個服務器的燈都應該再次變綠。
打開默認瀏覽器,到http://pushchat.local:44447.能看到信息:
If you can see this, it works!
太棒了!這意味著服務器API的APACHE和PHP代碼成功安裝,現在要配置服務器。
啟動數據庫
設置數據庫
返回MAMP起始頁(你可以通過點擊MAMP窗口的OPEN THE START PAGE).點擊頂部的PHPMYADMIN按鍵,屏幕如下:
在CREATE DATABASE 區域鍵入 pushchat,選擇 “utf8_general_ci”核對,然后點擊 CREATE創建數據庫,可以看到數據創建成功的提示。
點擊 屏幕頂端的Privileges按鍵,然后添加一個新用戶。
如下填寫:
·User name: pushchat
·Host: localhost
·Password: d]682\#%yI1nb3
·Privileges: Check “Grant all privileges on database “pushchat””
點擊GO,添加用戶,你可以修改密碼,但你同時要記住在不同的PHP腳本中更改密碼。
這是 數據庫和用戶,現在我們需要向數據庫中添加表,點擊屏幕頂部的SQL按鍵,將如下代碼貼進TEXT BOX.
USE pushchat;
SET NAMES utf8;
DROP TABLE IF EXISTS active_users;
CREATE TABLE active_users
(
udid varchar(40) NOT NULL PRIMARY KEY,
device_token varchar(64) NOT NULL,
nickname varchar(255) NOT NULL,
secret_code varchar(255) NOT NULL,
ip_address varchar(32) NOT NULL
)
ENGINE=InnoDB DEFAULT CHARSET=utf8;
你也可以在 PushChatServer/database/api.sql中找到這些語句,
點擊GO,執行腳本,創建一個新表——active_users
當服務器API收到JOIN命令,我們將為用戶在表中添加一個新的記錄,相反的,當LEAVE命令發送,將從表中移除用戶的紀錄。
這是另一個要添加的表,重復以上動作添加:
USE pushchat;
SET NAMES utf8;
DROP TABLE IF EXISTS push_queue;
CREATE TABLE push_queue
(
message_id integer NOT NULL AUTO_INCREMENT,
device_token varchar(64) NOT NULL,
payload varchar(256) NOT NULL,
time_queued datetime NOT NULL,
time_sent datetime,
PRIMARY KEY (message_id)
)
ENGINE=InnoDB DEFAULT CHARSET=latin1;
可以在PushChatServer/database/push.sql找到這些語句。
去論何時 服務器接收 到MESSAGE命令,他將 推送消息添加進這個表。
配置服務器API
在這里我就不大篇幅描敘服務器的API是如何工作的,但是我已經說了很多關于API.PHP,即使你不知道PHP你應該也能跟上。
與我們息息相關的是 api_config.php 文件,這個文件包含了服務器API的配置選項。
這里有兩組 配置選項,一個是development模式,一個是production模式,做兩組設置 你可以很容易的在這兩者之間切換。
但是怎樣告訴API他運行DEVELPMENT模式還是PRODUCTION模式?答案在 APACHE VITRUAL HOST 配置,之前我們添加了 一個<VirtualHost>模塊在HTTP.CONF文件里:
<VirtualHost *:44447>
…
SetEnv APPLICATION_ENV development
...
</VirtualHost>
“SetEnv APPLICATION_ENV development”指令創建了一個 環境變量,它決定了腳本在那種模式下運行。如果你想切換到PRODUCTION CONFIGURATION 模式,把這行去掉,或者將DEVELOPMENT 換成 PRODUCTION。
如果 你用了和我相同的名字做 數據庫名字,在API.CONFIG.PHP里你就不用修改任何值了,但是 如果你用了其他的值,你要在這里 輸入它們,否則 API就連不上數據庫。
瀏覽http://pushchat.local:44447/test/database.php,你得到如下消息:
Database connection successful!
建議:如果你得到了 不理解的錯誤。在PushChatServer/log/apache_error.log檢查PHP錯誤紀錄和在PushChatServer/log/apache_error.log.檢查Apache 的錯誤記錄,這些log文件可能告訴你 哪里錯了。
到這里完成 SERVER API的安裝。
讓我們開始編程吧!
下載PushChatStarter代碼并解壓,這是沒有網絡和推送代碼的PUSHCHAT應用,我會快速解釋這個應用是怎么工作的,然后我會向它里面添加代碼,讓他能夠和服務器對話,并能接受推送通知。
總之,這是你想了解的東西!
你可以在模擬器運行 PUSHCHAT,因為現在他沒有任何推送功能,首先在XCODE中打開工程,到目標設置(Target Setting)。你必須將綁定ID(bundle ID——我這項目是“com.hollance.PushChat” )改換成你自己的bundle ID,這樣你就可以在iOS Provisioning Portal(APPLE開發者中心)中選擇各種你需要的消息方式……這很重要因為APP需要用配置文件(provisioning profile)簽名。
編譯運行,好好把玩一下,因為新的APP使用的BUNDLE ID 和最開始是的TEST APP相同,
所以在編譯運行之前最好先 卸載那個 舊的APP,以確保你的IPHONE不會報錯。
打開 MAINWINDOW.XIB,看一下 APP是如何構成的:
MAIN WINDOW包含一個 Navigation Controller, ChatViewController是它的根控制器,那個視圖控制器展示收到的和發送的消息,你可以在NIB里看到,是一個普通的UITableView 控制器。
speech bubbles 由 MessageTableViewCell繪制,MESSAGETABLEVIEW是UITABLEVIEWCELL SpeechBubbleView是UIView的子類,完成普通繪制功能,這些是簡單的TableView編程,你肯定早就知道了,我就不花時間解釋了。
兩個SCREEN,Login screen and和Compose screen,
都是在 CHAT VIEW CONTORLLER頂部展示的view controller模型,但是 Long screen在LoginViewController里實現,Compose Screen在ComposeViewController里實現,它們都有各自的NIB。這些是很簡單的SCREEN,查看源碼詳細看一下。
還剩下兩個數據模型類(data model class),DataModel和Message,message描敘了一條單獨消息內容,它可能是由當前用戶發送的,或者從另一個用戶收到的,每一個消息有一個發送者的姓名(sender name),一個日期,還有消息實體。
DataModel 類負責這些消息對象,當一個新的消息被發送或者收到,DataModel將其加到表中,然后將表保存到 APP的文檔目錄的一個文件里、
當APP啟動時,DataModel從文件中加載信息,這個是對應用的一個簡單描敘,我建議在繼續下一步之前看看代碼,代碼有大量注解解釋每一部分如何工作的。
通過服務器聊天
我們講解完了app的每一個view并開始向其中添加代碼,使得它能和服務器通訊。我們的服務器需要app發送HTTP Post請求,所以我打算用ASIFormDataRequest來發送數據給服務器。所有的請求類已經被加入PushChat的初始代碼中,所以這里不需要再次安裝。
如果你第一次在iOS apps上使用web服務,我建議你先去看一下Ray’s previous tutorial中有關這些的教程
添加如下代碼到defs.h中
#define ServerApiURL @”http://192.168.2.244:44447/api.php”
我們將把HTTP POST請求發送到這個URL。你需要修改IP地址來指向你的服務器。同時要確認MAMP正在運行,也就是說服務器是可訪問的,并且你的iPhone和服務器在同一局域網下。
我們最好先從登陸界面開始。當用戶按下Start!按鈕,我們需要發送一條JOIN命令到服務器。這讓服務器知道這里有一個新的用戶。服務器將會把他添加到活躍用戶列表中
添加如下代碼到LoginViewController的頂部:
#import "ASIFormDataRequest.h" #import "MBProgressHUD.h"
把下面一大段代碼添加到userDidJoin和loginAction方法之間:
- (void)postJoinRequest
{
MBProgressHUD* hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
hud.labelText = NSLocalizedString(@"Connecting", nil);
NSURL* url = [NSURL URLWithString:ServerApiURL];
__block ASIFormDataRequest* request = [ASIFormDataRequest requestWithURL:url];
[request setDelegate:self];
[request setPostValue:@"join" forKey:@"cmd"];
[request setPostValue:[dataModel udid] forKey:@"udid"];
[request setPostValue:[dataModel deviceToken] forKey:@"token"];
[request setPostValue:[dataModel nickname] forKey:@"name"];
[request setPostValue:[dataModel secretCode] forKey:@"code"];
[request setCompletionBlock:^
{
if ([self isViewLoaded])
{
[MBProgressHUD hideHUDForView:self.view animated:YES];
if ([request responseStatusCode] != 200)
{
ShowErrorAlert(NSLocalizedString(@"There was an error communicating with the server", nil));
}
else
{
[self userDidJoin];
}
}
}];
[request setFailedBlock:^
{
if ([self isViewLoaded])
{
[MBProgressHUD hideHUDForView:self.view animated:YES];
ShowErrorAlert([[request error] localizedDescription]);
}
}];
[request startAsynchronous];
}
呀,介都是嘛啊,讓我們一行行的來解釋下。
MBProgressHUD* hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
hud.labelText = NSLocalizedString(@"Connecting", nil);
這將顯示一個轉菊花并阻止整個屏幕的活動,你可以在Ray’s article中了解關于MBProgressHUD更多的內容
NSURL* url = [NSURL URLWithString:ServerApiURL];
__block ASIFormDataRequest* request = [ASIFormDataRequest requestWithURL:url];
[request setDelegate:self];
這是為我們的服務器URL創建一個ASIFormDataRequest對象。ASIFormDataRequest在向服務器發送POST請求時做得很出色。你告訴他URL,給他POST的內容 然后他就發出去了,我將要花一分鐘來解釋下__block的意思
[request setPostValue:@"join" forKey:@"cmd"];
[request setPostValue:[dataModel udid] forKey:@"udid"];
[request setPostValue:[dataModel deviceToken] forKey:@"token"];
[request setPostValue:[dataModel nickname] forKey:@"name"];
[request setPostValue:[dataModel secretCode] forKey:@"code"];
在這里,我們向request中添加了POST的內容。我設計的服務器API將會在POST的數據中查找cmd的字符串。這個值決定API將會執行什么命令。這段代碼是執行Join命令。
Join有四個參數。用戶的昵稱、secret code是顯而易見的,這些事用戶在login 頁面所填入的信息。但是“udid” 和 “token”呢?也許你猜到了,token是用于推送的device token,這個是讓服務器知道他要給設備推送信息時的地址。
UDID是設備的唯一ID,在數據庫中標記用戶我更青睞于用設備ID。我可以用nickname代替,但是這樣就不能存在兩個相同昵稱的用戶,我們就需要在app中告訴用戶他的昵稱已經被使用了。
我也可以用device token來當做用戶的唯一id,但是device token時常更新。但是udid從來不會改變。我沒有說這種方法適用所有web服務,但是對于我們來說已經足夠了。
好的,現在開始變得有趣了
[request setCompletionBlock:^
{
...
}];
我們用了塊函數(blocks)!這里有兩種方法作為ASIFormDataRequest的通知結果。老方式是實現requestFinished 和 requestedFailed delegate。這是Ray在他的web服務文章中使用的方式。
這種方式可以很好的工作,但是必須是iOS4.0以上。Blocks被介紹為一種代替delegate的方式。但只是為了歡樂,我決定在這篇教程中使用塊函數。這里我們設置了完成時的塊函數。^{}之間的代碼,現在是不會被執行的,直到請求成功的完成。
還記得在我創建ASIFormDataRequest對象時的__block標記嗎?那是用來阻止block中保持對request引用的。因為request已經在block中保持了引用,這會導致retain循環,并導致內存泄露。
如果你接受不了,那就不要再糾結他了。只要記得當你用塊函數替代delegate方法之時,把__block放到ASIFormDataRequest之前。
在塊函數中,我們這樣:
if ([self isViewLoaded])
{
[MBProgressHUD hideHUDForView:self.view animated:YES];
}
首先,我們判斷是否還在加載。因為請求是異步在后臺的,他會過一段時間才會完成。理論上說,在此期間我們的view是有可能被移除的(unload),例如當收到低內存警告。在那時候,我們僅僅無視請求曾經開始過的事實。
這種情況可能有點極端,但是這只是我程序的一些防護措施。會考慮這種奇怪的情況的下意識是非常好的,特別是你在后臺做事情。
剩下的塊函數是這樣的:
if ([request responseStatusCode] != 200)
{
howErrorAlert(NSLocalizedString(@"There was an error communicating with the server", nil));
}
else
{
[self userDidJoin];
}
我們檢查了相應的狀態碼(status code)。這是服務器API返回的HTTP狀態碼。如果一切正常,狀態碼是“200 OK”然而,計算機和internet是變化無常的,有時會出錯。例如如果MySQL數據庫掉線了,server API會返回 “500 Server Error” 出現那種情況時,我們會顯示一個alert view。
在創造UIAlertView并且顯示出來,使用ShowErrorAlert函數是很方便的。并且注意我在創建用于顯示的字符串的時候使用了NSLocalizedString。這是一個讓你本地化變得更容易的好習慣。請參看Sean Berry’s tutorial on localization.
如果這里沒有任何錯誤,我們調用userDidJoin方法。這個方法告訴DataModel,用戶成功加入聊天室,并且關閉當前view,回到主屏幕。
因為沒人知道internet會發生什么,我們同樣為請求因為某些原因失敗,設置一個塊函數。經常是因為服務器不可訪問,或者是請求時間過長(time out)導致失敗。
[request setFailedBlock:^
{
if ([self isViewLoaded])
{
[MBProgressHUD hideHUDForView:self.view animated:YES];
ShowErrorAlert([[request error] localizedDescription]);
}
}];
這里隱藏了轉菊花,并用alert view顯示錯誤。
- (IBAction)loginAction
{
...
// REPLACE THIS LINE:
[self userDidJoin];
// WITH:
[self postJoinRequest];
}
最后,我們告訴請求去做他該做的事情。你將要一直使用異步請求來和服務器通訊。請求會需要若干秒來完成,如果使用同步請求,你的程序會在請求的全過程中完全失去響應。并且如果無響應的時間過長,OS會終止掉你的程序。
還是在LoginViewController.m中,在loginAction中進行如下改變: – (NSString*)udid; – (NSString*)deviceToken; – (void)setDeviceToken:(NSString*)token;
事先,我們在用戶點擊Start!之后直接調用userDidJoin。現在不能這樣了,我們只能在服務器請求完成之后才可調用。
如果你足夠仔細,你會發現我們調用了兩個DataModel并沒定義的方法(udid 和 deviceToken)。讓我們添加他們并擺脫編譯器的警告。
在DataModel.h中添加:
- (NSString*)udid; - (NSString*)deviceToken; - (void)setDeviceToken:(NSString*)token;
在DataModel.m @implementation中添加如下代碼:
- (NSString*)udid
{
UIDevice* device = [UIDevice currentDevice];
return [device.uniqueIdentifier stringByReplacingOccurrencesOfString:@"-" withString:@""];
}
這是獲取設備的UDID。但是默認的UDID中間有破折號,但是我們只想讓它的長度固定在40個字符。所以我們剝去破折號(僅供參考:我們的模擬器的device ID 只有32個字符)。
還在DataModel.m中@implementation 之上 添加如下代碼:
static NSString* const DeviceTokenKey = @"DeviceToken";
添加下面的代碼到@implementation 中
- (NSString*)deviceToken
{
return [[NSUserDefaults standardUserDefaults] stringForKey:DeviceTokenKey];
}
- (void)setDeviceToken:(NSString*)token
{
[[NSUserDefaults standardUserDefaults] setObject:token forKey:DeviceTokenKey];
}
這里是initialize方法的小改動。
+ (void)initialize
{
if (self == [DataModel class])
{
[[NSUserDefaults standardUserDefaults] registerDefaults:
[NSDictionary dictionaryWithObjectsAndKeys:
@"", NicknameKey,
@"", SecretCodeKey,
[NSNumber numberWithInt:0], JoinedChatKey,
// 添加了這一行
@"0", DeviceTokenKey,
nil]];
}
}
我們這里做了什么?在setDeviceToken,我們將token存儲在NSUserDefaults字典中。在deviceToken中我們從NSUserDefaults讀取出來。如果你對NSUserDefautls不熟悉,這是一個很簡單但很有用的類,能讓你存儲你app的設置。
initialize方法是用來Objective-C第一次運行DataModel類時調用的方法。我們將初始化的默認值存入NSUserDefaults
我們向默認值中添加了一行,device token 為字符串 0,我一會兒會解釋這為什么是必須的。目前,它代表我們發送JOIN命令到我們的服務器,它使用0為device token代替真實的token
哎,我們花了這么久來講述這些。下一篇教程讓我們編譯運行它,并看它是否正確工作。
總結
以上是生活随笔為你收集整理的Apple推送通知服务教程的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Kaggle-预测降雨量Bi-LSTM模
- 下一篇: 原生js控制控制--弹窗的显示和隐藏