[Swift] Bento #1. iPhone 연락처 가져오기

ㅎㅎ 또 오랜만에 글을 써봅니다~~

앞으로 종종 연락처 가져오기, 이메일보내기, 전화걸기, 앱실행하기, 로컬Noti, 보안 등등 아이폰의 OS기능(?)을 사용하는 것들에 대해서 몇가지를 정리해보려고 해요!!

이 항목들을 간단히 Bento 시리즈! 라고 하고 시작해볼게요 👉

 

첫번째 포스팅은 연락처 가져오기입니다!

---

먼저 휴대폰의 연락처에 접근하려면, 사용자가 권한을 허락해야 되요!!

앱 설치하거나, 카메라로 찍으려고 하거나 등등 할때 이런거 많이 보셨죠~~?

이 권한을 획득하기 위해, 프로젝트 설정을 해줍니다.

Info.plist에 이 항목을 추가해주세요!

 

저는 이런 특정 목적을 가지는 기능들을 프로토콜로 따로 정의를 해둬요.

이번에는 연락처 관련된 내용이니까 ContactUsable이라고 프로토콜을 정의해서 개발했습니다!

 

먼저 전체소스에요.

import Contacts

protocol ContactUsable {}
extension ContactUsable {
    
    func getContacts() {
        let store = CNContactStore()
        var contacts: [Contact] = []
        
        // 연락처에 요청할 항목
        let keys = [CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey] as [CNKeyDescriptor]
        // Request 생성
        let request = CNContactFetchRequest(keysToFetch: keys)
        request.sortOrder = CNContactSortOrder.userDefault
        
        // 권한체크
        store.requestAccess(for: .contacts) { granted, error in
            guard granted else { return }
                do {
                    // 연락처 데이터 획득
                    try store.enumerateContacts(with: request) { (contact, stop) in
                        guard let phoneNumber = contact.phoneNumbers.first?.value.stringValue else { return }
                        let id = contact.identifier
                        let givenName = contact.givenName
                        let familyName = contact.familyName
                        
                        let contactToAdd = Contact(id: id, firstName: familyName, givenName: givenName, phoneNumber: phoneNumber)
                        contacts.append(contactToAdd)
                    }
                } catch let error {
                    print(error.localizedDescription)
                }

            DataManager.shared.contacts = contacts
        }
    }
}

 

하나씩 살펴볼게요~!

let store = CNContactStore()
var contacts: [Contact] = []

연락처 꾸러미(?)를 CNContactStore 객체로 만들어 줍니다. 말 그대로 "연락처 상점", 즉 연락처 꾸러미란 소리죠!

Contact 클래스는 따로 만들어 줬어요.

실제로 연락처 데이터를 가져와도 제가 사용할 데이터는 이름, id(식별정보), 핸드폰번호 이정도 뿐이기 때문이에요.

 

// 연락처에 요청할 항목
let keys = [CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey] as [CNKeyDescriptor]
// Request 생성
let request = CNContactFetchRequest(keysToFetch: keys)
request.sortOrder = CNContactSortOrder.userDefault

CNKeyDescriptor는 연락처에 데이터를 요청할때 어떤 데이터를 달라고 요청하는 거라고 생각하시면 되요.

저 같은 경우는 성, 이름, 핸드폰번호만 요청하게끔 한거죠.

CNContactFetchRequest() 는 방금 설정한 key를 기반으로 실제로 요청에 사용할 요청객체를 만들어주는 거에요.

CNContactSortOrder를 통해서 정렬을 해서 받아올 수도 있고요! 저의 경우에는 이름순으로 받아오도록 했습니다!

 

 // 권한체크
        store.requestAccess(for: .contacts) { granted, error in
            guard granted else { return }
                do {
                    // 연락처 데이터 획득
                    try store.enumerateContacts(with: request) { (contact, stop) in
                        guard let phoneNumber = contact.phoneNumbers.first?.value.stringValue else { return }
                        let id = contact.identifier
                        let givenName = contact.givenName
                        let familyName = contact.familyName
                        
                        let contactToAdd = Contact(id: id, firstName: familyName, givenName: givenName, phoneNumber: phoneNumber)
                        contacts.append(contactToAdd)
                    }
                } catch let error {
                    print(error.localizedDescription)
                }

            DataManager.shared.contacts = contacts
        }

store.requestAccess 메소드를 통해서 접근권한을 설정하고, 이미 설정했다면 권한 설정 여부를 받아와요.

저는 연락처 데이터에 대한 내용으로 접근권한을 요청할거니까 .contacts를 넣어준 거에요~!

 

만약 권한이 있다면, enumerateContacts() 메소드로 아까 만들었던 request를 넣어서 요청합니다.

그럼 연락처 정보가 줄줄이 받아와지게 되고, 각각에 대해서 데이터를 처리하는 로직을 작성해주시면 되요.

저는 연락처 정보를 앱 전체에서 공유할 수 있도록 DataManager라는 클래스의 싱글톤 객체에 할당해준 거에요.

 

이렇게 연락처를 가져와놓으면, 앱의 필요한 곳에서 가져다 쓸 수 있겠죠~~? 😎

 

---

Bento 프로젝트인 만큼 이런식으로 아주 간단하게 끝내봤어요!!

앱에서 연락처 사용이 필요하면 간단하게 가져와서 사용하자구요~~👍

 

 

오늘도 누군가에게 도움이 되었길 바래요 🙏