Contacts Demo in Swift 2 – Showing Contacts Picker, Load Contacts in Custom TableView, Add New Contact, Update Contact, Delete Contact, Search Contact

By | February 23, 2016

In Today’s post I will show you How to do below things in Swift 2…

    1. Show Contact Picker using System In-Built UI & Pick a Contact
    2. Load all Contacts in a TableView
    3. Search a Contact
    4. Add a New Contact
    5. Update a Contact
    6. Delete a Contact


Before using the contacts we need to get permission from the User. For that we need to call some functions. I will write those functions in the AppDelegate method.


My AppDelegate will look like this.


import UIKit
import ContactsUI
import AddressBook

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

var window: UIWindow?
let contactStore = CNContactStore()

func showAlertMessage(message: String) {
	
	let alertController = UIAlertController(title: "Contacts Demo Swift", message: message, preferredStyle: UIAlertControllerStyle.Alert)
	
	let dismissAction = UIAlertAction(title: "OKAY", style: UIAlertActionStyle.Default) { (action) -> Void in
	}
	
	alertController.addAction(dismissAction)
	
	let pushedViewControllers = (self.window?.rootViewController as! UINavigationController).viewControllers
	let presentedViewController = pushedViewControllers[pushedViewControllers.count - 1]
	
	//Show the Alert
	presentedViewController.presentViewController(alertController, animated: true, completion: nil)
	
}

func requestForAccess(completionHandler: (accessGranted: Bool) -> Void) {
	let authorizationStatus = CNContactStore.authorizationStatusForEntityType(CNEntityType.Contacts)
	
	switch authorizationStatus {
	case .Authorized:
		completionHandler(accessGranted: true)
		
	case .Denied, .NotDetermined:
		self.contactStore.requestAccessForEntityType(CNEntityType.Contacts, completionHandler: { (access, accessError) -> Void in
			if access {
				completionHandler(accessGranted: access)
			}
			else {
				if authorizationStatus == CNAuthorizationStatus.Denied {
					dispatch_async(dispatch_get_main_queue(), { () -> Void in
						let message = "\(accessError!.localizedDescription)\n\nPlease allow the app to access your contacts through the Settings."
						self.showAlertMessage(message)
					})
				}
			}
		})
		
	default:
		completionHandler(accessGranted: false)
	}
}
}

1. Show Contact Picker using System In-Built UI & Pick a Contact



How to Do

You need to use an instance of the CNContactPickerViewController class inside the ContactsUI framework. It has two delegate methods.

func contactPickerDidCancel(picker: CNContactPickerViewController)
Gets called when the user cancels his request to pick a contact.

contactPicker(picker: CNContactPickerViewController, didSelectContact contact: CNContact)
Gets called when the user picks a contact from the Contacts list.

CNContactPickerViewController cannot be pushed to the stack, they need to be presented modally.
So For showing the CNContactPickerViewController you need to do like this.

 
   self.presentViewController(peoplePicker, animated: true, completion: nil)
    

I will show up the Contacts List using the Inbuild System UI.

Now we will implement “didSelectContact” delegate…

If the person has multiple contact numbers, then it will show an alert to select one..

