Aggiungere notifiche push all'app Xamarin.iOS

Androide
Cordova
Ios
Finestre
Xamarin.Android
Xamarin.iOS
Xamarin.Forms

Informazioni generali

In questa esercitazione si aggiungono notifiche push al progetto di avvio rapido di Xamarin.iOS in modo che venga inviata una notifica push al dispositivo ogni volta che viene inserito un record.

Se non si usa il progetto server di avvio rapido scaricato, sarà necessario il pacchetto di estensione per le notifiche push. Per altre informazioni, vedere Usare l'SDK del server back-end .NET per app per dispositivi mobili di Azure.

Prerequisiti

Completare l'esercitazione introduttiva su Xamarin.iOS .
Un dispositivo iOS fisico. Le notifiche push non sono supportate dal simulatore iOS.

Registrare l'app per le notifiche push nel portale per sviluppatori di Apple

Registrare un ID app per la tua app. Creare un ID app esplicito (non un ID app con caratteri jolly) e, per ID bundle, usare l'ID bundle esatto presente nel progetto quickstart di Xcode. È anche fondamentale selezionare l'opzione notifiche push.
Successivamente, per preparare la configurazione delle notifiche push, creare un certificato SSL di "Sviluppo" o di "Distribuzione".

Configurare l'app per dispositivi mobili per inviare notifiche push

Sul tuo Mac, avvia Keychain Access. Nella barra di navigazione a sinistra, sotto Categoria, aprire I miei certificati. Trovare il certificato SSL scaricato nella sezione precedente e quindi divulgarne il contenuto. Selezionare solo il certificato (non selezionare la chiave privata). Quindi esportarlo.
Nel portale di Azure selezionare Esplora tutti i Servizi App>. Selezionare quindi il back-end delle app per dispositivi mobili.
In Impostazioni, selezionare Push del Servizio App. Selezionare quindi il nome dell'hub di notifica.
Passare a Apple Push Notification Services>Carica certificato. Caricare il file con estensione .p12, selezionando la modalità corretta (a seconda che il certificato client SSL ottenuto in precedenza sia di produzione o sandbox). Salvare eventuali modifiche.

Il servizio è ora configurato per l'uso delle notifiche push in iOS.

Aggiornare il progetto server per inviare notifiche push

In questa sezione si aggiorna il codice nel progetto back-end di App per dispositivi mobili esistente per inviare una notifica push ogni volta che viene aggiunto un nuovo elemento. Questo processo è alimentato dalla funzionalità del modello di Hub di notifica di Azure, che consente push multipiattaforma. I vari client vengono registrati per le notifiche push usando modelli e un singolo push universale può arrivare a tutte le piattaforme client.

Scegliere una delle procedure seguenti che corrispondano al tipo di progetto back-end, back-end .NET o Node.js back-end.

Progetto .NET back-end

In Visual Studio fare clic con il pulsante destro del mouse sul progetto server. Selezionare quindi Gestisci pacchetti NuGet. Cercare Microsoft.Azure.NotificationHubse quindi selezionare Installa. Questo processo installa la libreria di Hub di notifica per l'invio di notifiche dal back-end.

Nel progetto server aprire i controller >TodoItemController.cs. Quindi, aggiungere le seguenti istruzioni using:

using System.Collections.Generic;
using Microsoft.Azure.NotificationHubs;
using Microsoft.Azure.Mobile.Server.Config;

Nel metodo PostTodoItem aggiungere il codice seguente dopo la chiamata a InsertAsync:

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

// Send the message so that all template registrations that contain "messageParam"
// receive the notifications. This includes APNS, GCM, WNS, and MPNS template registrations.
Dictionary<string,string> templateParams = new Dictionary<string,string>();
templateParams["messageParam"] = item.Text + " was added to the list.";

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

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

Questo processo invia una notifica basata su modello che contiene item.Text quando viene inserito un nuovo elemento.

Ripubblica il progetto del server.

Progetto back-end Node.js

Configurare il progetto backend.

Sostituire il codice esistente in todoitem.js con il codice seguente:

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

table.insert(function (context) {
// For more information about the Notification Hubs JavaScript SDK,
// see https://aka.ms/nodejshubs.
logger.info('Running TodoItem.insert');

// Define the template payload.
var payload = '{"messageParam": "' + context.item.text + '" }';  

// Execute the insert. The insert returns the results as a promise.
// Do the push as a post-execute action within the promise flow.
return context.execute()
    .then(function (results) {
        // Only do the push if configured.
        if (context.push) {
            // Send a template notification.
            context.push.send(null, payload, function (error) {
                if (error) {
                    logger.error('Error while sending push notification: ', error);
                } else {
                    logger.info('Push notification sent successfully!');
                }
            });
        }
        // Don't forget to return the results from the context.execute().
        return results;
    })
    .catch(function (error) {
        logger.error('Error while running context.execute: ', error);
    });
});

