Registrazione di un ID applicazione

L'ID applicazione (l'identificativo del bundle) è un identificativo univoco che identifica una specifica applicazione. Ogni applicazione richiede un ID applicazione. I servizi come Push Notifications Service sono configurati sull'ID applicazione.

• Vai a Apple developer portal e seleziona Certificates, Identifiers & Profiles.

  

• Andare a 'Identifiers > Add identifier button.

  

  identificativo*

• Fare clic sul pulsante Aggiungi nuovo Identifier.

  

• Selezionare l'opzione ID app.

  {: caption="ID appOpzione ID " caption-side="bottom"} ID app

• Selezionare un tipo e fare clic su 'Continue.

  

• Fornisci una stringa per il prefisso dell'ID applicazione. Fornire il nome dell'applicazione nel campo Description. Ad esempio, l'applicazione Event Notifications iOS.

• Per il 'Bundle ID, scegliere Explicit e fornire un valore di ID bundle. Ti consigliamo di fornire una stringa di stile nome dominio inversa. Ad esempio, com.ibm.cloud.en.app.

  

• Selezionate la casella di controllo " Push Notifications dalle funzionalità e fate clic su " Continue.

  {: caption="pushAttiva le " caption-side="bottom"} push

• Passare alle impostazioni e fare clic su " Register > Done.

Il tuo ID applicazione è ora registrato.

Crea un certificato SSL di APNs di sviluppo e distribuzione

Prima di ottenere un certificato APNs, devi generare una CSR (certificate signing request) e inoltrarla ad Apple, l'autorità di certificazione (CA). La CSR contiene informazioni che identificano la tua società e la tua chiave pubblica e privata che usi per firmare le tue notifiche push Apple. Genera quindi il certificato SSL nel portale per sviluppatori iOS. Il certificato, insieme alla sua chiave pubblica e a quella privata, viene archiviato in Keychain Access.

Puoi utilizzare le APNs in due modi:

• Modalità sandbox per lo sviluppo e il test.
• Modalità di produzione quando si distribuiscono le applicazioni tramite l'App Store (o altri meccanismi di distribuzione aziendali).

Devi ottenere dei certificati separati per i tuoi ambienti di sviluppo e distribuzione. I certificati sono associati a un ID applicazione per l'applicazione destinataria delle notifiche remote. Per la produzione, è possibile creare fino a due certificati. IBM Cloud utilizza i certificati per stabilire una connessione SSL con APNS.

CocoaPods

use_frameworks!

target 'MyApp' do
   pod 'ENPushDestination', '~> 0.0.1'
end

Carthage

Per installare ENPushDestination utilizzando Carthage, aggiungi quanto segue al tuo Cartfile.

github "IBM/event-notifications-destination-ios-sdk" ~> 0.0.1

Quindi, esegui questo comando per creare le dipendenze e i framework:

carthage update --platform iOS

gestore pacchetti swift

Aggiungere quanto segue al file Package.swift per identificare ENPushDestination come dipendenza. Il gestore pacchetti clona ENPushDestination quando crei il progetto con la build swift.

dependencies: [
   .package(url: "https://github.com/IBM/event-notifications-destination-ios-sdk", from: "0.0.1")
]

Annullamento della registrazione dalle notifiche

Utilizza i seguenti frammenti di codice per annullare la registrazione da Event Notifications.

enPush.unregisterDevice { response, statusCode, error in
   /**.....*/
}

Per annullare la registrazione dalla registrazione basata su UserId, è necessario chiamare il metodo di registrazione. Vedi Register without userId option in Register for notifications.

Sottoscrivi tag

L'API subscribe sottoscrive il dispositivo per una determinata tag. Dopo aver sottoscritto un particolare tag, il dispositivo può ricevere le notifiche inviate per quel tag.

Aggiungi il seguente frammento di codice alla tua applicazione mobile iOS per sottoscrivere un elenco di tag.

// Subscribe to the given tag
enPush.subscribeToTags(tagName: "<tag_name>") { response, statusCode, error in
   /**.....*/
});

Richiama tag sottoscritte

L'API retrieveSubscriptionsWithCompletionHandler restituisce l'elenco di tag a cui è sottoscritto il dispositivo. Utilizza i seguenti frammenti di codice nell'applicazione mobile per ottenere un elenco di sottoscrizioni.

// Get a list of tags that to which the device is subscribed.
enPush.retrieveSubscriptionsWithCompletionHandler { response, statusCode, error in
   /**.....*/
}

Annulla sottoscrizione da tag

L'API unsubscribeFromTags rimuove la sottoscrizione del dispositivo dalle tag di elenco. Utilizzare i seguenti frammenti di codice per consentire ai dispositivi di annullare la sottoscrizione da una tag.

// unsubscibe from the given tag ,that to which the device is subscribed.
enPush.unsubscribeFromTags(tagName: "<tag_name>") { response, statusCode, error in
   /**.....*/
}

Ricezione di notifiche di push su dispositivi iOS

Per ricevere le notifiche push sui dispositivi iOS, aggiungete il seguente metodo Swift al 'appDelegate.swift della vostra applicazione:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {

   //UserInfo dictionary will contain data sent from the server
}

Notifiche interattive

1. Per abilitare le notifiche di push interattive, i parametri dell'azione di notifica devono essere passati come parte dell'oggetto di notifica. Il seguente è un codice di esempio per abilitare le notifiche interattive:

let actionOne = ENPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: .foreground)

let actionTwo = ENPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: .destructive)

let category = ENPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo])

let notificationOptions = ENPushClientOptions()
notificationOptions.setInteractiveNotificationCategories(categoryName: [category])
enPush.initialize(instanceGUID, destinationID, apiKey, notificationOptions)

1. Implementare il metodo callback su AppDelegate.swift:

   func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
      switch response.actionIdentifier {
         case "Accept":
         print("Clicked Accept")
         case "Reject":
         print("Clicked Reject")
         default:
      }
      completionHandler()
   }
   

Questo metodo di callback viene invocato quando l'utente fa clic sul pulsante di azione. L'implementazione di questo metodo deve eseguire le attività associate all'identificatore specificato ed eseguire il blocco nel parametro completionHandler.

Aggiunta di DeviceId personalizzato per la registrazione

Per inviare DeviceId utilizzare il metodo setDeviceId della classe ENPushClientOptions.

let options = ENPushClientOptions();
options.setDeviceId(deviceId: "YOUR_DEVICE_ID");

Ricorda di conservare il DeviceId unique personalizzato per ogni dispositivo.

Abilitazione delle notifiche Rich Media

Le notifiche rich media sono supportate su iOS 10 o versioni successive. Per ricevere notifiche rich media, implementare UNNotificationServiceExtension. L'estensione intercetterà e gestirà la notifica rich media.

Nel metodo didReceive() dell'estensione del servizio, aggiungere il seguente codice per recuperare il contenuto della notifica push.

override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
   self.contentHandler = contentHandler
   bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
   ENPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler)
}