func contactPicker(picker: CNContactPickerViewController, didSelectContact contact: CNContact) {
	self.statusLabel.hidden = true
	//Dismiss the picker VC
	picker.dismissViewControllerAnimated(true, completion: nil)
	//See if the contact has multiple phone numbers
	if contact.phoneNumbers.count > 1 {
		
		self.showContactView.hidden = false
		
		//If so we need the user to select which phone number we want them to use
		let multiplePhoneNumbersAlert = UIAlertController(title: "Which one?", message: "This contact has multiple phone numbers, which one did you want use?", preferredStyle: UIAlertControllerStyle.Alert)
		//Loop through all the phone numbers that we got back
		for number in contact.phoneNumbers {
			//Each object in the phone numbers array has a value property that is a CNPhoneNumber object, Make sure we can get that
			if let actualNumber = number.value as? CNPhoneNumber {
				//Get the label for the phone number
				var phoneNumberLabel = number.label
				//Strip off all the extra crap that comes through in that label
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("_", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("$", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("!", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("<", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString(">", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				//Create a title for the action for the UIAlertVC that we display to the user to pick phone numbers
				let actionTitle = phoneNumberLabel + " - " + actualNumber.stringValue
				//Create the alert action
				let numberAction = UIAlertAction(title: actionTitle, style: UIAlertActionStyle.Default, handler: { (theAction) -> Void in
					//Create an empty string for the contacts name
					var nameToSave = ""
					//See if we can get A frist name
					if contact.givenName == "" {
						//If Not check for a last name
						if contact.familyName == "" {
							//If no last name set name to Unknown Name
							nameToSave = self.UNKNOWN_NAME
						}else{
							nameToSave = contact.familyName
						}
					}else{
						nameToSave = contact.givenName
					}
					
					// See if we can get image data
					if let imageData = contact.imageData {
						//If so create the image
						let userImage = UIImage(data: imageData)
						self.imgContact.image = userImage;
					}
					//Do what you need to do with your new contact information here!
					//Get the string value of the phone number like this:
					actualNumber.stringValue
					
					self.lblName.text = nameToSave;
					self.lblNumber.text = actualNumber.stringValue
				})
				//Add the action to the AlertController
				multiplePhoneNumbersAlert.addAction(numberAction)
			}
		}
		//Add a cancel action
		let cancelAction = UIAlertAction(title: "Cancel", style: UIAlertActionStyle.Cancel, handler: { (theAction) -> Void in
			//Cancel action completion
			print("User Cancelled")
		})
		//Add the cancel action
		multiplePhoneNumbersAlert.addAction(cancelAction)
		//Present the ALert controller
		self.presentViewController(multiplePhoneNumbersAlert, animated: true, completion: nil)
	}else{
		//Make sure we have at least one phone number
		if contact.phoneNumbers.count > 0 {
			
			self.showContactView.hidden = false
			
			//If so get the CNPhoneNumber object from the first item in the array of phone numbers
			if let actualNumber = contact.phoneNumbers.first?.value as? CNPhoneNumber {
				//Get the label of the phone number
				var phoneNumberLabel = contact.phoneNumbers.first!.label
				//Strip out the stuff you don't need
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("_", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("$", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("!", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString("<", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				phoneNumberLabel = phoneNumberLabel.stringByReplacingOccurrencesOfString(">", withString: "", options: NSStringCompareOptions.LiteralSearch, range: nil)
				
				//Create an empty string for the contacts name
				var nameToSave = ""
				//See if we can get A frist name
				if contact.givenName == "" {
					//If Not check for a last name
					if contact.familyName == "" {
						//If no last name set name to Unknown Name
						nameToSave = UNKNOWN_NAME
					}else{
						nameToSave = contact.familyName
					}
				}else{
					nameToSave = contact.givenName
				}
				
				self.lblName.text = nameToSave
				
				// See if we can get image data
				if let imageData = contact.imageData {
					//If so create the image
					let userImage = UIImage(data: imageData)
					self.imgContact.image = userImage;
				}
				//Do what you need to do with your new contact information here!
				//Get the string value of the phone number like this:
				print(actualNumber.stringValue)
				self.lblNumber.text = actualNumber.stringValue
			}
		}else{
			
			self.statusLabel.hidden = false;
			self.statusLabel.text = NO_PHONE_NUMBERS
			
		}
	}
}

contactPickerDidCancel Delegate..

 
    func contactPickerDidCancel(picker: CNContactPickerViewController) {
        picker.dismissViewControllerAnimated(true, completion: nil)
    }

2. Load all contacts from the System Contacts.


I am assuming that you will have a Tableview with Custom Cell for displaying a Contact Name and Thumbnail image of the contact.

The below function will fetch all the contacts.

func fetchContacts()
{      
	dataArray = NSMutableArray()
	
	let toFetch = [CNContactGivenNameKey, CNContactImageDataKey, CNContactFamilyNameKey, CNContactImageDataAvailableKey]
	let request = CNContactFetchRequest(keysToFetch: toFetch)
	
	do{
		try appDelegate.contactStore.enumerateContactsWithFetchRequest(request) {
			contact, stop in
			print(contact.givenName)
			print(contact.familyName)
			print(contact.identifier)
			
			var userImage : UIImage;
			// See if we can get image data
			if let imageData = contact.imageData {
				//If so create the image
				userImage = UIImage(data: imageData)!
			}else{
				userImage = UIImage(named: "no_contact_image")!
			}
			
			let data = Data(name: contact.givenName, image: userImage)
			self.dataArray?.addObject(data)
			
		}
	} catch let err{
		print(err)
		self.errorStatus()
	}
	
	self.tableView.reloadData()
    
}

3. Search a Contact.

There are actually three different methods for searching contacts.

1. unifiedContactsMatchingPredicate(_:keysToFetch:) method of CNContactStore
This allows you to fetch all contacts that match a certain predicate.

2. enumerateContactsWithFetchRequest(_:usingBlock:) method of CNContactStore
This allows you to enumerate through all contacts that match a fetch request.
The fetch request can have a predicate if you want it to.
Otherwise, you can use this method with a request object that does not have a predicate, in order to fetch all contacts.

3. unifiedContactWithIdentifier(_:keysToFetch:) method of CNContactStore
This fetches only a single contact with a given identifier, if it can find one.
Use this method to fetch properties for a partially fetched contact.

Code

func findInContacts()
{
	
	dataArray = NSMutableArray()
	
	let searchKey = "coderzheaven"
	var toFetch = [CNContactGivenNameKey, CNContactImageDataKey, CNContactFamilyNameKey, CNContactImageDataAvailableKey]
	let predicate = CNContact.predicateForContactsMatchingName(searchKey)
	
	do{
		
	
		let contacts = try appDelegate.contactStore.unifiedContactsMatchingPredicate(predicate,
			keysToFetch: toFetch)
		
		for contact in contacts{
			
			/*
				guard contact.imageDataAvailable else{
					continue
				}
			*/
			
			if contact.isKeyAvailable(CNContactImageDataKey){
			   
				var userImage : UIImage;
				// See if we can get image data
				if let imageData = contact.imageData {
					//If so create the image
					userImage = UIImage(data: imageData)!
				}else{
					userImage = UIImage(named: "no_contact_image")!
				}
				
				let data = Data(name: contact.givenName, image: userImage)
				self.dataArray?.addObject(data)
				
			} else {
				
				toFetch += [CNContactImageDataKey, CNContactGivenNameKey]
				do{
					let contact = try appDelegate.contactStore.unifiedContactWithIdentifier(
						contact.identifier, keysToFetch: toFetch)
					print(contact.givenName)
					print(contact.identifier)
					
				} catch let err{
					print(err)
				}
				
			}
			
		}
		
		 self.tableView.reloadData()
	
	} catch let err{
		print(err)
	}

}

4. Add a New Contact..

We have to do the following things to add a contact

  • Request access from the user for accessing Contacts.
  • Create an instance of the CNMutableContact class.
  • Set the properties we want to fetch from the Contacts Database like given name, email address etc.
  • Instantiate CNSaveRequest, call the addContact(_:toContainerWithIdentifier:) method on it, and pass your contact to it. Set the container ID to nil.
    Once you have the request, execute it on your store instance using executeSaveRequest(_:).

The below fuction will add a contact to the Contacts Database.

 
func createContact()
{
	let fooBar = CNMutableContact()
	fooBar.givenName = "Coderz"
	fooBar.middleName = "Heaven"
	fooBar.familyName = "Coderz"
	fooBar.nickname = "Coderz"
	
	//profile photo
	if let img = UIImage(named: "no_contact_image"),
		let data = UIImagePNGRepresentation(img){
			fooBar.imageData = data
	}
	
	//set the phone numbers
	let homePhone = CNLabeledValue(label: CNLabelHome,
		value: CNPhoneNumber(stringValue: "1234567"))
	let workPhone = CNLabeledValue(label: CNLabelWork,
		value: CNPhoneNumber(stringValue: "9876543"))
	fooBar.phoneNumbers = [homePhone, workPhone]
	
	//set the email addresses
	let homeEmail = CNLabeledValue(label: CNLabelHome,
		value: "coderzheaven@gmail.com")
	let workEmail = CNLabeledValue(label: CNLabelWork,
		value: "coderzheaven@gmail.com")
	fooBar.emailAddresses = [homeEmail, workEmail]
	
	//job info
	fooBar.jobTitle = "Software Developer"
	fooBar.organizationName = "CoderzHeaven"
	fooBar.departmentName = "IT"
	
	//social media
	let facebookProfile = CNLabeledValue(label: "FaceBook", value:
		CNSocialProfile(urlString: nil, username: "CoderzHeaven",
			userIdentifier: nil, service: CNSocialProfileServiceFacebook))
	let twitterProfile = CNLabeledValue(label: "Twitter", value:
		CNSocialProfile(urlString: nil, username: "coderzheaven",
			userIdentifier: nil, service: CNSocialProfileServiceTwitter))
	fooBar.socialProfiles = [facebookProfile, twitterProfile]
	
	//instant messaging
	let skypeAddress = CNLabeledValue(label: "Skype", value:
		CNInstantMessageAddress(username: "coderzheaven",
			service: CNInstantMessageServiceSkype))
	fooBar.instantMessageAddresses = [skypeAddress]
	
	//some additional notes
	fooBar.note = "Heaven of all working codes."
	
	//birthday
	let birthday = NSDateComponents()
	birthday.year = 1987
	birthday.month = 9
	birthday.day = 27
	fooBar.birthday = birthday
	
	//finally save
	let request = CNSaveRequest()
	request.addContact(fooBar, toContainerWithIdentifier: nil)
	do{
		try appDelegate.contactStore.executeSaveRequest(request)
		print("Successfully added the contact")
		self.statusLabel.text = ("Successfully added the contact \n\(fooBar.givenName)")
	} catch let err{
		print("Failed to save the contact. \(err)")
		self.statusLabel.text = ("Failed to add the contact")
	}
}

5. Update a Contact.



How to do?

  • Call the mutableCopy() method of your CNContact class will give you an instance of the CNMutableContact
  • Change properties as you would with a contact of type CNContact.
  • Instantiate CNSaveRequest, call the updateContact(_:) method on it, and pass your mutable contact to that method.

Code


func updateContact()
{
	let predicate = CNContact.predicateForContactsMatchingName("coderzheaven")
	let toFetch = [CNContactGivenNameKey]
	
	do{
		
		let contacts = try appDelegate.contactStore.unifiedContactsMatchingPredicate(predicate,
			keysToFetch: toFetch)
		
		guard contacts.count > 0 else{
			print("No contacts found")
			return
		}
		
		//only do this to the first contact matching our criteria
		guard let contact = contacts.first else{
			return
		}
		
		let newName = "CoderzHeaven New"
		
		let newContact = contact.mutableCopy() as! CNMutableContact
		
		//set new name
		newContact.givenName = newName
		
		let req = CNSaveRequest()
		req.updateContact(newContact)
		
		/** To add new email address 
		
		let emailAddress = CNLabeledValue(label: CNLabelWork,
			value: "newemail@email.com")
		
		newContact.emailAddresses.append(emailAddress)

		**/
		
		try appDelegate.contactStore.executeSaveRequest(req)
		
		print("Successfully edited")
		
		self.statusLabel.hidden = false
		self.statusLabel.text = "Successfully Updated coderzheaven"
		
}
		
catch let err{
	print(err)
	self.errorStatus()
}


}

6. Delete a Contact

How to ?

  • Find the Contact to delete using the methods mentioned in the Search Contact Section
  • Instantiate an object of type CNSaveRequest.
  • Issue the deleteContact(_:) function on the request and pass your mutable contact to it.
  • Execute your request using the executeSaveRequest(_:) method of your contact store.

Code

func deleteContact()
{
	let predicate = CNContact.predicateForContactsMatchingName("coderzheaven")
	let toFetch = [CNContactEmailAddressesKey]
	
	do{
		
		let contacts = try appDelegate.contactStore.unifiedContactsMatchingPredicate(predicate,
			keysToFetch: toFetch)
		
		guard contacts.count > 0 else{
			print("No contacts found")
			return
		}
		
		//only do this to the first contact matching our criteria
		guard let contact = contacts.first else{
			return
		}
		
		let req = CNSaveRequest()
		let mutableContact = contact.mutableCopy() as! CNMutableContact
		req.deleteContact(mutableContact)
		
		do{
			try appDelegate.contactStore.executeSaveRequest(req)
			print("Successfully deleted the Contact")
			self.statusLabel.text = "Successfully Deleted coderzheaven"
			
		} catch let e{
			print("Error = \(e)")
		}
		
	} catch let err{
		print(err)
		self.errorStatus()
	}
}

You can download the complete Source Code from here.