module.exports = table;

Questo processo invia una notifica di modello contenente item.text quando viene inserito un nuovo elemento.

Quando modifichi il file sul computer locale, ripubblica il progetto del server.

Configurare il progetto Xamarin.iOS

Configurare il progetto iOS in Xamarin Studio

In Xamarin.Studio aprire Info.plist e aggiornare l'identificatore del bundle con l'ID bundle creato in precedenza con il nuovo ID app.
Scorrere verso il basso fino a Modalità di sfondo. Selezionare la casella Abilita modalità in background e la casella Notifiche remote .
Fare doppio clic sul progetto nel pannello della soluzione per aprire Opzioni progetto.
Nella sezione Compilazione, scegli Firma bundle iOS e seleziona l'identità e il profilo di provisioning corrispondenti che hai appena configurato per questo progetto.

In questo modo il progetto usa il nuovo profilo per la firma del codice. Per la documentazione ufficiale sul provisioning dei dispositivi Xamarin, vedere Provisioning di dispositivi Xamarin.

Configurare il progetto iOS in Visual Studio

In Visual Studio fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Proprietà.
Nelle pagine delle proprietà fare clic sulla scheda Applicazione iOS e aggiornare l'identificatore con l'ID creato in precedenza.
Nella scheda Firma bundle iOS, selezionare l'identità corrispondente e il profilo di provisioning appena configurati per questo progetto.

In questo modo il progetto usa il nuovo profilo per la firma del codice. Per la documentazione ufficiale sul provisioning dei dispositivi Xamarin, vedere Provisioning di dispositivi Xamarin.
Fare doppio clic su Info.plist per aprirlo e quindi abilitare RemoteNotifications in Modalità in background.

Aggiungi notifiche push all'app

In QSTodoService aggiungere la proprietà seguente in modo che AppDelegate possa acquisire il client mobile:

public MobileServiceClient GetClient {
    get
    {
        return client;
    }
    private set
    {
        client = value;
    }
}

Aggiungere l'istruzione seguente using all'inizio del file AppDelegate.cs .

using Microsoft.WindowsAzure.MobileServices;
using Newtonsoft.Json.Linq;

In AppDelegate eseguire l'override dell'evento FinishedLaunching :

 public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
 {
     // registers for push for iOS8
     var settings = UIUserNotificationSettings.GetSettingsForTypes(
         UIUserNotificationType.Alert
         | UIUserNotificationType.Badge
         | UIUserNotificationType.Sound,
         new NSSet());

     UIApplication.SharedApplication.RegisterUserNotificationSettings(settings);
     UIApplication.SharedApplication.RegisterForRemoteNotifications();

     return true;
 }

Nello stesso file eseguire l'override dell'evento RegisteredForRemoteNotifications . Con questo codice, ci si registra per una semplice notifica di template che verrà inviata su tutte le piattaforme supportate dal server.

Per altre informazioni sui modelli con Hub di notifica, vedere Modelli.

public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
{
    MobileServiceClient client = QSTodoService.DefaultService.GetClient;

    const string templateBodyAPNS = "{\"aps\":{\"alert\":\"$(messageParam)\"}}";

    JObject templates = new JObject();
    templates["genericMessage"] = new JObject
    {
        {"body", templateBodyAPNS}
    };

    // Register for push with your mobile app
    var push = client.GetPush();
    push.RegisterAsync(deviceToken, templates);
}

Eseguire quindi l'override dell'evento DidReceivedRemoteNotification :

 public override void DidReceiveRemoteNotification (UIApplication application, NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
 {
     NSDictionary aps = userInfo.ObjectForKey(new NSString("aps")) as NSDictionary;

     string alert = string.Empty;
     if (aps.ContainsKey(new NSString("alert")))
         alert = (aps [new NSString("alert")] as NSString).ToString();

     //show alert
     if (!string.IsNullOrEmpty(alert))
     {
         UIAlertView avAlert = new UIAlertView("Notification", alert, null, "OK", null);
         avAlert.Show();
     }
 }

L'app è ora aggiornata per supportare le notifiche push.

Testare le notifiche push nell'app

Premere il pulsante Esegui per compilare il progetto e avviare l'app in un dispositivo con supporto per iOS, quindi fare clic su OK per accettare le notifiche push.

Annotazioni

È necessario accettare in modo esplicito le notifiche push dall'app. Questa richiesta viene eseguita solo la prima volta che l'app viene eseguita.
Nell'app, digita un'attività e poi fai clic sull'icona del segno più (+).
Verificare che venga ricevuta una notifica, quindi fare clic su OK per ignorare la notifica.
Ripetere il passaggio 2 e chiudere immediatamente l'app, quindi verificare che venga visualizzata una notifica.

Questa esercitazione è stata completata correttamente.

Last updated on 2019-06-25

Condividi tramite