Hinzufügen von Pushbenachrichtigungen zu Ihrer iOS-App

Artikel
06/25/2019

Überblick

In diesem Lernprogramm fügen Sie dem iOS-Schnellstart Projekt Pushbenachrichtigungen hinzu, sodass bei jedem Einfügen eines Datensatzes eine Pushbenachrichtigung an das Gerät gesendet wird.

Wenn Sie das heruntergeladene Schnellstartserverprojekt nicht verwenden, benötigen Sie das Paket für die Pushbenachrichtigungserweiterung. Weitere Informationen finden Sie im Handbuch Arbeiten mit dem .NET-Back-End-Server-SDK für Azure Mobile Apps Handbuch.

Der iOS-Simulator unterstützt keine Pushbenachrichtigungen. Sie benötigen ein physisches iOS-Gerät und eine Apple Developer Program-Mitgliedschaft.

Konfigurieren des Benachrichtigungshubs

Das Feature "Mobile Apps" von Azure App Service verwendet Azure Notification Hubs zum Senden von Pushs, sodass Sie einen Benachrichtigungshub für Ihre mobile App konfigurieren.

Wechseln Sie im Azure-Portalzu App Services, und wählen Sie dann Ihr App-Back-End aus. Wählen Sie unter Einstellungendie Option Pushaus.
Um der App eine Benachrichtigungshubressource hinzuzufügen, wählen Sie Verbindenaus. Sie können entweder einen Hub erstellen oder eine Verbindung mit einem vorhandenen herstellen.

Jetzt haben Sie einen Benachrichtigungshub mit Ihrem Back-End-Projekt für mobile Apps verbunden. Später konfigurieren Sie diesen Benachrichtigungshub so, dass eine Verbindung mit einem Plattformbenachrichtigungssystem (PNS) hergestellt wird, um auf Geräte zu übertragen.

Registrieren der App für Pushbenachrichtigungen

Registrieren Sie eine App-ID für Ihre App. Erstellen Sie eine explizite App-ID (keine Wildcard-App-ID), und verwenden Sie für Bundle-IDdie genaue Bündel-ID, die sich in Ihrem Xcode-Schnellstartprojekt befindet. Es ist auch wichtig, dass Sie die Option Push-Benachrichtigungen auswählen.
Als Nächstes , um die Konfiguration von Pushbenachrichtigungenvorzubereiten, erstellen Sie entweder ein SSL-Zertifikat "Entwicklung" oder "Verteilung".

Konfigurieren von Azure zum Senden von Pushbenachrichtigungen

Starten Sie auf Ihrem Mac Keychain Access. Öffnen Sie auf der linken Navigationsleiste unter KategorieMeine Zertifikate. Suchen Sie das SSL-Zertifikat, das Sie im vorherigen Abschnitt heruntergeladen haben, und geben Sie dann deren Inhalte offen. Wählen Sie nur das Zertifikat aus (nicht den privaten Schlüssel auswählen). dannexportieren.
Wählen Sie im Azure-PortalAlle>App Services-durchsuchen aus. Wählen Sie dann Ihr Mobile Apps-Back-End aus.
Unter Einstellungenwählen Sie App Service Push-aus. Wählen Sie dann Ihren Benachrichtigungshubnamen aus.
Wechseln Sie zu Apple Push Notification Services>Hochladen des Zertifikats. Laden Sie die .p12-Datei hoch, und wählen Sie den richtigen Modus aus (je nachdem, ob Ihr Client-SSL-Zertifikat zuvor für die Produktion oder die Sandbox verwendet wurde). Speichern Sie alle Änderungen.

Ihr Dienst ist jetzt für die Arbeit mit Pushbenachrichtigungen unter iOS konfiguriert.

Aktualisieren des Back-End zum Senden von Pushbenachrichtigungen

