您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 遠程推送原理與完整實現流程(含證書配置全過程)

編輯:iOS 開發綜合

推送通知幾乎是現代 App 的標配。iOS 的遠程推送背後有一整套由蘋果托管的服務在運轉,理解它的工作原理,比死記 API 更重要。本文從 APNs 的職責講起,再逐步走完證書申請、App ID 配置、代碼註冊與 Java 服務端發送的完整鏈路。

零、前期準備

做遠程推送必須有付費的蘋果開發者賬號——免費賬號無法使用推送能力。有了賬號之後,登錄蘋果開發者網站配置推送相關證書並下載,供後續使用。具體步驟見下文。

一、iOS 推送通知的基本原理

蘋果的推送服務由專門的服務器 APNs(Apple Push Notification service)承擔。整個流程是:APNs 接收我們自己的應用服務器發出的消息,把它推送到指定的 iOS 設備,再由設備通知到設備上的 App,最終以橫幅、聲音或角標的形式呈現給用戶。

遠程推送能成立的前提是註冊:裝有我們 App 的 iOS 設備需要向 APNs 註冊,註冊成功後 APNs 會返回一個 deviceToken。我們拿到這個 token,把它上報給自己的應用服務器。此後需要推送時,服務器按指定格式打包消息,並帶上目標設備的 deviceToken 一起發給 APNs。

同時,App 與 APNs 之間會維持一條基於 TCP 的長連接,新消息通過這條通道下發到設備並顯示出來。

二、設備註冊 APNs 的流程

上圖包含四個步驟:

  1. Device 攜帶設備序列號(UUID)連接 APNs 服務器;
  2. 連接成功後,APNs 經過打包與處理生成 deviceToken,返回給該設備;
  3. Device 把拿到的 deviceToken 發送給我們自己的應用服務器;
  4. 至此,該設備在 APNs 與我們的服務器兩側都完成了註冊。

三、推送過程

  1. 設備安裝了具備推送能力的 App(需在代碼中主動註冊),上網時會連接 APNs;連接過程中 APNs 會校驗 deviceToken,成功後維持一條基於 TCP 的長連接;
  2. Provider(我們自己的應用服務器)收到待推送的消息,結合目標設備的 deviceToken 打包後發給 APNs;
  3. APNs 把推送信息下發給指定 deviceToken 的 iOS 設備;
  4. 設備收到後通知 App,並以聲音、彈窗等形式提示用戶。

更直觀的一張流程圖:

四、信息包結構

這是 Provider 發給 APNs 的二進制結構。APNs 校驗其正確性並提取信息後,再把消息轉發到目標設備。結構包含五個部分:命令標識符、deviceToken 的長度、deviceToken 字符串、Payload 的長度,以及最後真正的消息內容。

五、Payload(消息體)結構

{
    "aps": {
        "alert": "聽雲給您發送了新消息",
        "badge": 1,
        "sound": "default"
    }
}

這是一個 JSON 結構。alert 是顯示在用戶手機上的文案;badge 是 App 圖標右上角顯示的數字(注意必須是整數),常用來標示未讀數量;sound 指定送達時播放的聲音,填 default 表示使用系統默認提示音。此外還可以通過 content-available 實現靜默推送(喚醒 App 但不彈任何提示)。

六、證書與配置的完整步驟

步驟 1:新建 CSR 請求文件

在「應用程序 → 實用工具」中找到鑰匙串訪問,選擇「證書頒發機構 → 從證書頒發機構請求證書」。

注意:郵箱地址填自己的開發者賬號郵箱;常用名隨便填一個自己能記住的即可;然後選擇「存儲到磁盤」,一路繼續。

選擇保存位置(這裡示例存到名為 tingyun 的文件夾),點擊「存儲」。

完成後可以在該文件夾中看到 CertificateSigningRequest.certSigningRequest,這就是我們說的 CSR 文件。同時,鑰匙串訪問中會生成一對密鑰,名稱即為剛纔填寫的常用名。

步驟 2:配置 App ID

登錄 https://developer.apple.com,點擊 Account。

選擇 Certificates, Identifiers & Profiles。

進入 Identifiers → App IDs,點擊右上角的 + 號新建一個 App ID。

Name 填 App 名字即可;App ID Suffix 選擇不使用通配符的 Explicit App ID;Bundle ID 必須與自己 App 的 Bundle Identifier 完全一致。

在下方 App Services 列表中,勾選 Push Notifications,然後 Continue。

步驟 3:創建推送證書

證書要建兩套:開發(Development / Sandbox)用於測試,發布(Production)用於上線。

先建開發證書:選擇 Development,點右上角 + 號。

選擇 Apple Push Notification service SSL (Sandbox),點 Continue。

App ID 選擇剛纔創建的那個,Continue。

點擊 Choose File,選擇步驟 1 生成的 CSR 文件,然後 Generate。

最後下載證書並存到指定位置。

 

發布證書的創建流程完全相同,只是在 Production 環境下選擇 Apple Push Notification service SSL (Production)。

步驟 4:添加測試設備(Devices)

先選中要添加的設備類型,然後點擊左上角 + 號。

 

Name 填一個好辨識的設備名;UDID 填需要加入測試的真機 UDID,然後 Continue。

點擊 Register 完成註冊。

 

最後 Done。

 

步驟 5:查看設備 UDID

