Push Notification (iOS, client)

Push Notification (일명 : 푸쉬)는 서버에서 사용자에게 일방적으로 메시지를 보내는 기능 입니다. 주로, 운영자가 특정 소식을 전할 때 사용됩니다. 사인할 프로비저닝 파일이 필요하며, App id에는 Push를 사용할 것으로 설정이되어 있어야 합니다. (앱 아이디 수정도 가능합니다.)

 

선행작업.

프로비저닝 프로파일 만들기 (푸쉬 인증서 설명도 같이 있음) : https://nicgoon.tistory.com/202 (숙지하셔야 합니다.)

 

공식문서

유저 노티피케이션 : https://developer.apple.com/documentation/usernotifications ( 이 문서에 스텝이 있습니다.).
푸쉬 킷 : https://developer.apple.com/documentation/pushkit ( 함께 사용되지만, 참고만 있습니다. )

 

참고 문서

예제1: https://faith-developer.tistory.com/153 (끝부분만 보시면됩니다.).
예제2: http://monibu1548.github.io/2018/05/29/push-cert/ ( 역시 끝 부부만 보시면됩니다.)

 

1. 준비.

Xcode 프로젝트를 생성합니다. 위의 [프로비저닝 프로파일 만들기], 를 참고해, 프로젝트를 듭니다. 저는 [com.tistory.yeslife.hello] 라는 번들 아이디로 프로젝트를 만들었습니다. 이 페이지에서 참고한 기준 문서는 유저 노티피케이션 입니다. 아래 Topics 부분을 보면, 순서로 나열된 것이 있습니다.

 

2. 프레임 워크 추가.

프로젝트 > Build Phases 탭을 차례로 선택하고, Link Binary With Libraries를 확장 시킵니다.

+ 버튼을 눌러, UserNotifications.framework 와 PushKit.framework를 추가해 줍니다.

 

3. Capabilities 탭을 선택해 푸쉬를 활성화 해 줍니다.

프로젝트 > Capabilities 탭을 차례로 선택해 줍니다. 그리고, 페이지를 스크롤해 Push Notifications를 활성화 해 줍니다. (Provisioning Profile이 서정되어 있지 않다면, 활성화 할 수 없습니다.).

 

4. 사용자에게 알림을 사용할 것인지 묻기.

UserNotifications 문서 토픽에 보면, 첫 스텝으로 Asking Permission to Use Notifications 문서 ( 링크 ) 가 있습니다. 그 문서를 참고해 사용할 것인지 묻는 코드를 작성하였습니다.

 

1) 앱 델리 게이트 부분에 사용자 물음 추가. (Application 메소드 속에 넣으면 좋습니다.).

// 유저 노티피 케이션 센터를 가지고 옵니다.
let center = UNUserNotificationCenter.current()

// 사용 여부를 묻습니다.
center.requestAuthorization(options: [.alert, .sound])
{ (granted, error) in

    // 승인 받았는지 여부를 여기서 확인할 수 있습니다.
    guard granted else {
        print( "유저가 푸쉬 알림을 허락하지 않았습니다." )
        return
    }

    print( "유저가 푸쉬 알림을 허락하였습니다." )

}

 

5. 장치를 푸쉬 서버에 등록.

유저가 푸쉬를 허락한 경우, 장치를 APNs에 등록하고, 등록된 키 값을 받아 오는 부분 입니다. 공식 문서는 Registering Your App with APNs 부분을 확인하시면 되겠습니다. 

1) 위에서 푸쉬 알림 허락한 부분에 등록을 요청하는 코드를 등록 합니다.

주의 할 점은, 응답이 왔을 때 메인 쓰레드 (UI)와 동기화 처리가 필요하므로, DispatchQueue.main.async 메소드 속에서 호출해야 합니다.

위에서 작성했던 코드가 아래와 같이 됩니다.

let notificationCenter = UNUserNotificationCenter.current()
        
        notificationCenter.getNotificationSettings
        { (settings) in
            
            // Do not schedule notifications if not authorized.
            let center = UNUserNotificationCenter.current()
            
            // Request permission to display alerts and play sounds.
            center.requestAuthorization(options: [.alert, .sound])
            { (granted, error) in
                
                
                // 유저가 푸쉬를 사용하지 않겠다고 한 경우, 여기서 처리합니다.
                guard granted else {
                    print("유저가 푸쉬 알림을 승인하지 않았습니다.")
                    return
                }
                
                
                // 푸쉬를 처리한 경우, 여기서 처리 합니다.
                print("유저가 푸쉬를 승인하였습니다.")
                
                
                // 메인 쓰레드 UI와 Thread 동기화 처리 될 수 있도록, DispatchQueue.main.async 메소드로 감싸 줍니다.
                DispatchQueue.main.async {
                    
                    // APNs 에 스마트폰을 등록하는 메소드 입니다. (네트워크)
                    UIApplication.shared.registerForRemoteNotifications()
                    
                }
                
                
            }
        }

 

2) APNs로 부터 응답처리.

2개의 메소드 모두 AppDelegate 클래스에 추가하도록 합니다.

// APNs 서버에 등록한 경우 표시.
func application(_ application: UIApplication,
                 didRegisterForRemoteNotificationsWithDeviceToken
    deviceToken: Data) {

    // 토큰 값을 가지고 옵니다.
    let deviceTokenString = deviceToken.reduce("", {$0 + String(format: "%02X", $1)})

    // 콘솔에 토큰 값을 표시해 줍니다.
    print("APNs device token: \(deviceTokenString)")


}



// APNs 서버에 등록하지 못한 경우, 오류를 표시.
func application(_ application: UIApplication,
                 didFailToRegisterForRemoteNotificationsWithError
    error: Error) {

    // Try again later.


}

 

6 클라이언트 검증해 보기.

일단 클라이언트 부분의 푸쉬 부분은 끝났지만, 이게 잘 동작하는 지 확인할 필요가 있습니다. 서버까지 구축 후 푸쉬를 보내어 보았는데, 안되면, 과연 서버 문제인지, 클라이언트 문제인지 파악하기 힘들 수 있습니다. 그래서 다른 사람들이 구축해 놓은 서버 프로그램으로 푸쉬가 잘되는지 확인할 수 있습니다. 우리는 http://apns-gcm.bryantan.info 라는 사이트를 이용할 것 입니다.

당연한 이야기 일 수 있습니다만, 앱이 종료된 상태여야 푸쉬가 옵니다. 앱이 켜진 상태에서는 푸쉬를 보내도 푸쉬가 오지 않습니다.!!

그리고, 이 것을 테스트 하기 위해서는 푸쉬 인증서가 필요하며, 위의 인증서 설명 링크를 통해 인증서를 만들 도록 하시기 바랍니다.

먼저 pans-gcm ( http://apns-gcm.bryantan.info ) 에 접속 합니다. 아래와 같은 화면이 나오면, 각 값을 입력해 줍니다.

Device Token에는 기기를 APNs에 등록하고, 받아 왔던 토큰, Message는 보낼 메시지를 넣어주세요. Pem File은 인증서로 만들었던, 파일을 넣어주세요. Environment는 Sandbox를 선택해 줍니다. 그리고 Submit 버튼을 누르면, 메시지가 보내어 집니다.

 

원래 계획은 이곳에 서버 제작도 넣으려고 했으나, 따로 분리하는 것이 좋겠다 생각되어, 클라이언트 제작 내용만 남깁니다. 이 후 서버 제작 부분도 페이지를 만들도록 하겠습니다.