App ID 등록

App ID(번들 ID)는 특정 애플리케이션을 식별하는 고유 ID입니다. 각 애플리케이션에 App ID가 필요합니다. 푸시 알림 서비스와 같은 서비스가 App ID에 대해 구성됩니다.

• Apple 개발자 포털로 이동하여 인증서, 식별자 및 프로필을 선택합니다.

  

• Identifiers > Add identifier button(으)로 이동하십시오.

  

• 새 ' Identifier ' 추가 버튼을 클릭합니다.

  

• App ID 옵션을 선택하십시오.

  

• 유형을 선택하고 Continue을(를) 클릭하십시오.

  

• 앱 ID 접두부에 대한 문자열을 제공하십시오. ' Description ' 필드에 앱 이름을 입력합니다. 예를 들어, Event Notifications iOS 애플리케이션입니다.

• ' Bundle ID'의 경우 명시적 을 선택하고 번들 ID 값을 입력합니다. 역 도메인 이름 스타일 문자열을 제공하도록 권장합니다. 예: com.ibm.cloud.en.app.

  

• 기능에서 Push Notifications 선택란을 선택하고 Continue을(를) 클릭하십시오.

  {: caption="사용푸시 알림 사용푸시 알림 " caption-side="bottom"}

• 설정을 확인하고 Register > Done을(를) 클릭하십시오.

사용자의 앱 ID가 이제 등록되었습니다.

개발 및 배포 APNs SSL 인증서 작성

APNs 인증서를 획득하려면 먼저 인증서 서명 요청(CSR)을 작성하여 이를 Apple 인증 기관(CA)에 제출해야 합니다. CSR에는 사용자의 회사, Apple 푸시 알림을 신청할 때 사용하는 공용 키와 개인 키를 식별하는 정보가 포함됩니다. 그런 다음 iOS 개발자 포털에서 SSL 인증서를 생성하십시오. 인증서와 이의 공개 및 개인 키는 Keychain Access에 저장됩니다.

다음 두 모드에서 APNs를 사용할 수 있습니다.

• 개발 및 테스트를 위한 샌드박스 모드에서
• 앱 저장소(또는 다른 엔터프라이즈 배포 메커니즘)를 통해 애플리케이션을 배포할 때 프로덕션 모드에서

개발 및 배포 환경을 위한 별도의 인증서를 획득해야 합니다. 인증서는 원격 알림의 수신인인 앱의 App ID와 연관되어 있습니다. 프로덕션의 경우 최대 두 개의 인증서를 작성할 수 있습니다. IBM Cloud 은 인증서를 사용하여 APNs와의 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 Manager

Package.swift 파일에 다음을 추가하여 ENPushDestination을 종속성으로 식별하십시오. 패키지 관리자는 스위프트 빌드로 프로젝트를 빌드할 때 ENPushDestination 복제합니다.

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

Notifications에서 등록 취소

다음 코드 스니펫을 사용하여 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)
}