Menambahkan Pemberitahuan Push ke Aplikasi iOS Anda

  • Artikel
  • 5 menit untuk membaca

Gambaran Umum

Dalam tutorial ini, Anda menambahkan pemberitahuan push ke proyek mulai cepat iOS sehingga pemberitahuan push dikirim ke perangkat setiap kali catatan dimasukkan.

Jika Anda tidak menggunakan proyek server mulai cepat yang diunduh, Anda memerlukan paket ekstensi pemberitahuan push. Untuk informasi selengkapnya, lihat Bekerja dengan panduan .NET backend server SDK untuk Azure Mobile Apps .

Simulator iOS tidak mendukung pemberitahuan push. Anda memerlukan perangkat iOS fisik dan keanggotaan Program Pengembang Apple.

Mengonfigurasi Hub Notifikasi

Fitur Aplikasi Seluler Azure App Service menggunakan Azure Notification Hubs untuk mengirim push, sehingga Anda akan mengonfigurasi hub notifikasi untuk aplikasi seluler Anda.

  1. Di portal Azure, buka App Services, lalu pilih kembali aplikasi Anda. Di bawah Pengaturan, pilih Push.

  2. Untuk menambahkan sumber daya hub notifikasi ke aplikasi, pilih Koneksi. Anda dapat membuat hub atau terhubung ke hub yang sudah ada.

    Configure a hub

Sekarang Anda telah menghubungkan hub notifikasi ke proyek back-end Aplikasi Seluler Anda. Kemudian Anda mengonfigurasi hub notifikasi ini untuk terhubung ke sistem notifikasi platform (PNS) untuk mendorong ke perangkat.

Mendaftarkan aplikasi untuk notifikasi push

Mengonfigurasi Azure untuk mengirim pemberitahuan push

  1. Di Mac Anda, luncurkan Akses Rantai Kunci. Di bilah navigasi kiri, di bawah Kategori, buka Sertifikat Saya. Temukan sertifikat SSL yang Anda unduh di bagian sebelumnya, lalu ungkapkan isinya. Pilih hanya sertifikat (jangan pilih kunci pribadi). Kemudian ekspor.
  2. Di portal Azure, pilih TelusuriLayanan AllApp>. Kemudian pilih kembali Aplikasi Seluler Anda.
  3. Di bawah Pengaturan, pilih App Service Push. Kemudian pilih nama hub notifikasi Anda.
  4. Buka Layanan >Pemberitahuan Push AppleUpload Sertifikat. Upload file .p12, memilih Mode yang benar (tergantung pada apakah sertifikat SSL klien Anda dari yang lebih awal adalah produksi atau kotak pasir). Simpan perubahan apa pun.

Layanan Anda sekarang dikonfigurasi untuk bekerja dengan pemberitahuan push di iOS.

Memperbarui backend untuk mengirim pemberitahuan push

Backend .NET (C#):

  1. Di Visual Studio, klik kanan proyek server dan klik Kelola Paket NuGet, cari Microsoft.Azure.NotificationHubs, lalu klik Instal. Ini menginstal pustaka Notification Hubs untuk mengirim pemberitahuan dari backend Anda.

  2. Dalam proyek Visual Studio backend, buka ControllersTodoItemController>.cs. Di bagian atas file, tambahkan pernyataan berikut using :

    using Microsoft.Azure.Mobile.Server.Config;
using Microsoft.Azure.NotificationHubs;

  3. Ganti metode PostTodoItem dengan kode berikut:

    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);
}

  4. Terbitkan ulang proyek server.

Node.js backend:

  1. Siapkan proyek backend Anda.

  2. Ganti skrip tabel todoitem.js dengan kode berikut:

    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;

  3. Saat mengedit file di komputer lokal Anda, terbitkan ulang proyek server.

Menambahkan notifikasi push ke aplikasi

Tujuan-C:

  1. Di QSAppDelegate.m, impor iOS SDK dan QSTodoService.h:

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

  2. Di didFinishLaunchingWithOptionsQSAppDelegate.m, masukkan baris berikut tepat sebelum return YES;:

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

  3. Di QSAppDelegate.m, tambahkan metode penangan berikut. Aplikasi Anda sekarang diperbarui untuk mendukung pemberitahuan push.

    // 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];

}

Cepat:

  1. Tambahkan file ClientManager.swift dengan konten berikut. Ganti %AppUrl% dengan URL backend Azure Mobile App.

    class ClientManager {
    static let sharedClient = MSClient(applicationURLString: "%AppUrl%")
}

  2. Di ToDoTableViewController.swift, ganti let client baris yang menginisialisasi MSClient dengan baris ini:

    let client = ClientManager.sharedClient

  3. Di AppDelegate.swift, ganti tubuh func application sebagai berikut:

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

  4. Di AppDelegate.swift, tambahkan metode penangan berikut. Aplikasi Anda sekarang diperbarui untuk mendukung pemberitahuan push.

    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) {}

}

Uji notifikasi push

  • Di Xcode, tekan Jalankan dan mulai aplikasi di perangkat iOS (perhatikan bahwa push tidak akan berfungsi pada simulator). Klik OK untuk menerima pemberitahuan push; permintaan ini terjadi saat pertama kali aplikasi berjalan.
  • Di aplikasi, tambahkan item baru dan klik +.
  • Verifikasi bahwa pemberitahuan diterima, lalu klik OK untuk mengabaikan pemberitahuan. Anda sekarang telah berhasil menyelesaikan tutorial ini.

Lainnya