App-IDs registrieren

Die App-ID (Bundle-ID) ist eine eindeutige Kennung für eine bestimmte Anwendung. Für jede Anwendung ist eine App-ID erforderlich. Services wie der Push-Benachrichtigungs-Service werden für App-ID konfiguriert.

• Gehen Sie zum Apple-Entwicklerportal und wählen Sie Zertifikate, Identifikatoren und Profile.

  

• Rufen Sie Identifiers > Add identifier button auf.

  

• Klicken Sie auf die Schaltfläche "Neuen Identifier hinzufügen".

  ![](images/en-apns-new-identifier-button.png ""Neuen Bezeichner hinzufügen "*Schaltfläche "Neuen Bezeichner hinzufügen "*Schaltfläche "Neuen Bezeichner ")

• Wählen Sie die Option App-IDs aus.

  

• Wählen Sie einen Typ aus und klicken Sie auf Continue.

  

• Geben Sie eine Zeichenfolge für das App-ID-Präfix an. Geben Sie den Namen der App in das Feld " Description ein. Beispiel: Event Notifications iOS-Anwendung

• Wählen Sie für " Bundle ID die Option Explizit und geben Sie einen Wert für die Bündel-ID an. Es wird empfohlen, die umgekehrte Zeichenfolge eines Domänennamens zu verwenden. Zum Beispiel com.ibm.cloud.en.app.

  {: caption="erstellenNeue App ID " caption-side="bottom"} erstellen

• Wählen Sie das Kontrollkästchen Push Notifications in den Funktionen aus und klicken Sie auf Continue.

  

• Gehen Sie Ihre Einstellungen durch und klicken Sie auf Register > Done.

Ihre App-ID ist nun registriert.

SSL-Zertifikat zum Entwickeln und Verteilen von APNs erstellen

Bevor Sie ein APNs-Zertifikat anfordern, müssen Sie zunächst eine Zertifikatssignieranforderung (Certificate Signing Request, CSR) generieren und an die Zertifizierungsstelle (Certificate Authority, CA) von Apple schicken. Die CSR enthält Informationen zum Identifizieren Ihres Unternehmens und beinhaltet Ihren öffentlichen sowie Ihren privaten Schlüssel, den Sie zum Signieren Ihrer Apple-Push-Benachrichtigungen verwenden. Generieren Sie anschließend das SSL-Zertifikat in iOS Developer Portal. Das Zertifikat mit dem zugehörigen öffentlichen und privaten Schlüssel wird in Keychain Access gespeichert.

Sie können APNs auf zwei Weisen verwenden:

• Sandboxmodus zum Entwickeln und Testen.
• Produktionsmodus zum Verteilen von Anwendungen über den App Store (oder über die Verteilungsmechanismen anderer Unternehmen.

Sie müssen separate Zertifikate für Ihre Entwicklungs- und Verteilungsumgebungen anfordern. Die Zertifikate werden einer App-ID für die App zugeordnet, die der Empfänger für ferne Benachrichtigungen ist. Für die Produktion können Sie bis zu zwei Zertifikate erstellen. IBM Cloud verwendet die Zertifikate zum Herstellen einer SSL-Verbindung zu APNs.

CocoaPods

use_frameworks!

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

Carthage

Fügen Sie Folgendes zu Ihrer Cartfile hinzu, um ENPushDestination mithilfe von Carthage zu installieren:

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

Führen Sie dann den folgenden Befehl aus, um die Abhängigkeiten und Frameworks zu erstellen:

carthage update --platform iOS

Swift Package Manager

Fügen Sie der Datei Package.swift Folgendes hinzu, um ENPushDestination als Abhängigkeit anzugeben. Der Paketmanager klont ENPushDestination, wenn Sie Ihr Projekt mit swift build bauen.

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

Registrierung von Benachrichtigungen aufheben

Verwenden Sie die folgenden Codeschnipsel, um die Registrierung von Event Notifications aufzuheben.

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

Zum Aufheben der Registrierung bei der UserId-basierten Registrierung müssen Sie die Registrierungsmethode aufrufen. Siehe Register without userId option im Abschnitt Für Benachrichtigungen registrieren.

Tags abonnieren

Die API " subscribe abonniert das Gerät für einen bestimmten Tag. Nachdem das Gerät einen bestimmten Tag abonniert hat, kann das Gerät Benachrichtigungen empfangen, die für diesen Tag gesendet werden.

Fügen Sie das folgende Code-Snippet zu Ihrer mobilen iOS-Anwendung hinzu, um eine Liste von Tags zu abonnieren.

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

Abonnierte Tags abrufen

Die API " retrieveSubscriptionsWithCompletionHandler gibt die Liste der Tags zurück, für die das Gerät abonniert ist. Verwenden Sie die folgenden Code-Snippets in der mobilen Anwendung, um die Abonnementliste abzurufen.

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

Tag-Abonnements stornieren

Die API unsubscribeFromTags entfernt das Geräteabonnement aus den Listentags. Verwenden Sie die folgenden Code-Snippets, damit Ihre Geräte Tag-Abonnements stornieren können.

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

Push-Benachrichtigungen in iOS-Geräten empfangen

Um Push-Benachrichtigungen auf iOS zu erhalten, fügen Sie die folgende Swift in den " appDelegate.swift Ihrer Anwendung ein:

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

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

Interaktive Benachrichtigungen

1. Zum Aktivieren interaktiver Push-Benachrichtigungen müssen die Parameter für Benachrichtigungsaktionen als Teil des Benachrichtigungsobjekts übergeben werden. Im Folgenden sehen Sie einen Beispielcode zum Aktivieren interaktiver Benachrichtigungen:

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. Implementieren Sie die Callback-Methode in 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()
   }
   

Diese Callback-Methode wird aufgerufen, wenn der Benutzer auf die Aktionsschaltfläche klickt. Die Implementierung dieser Methode muss Aufgaben ausführen, die mit dem angegebenen Bezeichner verbunden sind, und den Block im Parameter completionHandler ausführen.

Angepasste Einheiten-ID für Registrierung hinzufügen

Verwenden Sie zum Senden von DeviceId die Methode setDeviceId der Klasse ENPushClientOptions.

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

Denken Sie daran, die benutzerdefinierte DeviceId ' unique für jedes Gerät beizubehalten.

Rich Media-Benachrichtigungen aktivieren

Rich-Media-Benachrichtigungen werden unter iOS 10 oder höher unterstützt. Implementieren Sie UNNotificationServiceExtension, um Rich Media-Benachrichtigungen zu empfangen. Die Erweiterung fängt die Rich-Media-Benachrichtigung ab und verarbeitet sie.

Fügen Sie in der Methode didReceive () Ihrer Serviceerweiterung den folgenden Code hinzu, um den Rich-Push-Benachrichtigungsinhalt abzurufen.

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