.NET Backend (C#):

Klicken Sie in Visual Studio mit der rechten Maustaste auf das Serverprojekt, und klicken Sie auf NuGet-Pakete verwalten, suchen Sie nach Microsoft.Azure.NotificationHubs, und klicken Sie dann auf Installieren. Dadurch wird die Benachrichtigungshubs-Bibliothek zum Senden von Benachrichtigungen aus Ihrem Back-End installiert.
Öffnen Sie im Visual Studio-Projekt des Backends Controllers>TodoItemController.cs. Fügen Sie oben in der Datei die folgende using Anweisung hinzu:
```
using Microsoft.Azure.Mobile.Server.Config;
using Microsoft.Azure.NotificationHubs;
```

Ersetzen Sie die PostTodoItem-Methode durch folgenden Code:

public async Task<IHttpActionResult> PostTodoItem(TodoItem item)
{
    TodoItem current = await InsertAsync(item);
    // Get the settings for the server project.
    HttpConfiguration config = this.Configuration;

    MobileAppSettingsDictionary settings = 
        this.Configuration.GetMobileAppSettingsProvider().GetMobileAppSettings();

    // Get the Notification Hubs credentials for the Mobile App.
    string notificationHubName = settings.NotificationHubName;
    string notificationHubConnection = settings
        .Connections[MobileAppSettingsKeys.NotificationHubConnectionString].ConnectionString;

    // Create a new Notification Hub client.
    NotificationHubClient hub = NotificationHubClient
    .CreateClientFromConnectionString(notificationHubConnection, notificationHubName);

    // iOS payload
    var appleNotificationPayload = "{\"aps\":{\"alert\":\"" + item.Text + "\"}}";

    try
    {
        // Send the push notification and log the results.
        var result = await hub.SendAppleNativeNotificationAsync(appleNotificationPayload);

        // Write the success result to the logs.
        config.Services.GetTraceWriter().Info(result.State.ToString());
    }
    catch (System.Exception ex)
    {
        // Write the failure result to the logs.
        config.Services.GetTraceWriter()
            .Error(ex.Message, null, "Push.SendAsync Error");
    }
    return CreatedAtRoute("Tables", new { id = current.Id }, current);
}

Veröffentlichen Sie das Serverprojekt erneut.

Node.js Backend

Richten Sie Ihr Back-End-Projekt ein.

Ersetzen Sie das Tabellenskript todoitem.js durch den folgenden Code:

var azureMobileApps = require('azure-mobile-apps'),
    promises = require('azure-mobile-apps/src/utilities/promises'),
    logger = require('azure-mobile-apps/src/logger');

var table = azureMobileApps.table();

// When adding record, send a push notification via APNS
table.insert(function (context) {
    // For details of the Notification Hubs JavaScript SDK, 
    // see https://aka.ms/nodejshubs
    logger.info('Running TodoItem.insert');

    // Create a payload that contains the new item Text.
    var payload = "{\"aps\":{\"alert\":\"" + context.item.text + "\"}}";

    // Execute the insert; Push as a post-execute action when results are returned as a Promise.
    return context.execute()
        .then(function (results) {
            // Only do the push if configured
            if (context.push) {
                context.push.apns.send(null, payload, function (error) {
                    if (error) {
                        logger.error('Error while sending push notification: ', error);
                    } else {
                        logger.info('Push notification sent successfully!');
                    }
                });
            }
            return results;
        })
        .catch(function (error) {
            logger.error('Error while running context.execute: ', error);
        });
});

module.exports = table;

Wenn Sie die Datei auf Ihrem lokalen Computer bearbeiten, veröffentlichen Sie das Serverprojekt erneut.

Hinzufügen von Pushbenachrichtigungen zur App

Objective-C:

Importieren Sie in QSAppDelegate.mdas iOS SDK und QSTodoService.h:

#import <MicrosoftAzureMobile/MicrosoftAzureMobile.h>
#import "QSTodoService.h"

Fügen Sie in didFinishLaunchingWithOptions in QSAppDelegate.mdie folgenden Zeilen direkt vor return YES;ein:

UIUserNotificationSettings* notificationSettings = [UIUserNotificationSettings settingsForTypes:UIUserNotificationTypeAlert | UIUserNotificationTypeBadge | UIUserNotificationTypeSound categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:notificationSettings];
[[UIApplication sharedApplication] registerForRemoteNotifications];

Fügen Sie in QSAppDelegate.mdie folgenden Handlermethoden hinzu. Ihre App wird jetzt aktualisiert, um Pushbenachrichtigungen zu unterstützen.

// Registration with APNs is successful
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

    QSTodoService *todoService = [QSTodoService defaultService];
    MSClient *client = todoService.client;

    [client.push registerDeviceToken:deviceToken completion:^(NSError *error) {
        if (error != nil) {
            NSLog(@"Error registering for notifications: %@", error);
        }
    }];
}

// Handle any failure to register
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:
(NSError *)error {
    NSLog(@"Failed to register for remote notifications: %@", error);
}

