教程:使用 Azure 通知中心向 Xamarin.iOS 应用推送通知Tutorial: Push notifications to Xamarin.iOS apps using Azure Notification Hubs

概述Overview

本教程演示如何使用 Azure 通知中心将推送通知发送到 iOS 应用程序。This tutorial shows you how to use Azure Notification Hubs to send push notifications to an iOS application. 你将创建一个空白 Xamarin.iOS 应用,它使用 Apple Push Notification 服务 (APNs) 接收推送通知。You create a blank Xamarin.iOS app that receives push notifications by using the Apple Push Notification service (APNs).

完成后,你将能够使用通知中心将推送通知广播到运行你的应用的所有设备。When you're finished, you are able to use your notification hub to broadcast push notifications to all the devices running your app. NotificationHubs 应用程序示例中提供了完成的代码。The finished code is available in the NotificationHubs app sample.

在本教程中,你创建/更新代码来执行以下任务:In this tutorial, you create/update code to do the following tasks:

  • 生成证书签名请求文件Generate the certificate signing request file
  • 为推送通知注册应用程序Register your app for push notifications
  • 为应用程序创建配置文件Create a provisioning profile for the app
  • 针对 iOS 推送通知配置通知中心Configure your notification hub for iOS push notifications
  • 发送测试推送通知Send test push notifications

先决条件Prerequisites

  • Azure 订阅Azure subscription. 如果没有 Azure 订阅,可在开始前创建一个试用帐户If you don't have an Azure subscription, create a Trial before you begin.

  • 最新版本的 XcodeLatest version of Xcode

  • iOS 10(或更高版本)兼容设备An iOS 10 (or later version) compatible device

  • Apple 开发人员计划 成员身份。Apple Developer Program membership.

  • Visual Studio for MacVisual Studio for Mac

    Note

    由于 iOS 推送通知配置要求,你必须在物理 iOS 设备(iPhone 或 iPad)而不是在模拟器上部署和测试示例应用程序。Because of configuration requirements for iOS push notifications, you must deploy and test the sample application on a physical iOS device (iPhone or iPad) instead of in the simulator.

只有在完成本教程后,才能完成有关 Xamarin iOS 应用的所有其他通知中心教程。Completing this tutorial is a prerequisite for all other Notification Hubs tutorials for Xamarin.iOS apps.

生成证书签名请求文件Generate the certificate signing request file

Apple Push Notification 服务 (APNS) 使用证书对推送通知进行身份验证。The Apple Push Notification Service (APNS) uses certificates to authenticate your push notifications. 请遵照这些说明来创建用于发送和接收通知的所需推送证书。Follow these instructions to create the necessary push certificate to send and receive notifications. 有关这些概念的详细信息,请参阅正式的 Apple Push Notification 服务文档。For more information on these concepts, see the official Apple Push Notification Service documentation.

生成证书签名请求 (CSR) 文件,Apple 将使用该文件生成签名的推送证书。Generate the Certificate Signing Request (CSR) file, which is used by Apple to generate a signed push certificate.

  1. 在 Mac 上,运行 Keychain Access 工具。On your Mac, run the Keychain Access tool. 可以从启动板上的“Utilities”或“Other”文件夹中打开该工具。It can be opened from the Utilities folder or the Other folder on the launch pad.

  2. 单击“Keychain Access”,展开“Certificate Assistant”(证书助理),并单击“Request a Certificate from a Certificate Authority...”(从证书颁发机构请求证书...)。Click Keychain Access, expand Certificate Assistant, then click Request a Certificate from a Certificate Authority....

    使用 Keychain Access 请求新证书

  3. 选择“用户电子邮件地址”和“公用名称”,确保已选择“保存到磁盘”,并单击“继续”。Select your User Email Address and Common Name, make sure that Saved to disk is selected, and then click Continue. 将“CA Email Address”(CA 电子邮件地址)字段保留空白,因为它不是必填字段 。Leave the CA Email Address field blank as it is not required.

    所需证书信息

  4. 在“Save As”(另存为)中为证书签名请求 (CSR) 文件键入一个名称,在“Where”(位置)中选择一个位置,并单击“Save”(保存)。Type a name for the Certificate Signing Request (CSR) file in Save As, select the location in Where, then click Save.

    为证书选择一个文件名

    此操作会将 CSR 文件保存到选定位置;默认位置是桌面。This action saves the CSR file in the selected location; the default location is in the Desktop. 请记住为此文件选择的位置。Remember the location chosen for the file.

