Registro de un ID de aplicación

El ID de app (el identificador de paquete) es un identificador exclusivo que identifica una aplicación específica. Cada aplicación requiere un ID de app. Los servicios como el servicio de notificaciones de envío push se configuran en el ID de Aplicación.

• Vaya al portal para desarrolladores de Apple y seleccione Certificados, identificadores y perfiles.

  

• Vaya a Identifiers > Add identifier button.

  ![Botón](images/en-apns-identifier-button.png "" caption-side="bottom"}"){: caption="

• Haga clic en añadir un nuevo botón ' Identifier.

  

  Identificador*

• Seleccione la opción de ID de aplicación.

  

• Seleccione un tipo y pulse Continue.

  

• Proporcione una cadena de caracteres para el prefijo de ID de app. Introduzca el nombre de la aplicación en el campo " Description ". Por ejemplo, la aplicación Event Notifications iOS.

• Para el ' Bundle ID' , elija Explicit y proporcione un valor Bundle ID. Se recomienda que proporcione una cadena de estilo de dominio inverso. Por ejemplo, com.ibm.cloud.en.app.

  

• Seleccione el recuadro Push Notifications desde Capacidades y pulse Continue.

  

• Vaya a través de los valores y pulse Register > Done.

Se ha registrado el ID de la app.

Crear un certificado SSL de APNs de desarrollo y distribución

Para poder obtener un certificado de APNs, debe generar en primer lugar una solicitud de firma de certificado (CSR) y enviarla a Apple, la entidad emisora de certificados (CA). La CSR contiene información que identifica a la empresa y a la clave pública y privada que utilice para firmar las notificaciones push de Apple. A continuación, genere el certificado SSL en el Portal de desarrollador de iOS. El certificado, junto con su clave pública y privada, se almacena en el Acceso de cadena de claves.

Puede utilizar APNs de dos maneras:

• La modalidad de recinto de seguridad (sandbox) durante el desarrollo y pruebas.
• La modalidad de producción al distribuir aplicaciones mediante App Store (u otros mecanismos de distribución de empresa).

Debe obtener certificados independientes para los entornos de desarrollo y de distribución. Los certificados están asociados con un ID de App para la app que es el destinatario de las notificaciones remotas. Para producción, puede crear hasta dos certificados. IBM Cloud utiliza los certificados para establecer una conexión SSL con APN.

CocoaPods

use_frameworks!

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

Carthage

Para instalar ENPushDestination utilizando Carthage, añada lo siguiente a su archivo Cartfile.

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

A continuación, ejecute el siguiente comando para compilar las dependencias y los frameworks:

carthage update --platform iOS

Swift Package Manager

Añada lo siguiente al archivo Package.swift para identificar ENPushDestination como una dependencia. El gestor de paquetes clona ENPushDestination cuando construyes tu proyecto con swift build.

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

Anulación del registro de notificaciones

Utilice los siguientes fragmentos de código para darse de baja de Event Notifications.

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

Para anular el registro del registro basado en UserId, debe llamar al método de registro. Consulte Register without userId option en Registro para notificaciones.

Suscribirse a etiquetas

La API ' subscribe ' suscribe el dispositivo para una etiqueta determinada. Después de que el dispositivo esté suscrito a una etiqueta determinada, el dispositivo puede recibir notificaciones que se envían para dicho código.

Añada el siguiente fragmento de código a la aplicación móvil iOS para suscribirse a una lista de códigos.

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

Recuperar etiquetas suscritas

La API ' retrieveSubscriptionsWithCompletionHandler ' devuelve la lista de etiquetas a las que está suscrito el dispositivo. Utilice los siguientes fragmentos de código en la aplicación móvil para obtener la lista de suscripción.

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

Anular suscripción de etiquetas

La API de unsubscribeFromTags elimina la suscripción de dispositivo de las etiquetas de lista. Utilice los siguientes fragmentos de código para permitir que sus dispositivos se den de baja de una etiqueta.

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

Recepción de notificaciones push en dispositivos iOS

Para recibir notificaciones push en dispositivos iOS, añade el siguiente método Swift al ' appDelegate.swift de tu aplicación:

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

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

Notificaciones interactivas

1. Para habilitar las notificaciones de envío push interactivas, los parámetros de acción de notificación deben pasarse como parte del objeto de notificación. A continuación se muestra un código de ejemplo para habilitar las notificaciones interactivas:

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. Implemente el método de devolución de llamada en 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()
   }
   

Este método de devolución de llamada se invoca cuando el usuario pulsa el botón de acción. La implementación de este método debe realizar las tareas que están asociadas con el identificador especificado y ejecutar el bloque en el parámetro completionHandler.

Adición del ID de dispositivo personalizado para el registro

Para enviar DeviceId utilice el método setDeviceId de la clase ENPushClientOptions.

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

Recuerde mantener el DeviceId personalizado ' unique ' para cada dispositivo.

Habilitación de notificaciones de medios enriquecidos

Las notificaciones de medios enriquecidos están soportadas en iOS 10 o posterior. Para recibir notificaciones de medios enriquecidos, implemente UNNotificationServiceExtension. La extensión interceptará y manejará la notificación de medios enriquecidos.

En el método didReceive() de la extensión de servicio, añada el código siguiente para recuperar el contenido de notificación de envío push enriquecido.

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