// Use userInfo in the payload to display an alert.
- (void)application:(UIApplication *)application
        didReceiveRemoteNotification:(NSDictionary *)userInfo {
    NSLog(@"%@", userInfo);

    NSDictionary *apsPayload = userInfo[@"aps"];
    NSString *alertString = apsPayload[@"alert"];

    // Create alert with notification content.
    UIAlertController *alertController = [UIAlertController
                                    alertControllerWithTitle:@"Notification"
                                    message:alertString
                                    preferredStyle:UIAlertControllerStyleAlert];

    UIAlertAction *cancelAction = [UIAlertAction
                                    actionWithTitle:NSLocalizedString(@"Cancel", @"Cancel")
                                    style:UIAlertActionStyleCancel
                                    handler:^(UIAlertAction *action)
                                    {
                                        NSLog(@"Cancel");
                                    }];

    UIAlertAction *okAction = [UIAlertAction
                                actionWithTitle:NSLocalizedString(@"OK", @"OK")
                                style:UIAlertActionStyleDefault
                                handler:^(UIAlertAction *action)
                                {
                                    NSLog(@"OK");
                                }];

    [alertController addAction:cancelAction];
    [alertController addAction:okAction];

    // Get current view controller.
    UIViewController *currentViewController = [[[[UIApplication sharedApplication] delegate] window] rootViewController];
    while (currentViewController.presentedViewController)
    {
        currentViewController = currentViewController.presentedViewController;
    }

    // Display alert.
    [currentViewController presentViewController:alertController animated:YES completion:nil];

}

Swift:

Fügen Sie datei ClientManager.swift mit dem folgenden Inhalt hinzu. Ersetzen Sie %AppUrl% durch die URL des Azure Mobile App-Back-Ends.
```
class ClientManager {
    static let sharedClient = MSClient(applicationURLString: "%AppUrl%")
}
```
Ersetzen Sie in ToDoTableViewController.swiftdie let client Zeile, die ein MSClient initialisiert, durch diese Zeile:
```
let client = ClientManager.sharedClient
```

Ersetzen Sie den Körper von func application in AppDelegate.swiftwie folgt:

func application(application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    application.registerUserNotificationSettings(
        UIUserNotificationSettings(forTypes: [.Alert, .Badge, .Sound],
            categories: nil))
    application.registerForRemoteNotifications()
    return true
}

Fügen Sie in AppDelegate.swiftdie folgenden Handlermethoden hinzu. Ihre App wird jetzt aktualisiert, um Pushbenachrichtigungen zu unterstützen.

func application(application: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData) {
    ClientManager.sharedClient.push?.registerDeviceToken(deviceToken) { error in
        print("Error registering for notifications: ", error?.description)
    }
}

func application(application: UIApplication,
    didFailToRegisterForRemoteNotificationsWithError error: NSError) {
    print("Failed to register for remote notifications: ", error.description)
}

func application(application: UIApplication,
    didReceiveRemoteNotification userInfo: [NSObject: AnyObject]) {

    print(userInfo)

    let apsNotification = userInfo["aps"] as? NSDictionary
    let apsString       = apsNotification?["alert"] as? String

    let alert = UIAlertController(title: "Alert", message: apsString, preferredStyle: .Alert)
    let okAction = UIAlertAction(title: "OK", style: .Default) { _ in
        print("OK")
    }
    let cancelAction = UIAlertAction(title: "Cancel", style: .Default) { _ in
        print("Cancel")
    }

    alert.addAction(okAction)
    alert.addAction(cancelAction)

    var currentViewController = self.window?.rootViewController
    while currentViewController?.presentedViewController != nil {
        currentViewController = currentViewController?.presentedViewController
    }

    currentViewController?.presentViewController(alert, animated: true) {}

}

Test-Push-Benachrichtigungen

Drücken Sie in Xcode Ausführen, und starten Sie die App auf einem iOS-Gerät (beachten Sie, dass Push nicht auf Simulatoren funktioniert). Klicken Sie auf OK, um Pushbenachrichtigungen zu akzeptieren; diese Anforderung tritt beim ersten Ausführen der App auf.
Fügen Sie in der App ein neues Element hinzu, und klicken Sie auf +.
Stellen Sie sicher, dass eine Benachrichtigung empfangen wird, und klicken Sie dann auf OK, um die Benachrichtigung zu schließen. Sie haben dieses Lernprogramm jetzt erfolgreich abgeschlossen.

Mehr

Vorlagen bieten Ihnen Flexibilität beim Senden plattformübergreifender Pushs und lokalisierter Pushs. Verwendung der iOS-Clientbibliothek für Azure Mobile Apps zeigt, wie Sie Vorlagen registrieren.

Freigeben über