接下来,将要向 Apple 注册应用、启用推送通知并上传导出的 CSR 以创建一个推送证书。Next, you register your app with Apple, enable push notifications, and upload the exported CSR to create a push certificate.

为推送通知注册应用程序Register your app for push notifications

要将推送通知发送到 iOS 应用程序,你必须向 Apple 注册应用程序,还要注册推送通知。To be able to send push notifications to an iOS app, you must register your application with Apple and also register for push notifications.

  1. 如果尚未注册应用程序,请导航到 Apple 开发人员中心的 iOS 设置门户,使用 Apple ID 登录,单击“Identifiers”(标识符),然后单击“App IDs”(应用 ID),最后单击“+”号注册新的应用。If you have not already registered your app, navigate to the iOS Provisioning Portal at the Apple Developer Center, sign in with your Apple ID, click Identifiers, then click App IDs, and finally click on the + sign to register a new app.

    iOS 预配门户应用 ID 页

  2. 更新新应用的以下三个字段,并单击“Continue”(继续): Update the following three fields for your new app and then click Continue:

    • 名称:在“App ID Description”(应用 ID 说明)部分的“Name”(名称)字段中为应用键入一个描述性名称。Name: Type a descriptive name for your app in the Name field in the App ID Description section.

    • Bundle Identifier(捆绑标识符):在“Explicit App ID”(显式应用 ID)部分下,使用应用分发指南中所述的 <Organization Identifier>.<Product Name> 格式输入“Bundle Identifier”(捆绑标识符)。Bundle Identifier: Under the Explicit App ID section, enter a Bundle Identifier in the form <Organization Identifier>.<Product Name> as mentioned in the App Distribution Guide. 使用的“Organization Identifier”(组织标识符)和“Product Name”(产品名称)必须与在创建 XCode 项目时使用的组织标识符与产品名称匹配。The Organization Identifier and Product Name you use must match the organization identifier and product name you use when you create your XCode project. 在下面的屏幕截图中,NotificationHubs 用作组织标识符,GetStarted 用作产品名称。In the following screenshot NotificationHubs is used as an organization identifier and GetStarted is used as the product name. 如果确保此值与在 XCode 项目中使用的值匹配,则就可以在 XCode 中使用正确的发布配置文件。Making sure this value matches the value you use in your XCode project allows you to use the correct publishing profile with XCode.

    • Push Notifications(推送通知):在“App Services”(应用程序服务)部分选中“Push Notifications”(推送通知)选项。Push Notifications: Check the Push Notifications option in the App Services section.

      用于注册新应用 ID 的窗体

      此操作会生成应用 ID 并请求你确认信息。This action generates your App ID and requests you to confirm the information. 单击“Register”(注册)确认新的应用 ID。Click Register to confirm the new App ID.

      单击“注册”后,会看到“注册已完成”屏幕,如下图所示。Once you click Register, you see the Registration complete screen, as shown in the following image. 单击“Done”(完成) 。Click Done.

      应用 ID 注册完成,显示了权利

  3. 在开发人员中心的“App IDs”(应用 ID)下,找到创建的应用 ID,然后单击其所在行。In the Developer Center, under App IDs, locate the app ID that you created, and click on its row.

    应用 ID 列表

    单击应用 ID 会显示应用详细信息。Clicking on the app ID displays the app details. 单击底部的“Edit”(编辑)按钮。Click the Edit button at the bottom.

    编辑应用 ID 页

  4. 滚动到屏幕底部并单击“Development Push SSL Certificate”(开发推送 SSL 证书 )部分下的“Create Certificate...”(创建证书...)按钮。Scroll to the bottom of the screen, and click the Create Certificate... button under the section Development Push SSL Certificate.

    “为应用 ID 创建证书”按钮

    将显示“添加 iOS 证书”助手。You see the Add iOS Certificate assistant.

    Note

    本教程使用开发证书。This tutorial uses a development certificate. 注册生产证书时使用相同的过程。The same process is used when registering a production certificate. 只需确保在发送通知时使用相同的证书类型。Just make sure that you use the same certificate type when sending notifications.

  5. 单击“Choose File”(选择文件),浏览到在第一个任务中创建的 CSR 文件的保存位置,然后单击“Generate”(生成)。Click Choose File, browse to the location where you saved the CSR file that you created in the first task, then click Generate.

    已生成证书的 CSR 上传页

  6. 门户创建证书之后,单击“Download”(下载)按钮,然后单击“Done”(完成)。After the certificate is created by the portal, click the Download button, and click Done.

    已生成证书的下载页

    这将下载证书并将其保存到计算机上的 Downloads 文件夹。It downloads the certificate and saves it to your computer in your Downloads folder.

    在 Downloads 文件夹中找到证书文件

    Note

    默认情况下,下载的文件(开发证书)名为 aps_development.cer。By default, the downloaded file a development certificate is named aps_development.cer.

  7. 双击下载的推送证书 aps_development.cerDouble-click the downloaded push certificate aps_development.cer.

    此操作将在密钥链中安装新证书,如下图所示:This action installs the new certificate in the Keychain, as shown in the following image:

    Keychain Access 证书列表,显示了新证书

    Note

    证书中的名称可能会不同,但将以 Apple Development iOS Push Services 作为前缀。The name in your certificate might be different, but it will be prefixed with Apple Development iOS Push Services.

  8. 在 Keychain Access 中,右键单击在“Certificates”(证书)类别中创建的新推送证书。In Keychain Access, right-click the new push certificate that you created in the Certificates category. 单击“导出”,为文件命名,选择“.p12”格式,并单击“保存”。Click Export, name the file, select the .p12 format, and then click Save.

    将证书作为 p12 格式导出

    记下导出的 .p12 证书的文件名和位置。Make a note of the file name and location of the exported .p12 certificate. 它用于启用 APNS 身份验证。It is used to enable authentication with APNS.

    Note

    本教程创建 QuickStart.p12 文件。This tutorial creates a QuickStart.p12 file. 文件名和位置可能不同。Your file name and location might be different.