用數據線把 iOS 設備連到電腦,打開 iTunes。在設備摘要頁可以看到「序列號」,點擊它會切換顯示為 UDID(再點一次可複製)。

 

步驟 6:生成 Provisioning Profile(配置文件)

配置文件同樣分開發與發布兩種,兩者都需要生成。先建開發用的:選擇 Provisioning Profiles → Development,點右上角 + 號。

 

選擇 iOS App Development,Continue。

App ID 仍選剛纔創建的那個。

 

選擇開發者證書;如果不確定是哪一個,全選即可。

 

勾選允許調試的測試設備;若列表為空,回到前面的 Devices 添加。

 

取一個好辨識的名字,然後 Generate 並下載。

 

發布配置文件的做法一樣,只是在 Distribution 下選擇 Ad Hoc(或 App Store),後續步驟相同。

 

 

七、客戶端代碼:註冊推送並接收

打開 AppDelegate.m,在 didFinishLaunchingWithOptions: 中註冊:

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    /** 消息推送註冊 */
    if ([UIDevice currentDevice].systemVersion.floatValue >= 8.0) {
        UIUserNotificationSettings *settings =
        [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeBadge |
                                              UIUserNotificationTypeSound |
                                              UIUserNotificationTypeAlert
                                          categories:nil];
        [application registerUserNotificationSettings:settings];
        [application registerForRemoteNotifications];
    } else {
        [application registerForRemoteNotificationTypes:(UIRemoteNotificationTypeBadge |
                                                         UIRemoteNotificationTypeSound |
                                                         UIRemoteNotificationTypeAlert)];
    }
    return YES;
}

// 註冊成功:APNs 返回設備唯一標識
// 注意:首次運行時這個回調可能來得比較慢
- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    // 轉成字符串以便後續上報服務器
    NSString *token = [deviceToken description];
    NSLog(@"description %@", token);
}

// 收到遠程推送時觸發
- (void)application:(UIApplication *)application
    didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    NSLog(@"userInfo == %@", userInfo);
}

// 註冊失敗
- (void)application:(UIApplication *)application
    didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
    NSLog(@"註冊失敗 %@", error);
}

實務上要注意兩點:一是 [deviceToken description] 得到的字符串帶有空格與尖括號,上報服務器前建議自己格式化為純 64 位十六進制字符串;二是 iOS 10 之後引進了 UNUserNotificationCenter,UIUserNotificationSettings 這套 API 已漸被取代。

八、服務端:導出 .p12 證書

打開前面下載的證書,在鑰匙串訪問中找到它。

 

右鍵選擇「導出」。

 

導出為 .p12 文件並保存,過程中需要設置一組密碼——Java 服務端發送推送時會用到它。

 

此外還需要 Java 服務端所需的 jar 包(JavaPNS 等)。

九、Java 服務端發送代碼

import javapns.back.PushNotificationManager;
import javapns.back.SSLConnectionHelper;
import javapns.data.Device;
import javapns.data.PayLoad;

public class pushService {
    public static void main(String[] args) {
        try {
            String deviceToken = "eab6df47eb4f81e0aaa93bb208cffd7dc3884fd346ea0743fcf93288018cfcb6";

            PayLoad payLoad = new PayLoad();
            payLoad.addAlert("測試我的 push 消息");
            payLoad.addBadge(1);
            payLoad.addSound("default");

            PushNotificationManager pushManager = PushNotificationManager.getInstance();
            pushManager.addDevice("iphone", deviceToken);

            // 測試服務器地址:gateway.sandbox.push.apple.com,端口 2195
            // 生產服務器地址:gateway.push.apple.com,端口 2195
            String host = "gateway.sandbox.push.apple.com";
            int port = 2195;

            // 剛纔在 Mac 上導出的證書及其密碼
            String certificatePath     = "/Users/hsw/Desktop/PushTest/PushTest.p12";
            String certificatePassword = "123456";

            pushManager.initializeConnection(host, port,
                                             certificatePath,
                                             certificatePassword,
                                             SSLConnectionHelper.KEYSTORE_TYPE_PKCS12);

            Device client = pushManager.getDevice("iphone");
            pushManager.sendNotification(client, payLoad);

            pushManager.stopConnection();
            pushManager.removeDevice("iphone");
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("push faild!");
            return;
        }
        System.out.println("push succeed!");
    }
}

十、實戰中容易踩的坑

  • Sandbox 與 Production 證書不能混用。測試包(Debug / Ad Hoc)必須對應 gateway.sandbox.push.apple.com 與開發證書;App Store 發布包則對應生產地址與生產證書。混用時常表現為「代碼報成功但設備收不到」。
  • Bundle ID 必須完全一致,包括大小寫。App ID 若使用了通配符,推送能力無法開啟。
  • deviceToken 會變。系統更新、重裝 App、恢復備份都可能導致 token 變化,因此每次啟動註冊並把最新 token 同步給服務器是必要的,不能只在首次安裝時上報。
  • 模擬器無法收到遠程推送(早期版本),必須用真機測試。
  • 證書有有效期(通常一年),到期前需重新生成並更新到服務器,否則推送會突然全部失敗。

以上就是 iOS 遠程推送從原理到落地的完整過程。理解了「設備註冊拿 token → token 上報自有服務器 → 服務器帶證書與 token 請求 APNs → APNs 通過長連接下發」這條主線,換用任何推送服務商或任何服務端語言,思路都是一致的。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved