注册应用程序标识

应用程序标识（捆绑标识）是用于标识特定应用程序的唯一标识。 每个应用程序都需要应用程序标识。 推送通知服务等服务配置到App ID。

• 转至 Apple 开发者门户网站，然后选择 证书，标识和概要文件。

  

• 转至 Identifiers > Add identifier button。

  {: caption="标识符按钮标识符" caption-side="bottom"}

• 单击“添加新 Identifier”按钮。

  

• 选择“应用程序标识”选项。

  

  应用程序 ID 选项

• 选择类型并点击 "Continue。

  

• 为 App ID Prefix 提供字符串。 在 Description 字段中提供应用程序名称。 例如，Event Notifications iOS 应用程序。

• 对于 Bundle ID，选择 显式 并提供捆绑软件标识值。 建议提供逆向域名样式的字符串。 例如，com.ibm.cloud.en.app。

  

• 从“功能”中选择 Push Notifications 复选框，然后单击 Continue。

  

• 查看设置并点击 "Register > Done。

现在，您的应用程序标识已注册。

创建开发和分发 APNs SSL 证书

在获取 APNs 证书之前，必须首先生成一个证书签名请求 (CSR)，然后将其提交给 Apple（认证中心 (CA)）。 CSR 中包含您公司的标识信息，以及您用于签署 Apple 推送通知的公用密钥和专用密钥信息。 然后，在 iOS 开发者门户网站上生成 SSL 证书。 该证书与其公用密钥和专用密钥一起存储在“钥匙串访问”中。

您可以在两种模式下使用 APNs：

• 沙箱模式，用于开发和测试。
• 生产模式，用于通过 App Store（或其他企业分发机制）分发应用程序。

必须分别针对开发环境和分发环境获取不同的证书。 证书与接收远程通知的应用程序的应用程序标识相关联。 对于生产，您最多可以创建两个证书。IBM Cloud 使用证书与 APN 建立 SSL 连接。

CocoaPods

use_frameworks!

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

Carthage

要使用 Carthage 安装 ENPushDestination，请将以下内容添加到 Cartfile。

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

然后，运行以下命令以构建依赖关系和框架:

carthage update --platform iOS

Swift 包管理器

将以下内容添加到 Package.swift 文件以将 ENPushDestination 标识为依赖关系。 当您使用 swift 构建构建项目时，包管理器会克隆 ENPushDestination。

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

从通知注销

使用以下代码片段从 Event Notifications注销。

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

要从基于 UserId 的注册中注销，必须调用注册方法。 请参阅 注册以获取通知 中的 Register without userId option。

预订标记

subscribe API 为给定标记预订设备。 设备订阅特定标签后，就能接收为该标签发送的通知。

将以下代码片段添加到 iOS 移动应用程序以预订标记列表。

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

检索预订的标记

retrieveSubscriptionsWithCompletionHandler API 返回设备预订的标记的列表。 在移动应用程序中使用以下代码片段来获取预订列表。

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

从标记取消预订

unsubscribeFromTags API 从列表标记中除去设备预订。 使用以下代码片段来允许您的设备从标记中取消预订。

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

在 iOS 设备上接收推送通知

要在iOS设备上接收推送通知，请在应用程序的 "appDelegate.swift 中添加以下Swift方法：

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

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

交互式通知

1. 要启用交互式推送通知，必须将通知操作参数作为通知对象的一部分传递。 以下是用于启用交互式通知的样本代码:

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. 在 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()
   }
   

当用户点击操作按钮时，将调用该回调方法。 该方法的执行必须执行与指定标识符相关联的任务，并运行completionHandler参数中的代码块。

添加定制 DeviceId 以进行注册

要发送 DeviceId，请使用 ENPushClientOptions 类的 setDeviceId 方法。

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

请记住为每个设备保留定制 DeviceId unique。

启用富媒体通知

在 iOS 10 或更高版本上支持富媒体通知。 要接收富媒体通知，请实施UNNotificationServiceExtension。 该扩展将拦截并处理富媒体通知。

在服务扩展的didReceive() 方法中，添加以下代码以获取丰富的推送通知内容。

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