为应用程序创建配置文件Create a provisioning profile for the app

  1. 返回 iOS 预配门户,选择“Provisioning Profiles”(预配配置文件),选择“All”(全部),并单击 +(加号)按钮创建一个新的配置文件。Back in the iOS Provisioning Portal, select Provisioning Profiles, select All, and then click the + (plus) button to create a new profile. 将显示“添加 iOS 预配配置文件”向导:You see the Add iOS Provisioning Profile wizard:

    预配配置文件列表

  2. 选择“开发”下的“iOS 应用程序开发”作为预配配置文件类型,并单击“继续”。Select iOS App Development under Development as the provisioning profile type, and click Continue.

  3. 接下来,从“App ID”(应用 ID)下拉列表中选择创建的应用 ID,并单击“Continue”(继续)Next, select the app ID you created from the App ID drop-down list, and click Continue

    选择应用 ID

  4. 在“Select certificates”(选择证书)屏幕中,选择经常用于代码签名的开发证书,然后单击“Continue”(继续)。In the Select certificates screen, select your usual development certificate used for code signing, and click Continue. 此证书不是所创建的推送证书。This certificate is not the push certificate you created.

    选择证书

  5. 接下来,选择要用于测试的“Devices”(设备),并单击“Continue”(继续)。Next, select the Devices to use for testing, and click Continue

    选择设备

  6. 最后,在“Profile Name”(配置文件名称)中为配置文件选取一个名称,并单击“Generate”(生成)。Finally, pick a name for the profile in Profile Name, click Generate.

    选择预配配置文件名称

  7. 创建新的预配配置文件后,请单击下载该文件,并将其安装在 Xcode 开发计算机上。When the new provisioning profile is created click to download it and install it on your Xcode development machine. 然后单击“完成”。Then click Done.

    下载预配配置文件

针对 iOS 推送通知配置通知中心Configure your notification hub for iOS push notifications

本部分介绍如何执行相关步骤,以便使用以前创建的 .p12 推送证书创建新的通知中心并配置 APNs 身份验证。This section walks you through the steps to create a new notification hub and configure authentication with APNs using the .p12 push certificate that you previously created. 如果想要使用已创建的通知中心,可以跳到步骤 5。If you want to use a notification hub that you have already created, you can skip to step 5.

  1. 登录到 Azure 门户Sign in to the Azure portal.

  2. 在左侧菜单上选择“所有服务”,然后在“移动”部分中选择“通知中心”。Select All services on the left menu, and select Notification Hubs in the Mobile section. 选择服务名称旁边的星星 (*) 以将其添加到左侧菜单上的“收藏夹”部分。Select star (*) next to the service name to add it to the FAVORITES section on the left menu. 在将“通知中心”添加到“收藏夹”之后,在菜单上选择它。After Notification Hubs is added to FAVORITES, select it on the left menu.

    Azure 门户 - 选择“通知中心”

  3. 在“通知中心”页面上,在工具栏上选择“添加”。On the Notification Hubs page, select Add on the toolbar.

    通知中心 -“添加”工具栏按钮

  4. 在“通知中心”页面上,执行以下步骤:On the Notification Hub page, do the following steps:

    1. 为通知中心指定一个名称。Specify a name for the notification hub.

    2. 为命名空间指定一个名称。Specify a name for the namespace. 命名空间包含一个或多个中心。A namespace contains one or more hubs.

    3. 选择要在其中创建通知中心的位置。Select a location in which you want to create the notification hub.

    4. 选择一个现有资源组,或者为新资源组输入一个名称。Select an existing resource group or enter a name for the new resource group.

    5. 选择“创建” 。Select Create.

      Azure 门户 - 设置通知中心属性

  5. 选择“通知”(钟形图标),然后选择“转到资源”。Select Notifications (Bell icon), and select Go to resource. 还可以刷新“通知中心”页中的列表,然后选择通知中心。You can also refresh the list in the Notification Hubs page, and select your notification hub.

    Azure 门户 - 通知 -> 转到资源

  6. 从列表中选择“访问策略”。Select Access Policies from the list. 记下向你提供的两个连接字符串。Note the two connection strings that are available to you. 稍后在处理推送通知时需要它们。You need them to handle push notifications later.

    Important

    在应用程序中使用 DefaultFullSharedAccessSignature。Do NOT use the DefaultFullSharedAccessSignature in your application. 这只能在后端使用。This is meant to be used in your back-end only.

    Azure 门户 - 通知中心连接字符串

针对 iOS 设置配置通知中心Configure iOS settings for the notification hub

  1. 在“通知设置”组中选择“Apple (APNS)”。 Select Apple (APNS) in the NOTIFICATION SETTINGS group.

  2. 选择“证书”,单击文件图标,然后选择此前导出的 .p12 文件。 Select Certificate, click the file icon, and select the .p12 file that you exported earlier.

  3. 指定证书的密码。 Specify the password for the certificate.

  4. 选择“沙盒” 模式。Select Sandbox mode. 仅当希望将推送通知发送给从应用商店购买应用的用户时,才应使用“生产”模式。 Use the Production mode only if you want to send push notifications to users who purchased your app from the store.

    在 Azure 门户中配置 APNs

    在 Azure 门户中配置 APNs 证书

通知中心现在已配置为使用 APNs,并且你有连接字符串用于注册应用和发送推送通知。Your notification hub is now configured to work with APNs, and you have the connection strings to register your app and send push notifications.

将应用连接到通知中心Connect your app to the notification hub

创建新项目Create a new project

  1. 在 Visual Studio 中创建新的 iOS 项目并选择“单视图应用”模板,然后单击“下一步” In Visual Studio, create a new iOS project and select the Single View App template, and click Next

    Visual Studio - 选择应用程序类型

  2. 输入应用名称和组织标识符,然后单击“下一步”和“创建”。 Enter your App Name and Organization identifier, then click Next, then Create

  3. 在“解决方案”视图中双击“Info.plist”, 确保“标识”下 的捆绑标识符与创建预配配置文件时使用的相符。From the Solution view, double-click Info.plist and under Identity make sure your Bundle Identifier matches the one used when creating your provisioning profile. 在“签名”下,确保 选中开发人员帐户;在“团队”下,确保选中“自动管理签名”。这样就会自动选中签名证书和预配配置文件。 Under Signing ensure that your Developer account is selected under Team, "Automatically manage signing" is selected and your Signing Certificate and Provisioning Profile are automatically selected.

    Visual Studio- iOS 应用配置

  4. 在“解决方案”视图中双击 Entitlements.plist,确保选中“启用推送通知”。 From the Solution view, double-click the Entitlements.plist and ensure that Enable Push Notifications is checked.

    Visual Studio - iOS 授权配置

  5. 添加 Azure 消息传送包。Add the Azure Messaging package. 在“解决方案”视图中右键单击项目,然后选择“添加” > “添加 NuGet 包”。In the Solution view, right-click the project and select Add > Add NuGet Packages. 搜索 Xamarin.Azure.NotificationHubs.iOS,向项目添加该包。Search for Xamarin.Azure.NotificationHubs.iOS and add the package to your project.

  6. 向类添加新文件,将其命名为 Constants.cs,然后添加以下变量,将字符串文本占位符替换为此前记下的 hubnameDefaultListenSharedAccessSignatureAdd a new file to your class, name it Constants.cs and add the following variables and replace the string literal placeholders with the hubname and the DefaultListenSharedAccessSignature noted earlier.

    // Azure app-specific connection string and hub path
    public const string ListenConnectionString = "<Azure DefaultListenSharedAccess Connection String>";
    public const string NotificationHubName = "<Azure Notification Hub Name>";
    
  7. AppDelegate.cs 中添加以下 using 语句:In AppDelegate.cs, add the following using statement:

    using WindowsAzure.Messaging;
    using UserNotifications
    
  8. 声明 SBNotificationHub 的实例:Declare an instance of SBNotificationHub:

    private SBNotificationHub Hub { get; set; }
    
  9. AppDelegate.cs 中更新 FinishedLaunching(),使之与以下代码匹配:In AppDelegate.cs, update FinishedLaunching() to match the following code:

    public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
    {
        if (UIDevice.CurrentDevice.CheckSystemVersion(10, 0))
        {
            UNUserNotificationCenter.Current.RequestAuthorization(UNAuthorizationOptions.Alert | UNAuthorizationOptions.Sound | UNAuthorizationOptions.Sound,
                                                                    (granted, error) =>
            {
                if (granted)
                    InvokeOnMainThread(UIApplication.SharedApplication.RegisterForRemoteNotifications);
            });
        } else if (UIDevice.CurrentDevice.CheckSystemVersion (8, 0)) {
            var pushSettings = UIUserNotificationSettings.GetSettingsForTypes (
                    UIUserNotificationType.Alert | UIUserNotificationType.Badge | UIUserNotificationType.Sound,
                    new NSSet ());
    
            UIApplication.SharedApplication.RegisterUserNotificationSettings (pushSettings);
            UIApplication.SharedApplication.RegisterForRemoteNotifications ();
        } else {
            UIRemoteNotificationType notificationTypes = UIRemoteNotificationType.Alert | UIRemoteNotificationType.Badge | UIRemoteNotificationType.Sound;
            UIApplication.SharedApplication.RegisterForRemoteNotificationTypes (notificationTypes);
        }
    
        return true;
    }
    
  10. AppDelegate.cs 中重写 RegisteredForRemoteNotifications() 方法:In AppDelegate.cs, override the RegisteredForRemoteNotifications() method:

    public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
    {
        Hub = new SBNotificationHub(Constants.ListenConnectionString, Constants.NotificationHubName);
    
        Hub.UnregisterAllAsync (deviceToken, (error) => {
            if (error != null)
            {
                System.Diagnostics.Debug.WriteLine("Error calling Unregister: {0}", error.ToString());
                return;
            }
    
            NSSet tags = null; // create tags if you want
            Hub.RegisterNativeAsync(deviceToken, tags, (errorCallback) => {
                if (errorCallback != null)
                    System.Diagnostics.Debug.WriteLine("RegisterNativeAsync error: " + errorCallback.ToString());
            });
        });
    }
    
  11. AppDelegate.cs 中重写 ReceivedRemoteNotification() 方法:In AppDelegate.cs, override the ReceivedRemoteNotification() method:

    public override void ReceivedRemoteNotification(UIApplication application, NSDictionary userInfo)
    {
        ProcessNotification(userInfo, false);
    }
    
  12. AppDelegate.cs 中创建 ProcessNotification() 方法:In AppDelegate.cs, create the ProcessNotification() method:

    void ProcessNotification(NSDictionary options, bool fromFinishedLaunching)
    {
        // Check to see if the dictionary has the aps key.  This is the notification payload you would have sent
        if (null != options && options.ContainsKey(new NSString("aps")))
        {
            //Get the aps dictionary
            NSDictionary aps = options.ObjectForKey(new NSString("aps")) as NSDictionary;
    
            string alert = string.Empty;
    
            //Extract the alert text
            // NOTE: If you're using the simple alert by just specifying
            // "  aps:{alert:"alert msg here"}  ", this will work fine.
            // But if you're using a complex alert with Localization keys, etc.,
            // your "alert" object from the aps dictionary will be another NSDictionary.
            // Basically the JSON gets dumped right into a NSDictionary,
            // so keep that in mind.
            if (aps.ContainsKey(new NSString("alert")))
                alert = (aps [new NSString("alert")] as NSString).ToString();
    
            //If this came from the ReceivedRemoteNotification while the app was running,
            // we of course need to manually process things like the sound, badge, and alert.
            if (!fromFinishedLaunching)
            {
                //Manually show an alert
                if (!string.IsNullOrEmpty(alert))
                {
                    UIAlertView avAlert = new UIAlertView("Notification", alert, null, "OK", null);
                    avAlert.Show();
                }
            }
        }
    }
    

    Note

    可以选择重写 FailedToRegisterForRemoteNotifications() 以处理无网络连接等情况。You can choose to override FailedToRegisterForRemoteNotifications() to handle situations such as no network connection. 如果用户可能会在脱机模式(例如飞行模式)下启动应用程序,并且你想要处理应用特定的推送消息传送方案,则此操作特别重要。This is especially important where the user might start your application in offline mode (for example, Airplane) and you want to handle push messaging scenarios specific to your app.

  13. 在设备上运行应用程序。Run the app on your device.

发送测试推送通知Send test push notifications

可以在 Azure 门户中使用“测试性发送”选项,在应用中测试通知的发送。You can test receiving notifications in your app with the Test Send option in the Azure portal. 它会向设备发送测试性的推送通知。It sends a test push notification to your device.

Azure 门户 - 测试性发送

通常,推送通知是在后端服务(例如,Mobile Apps,或者使用兼容库的 ASP.NET)中发送的。Push notifications are normally sent in a back-end service like Mobile Apps or ASP.NET using a compatible library. 如果后端没有可用库,也可使用 REST API 直接发送通知消息。If a library is not available for your back-end, you can also use the REST API directly to send notification messages.

后续步骤Next steps

本教程介绍了如何将广播通知发送到所有注册到后端的 iOS 设备。In this tutorial, you sent broadcast notifications to all your iOS devices registered with the backend. 若要了解如何向特定的 iOS 设备推送通知,请转到以下教程:To learn how to push notifications to specific iOS devices, advance to the following tutorial: