Latest 0.7.1
Homepage https://github.com/SocialbitGmbH/SwiftAddressBook
License Apache 2.0
Platforms ios 8.0, requires ARC
Frameworks AddressBook, AddressBookUI
Authors

SwiftAddressBook – A strong-typed Swift Wrapper for ABAddressBook

CI Status
Version
License
Platform

Complete wrapper for the ABAddressBook C-Framework for iOS, written in Swift to be typesafe and convenient

Description

It is tedious and requires very much reading in the documentation if you want to understand the ABAddressBook in iOS. To provide a solution, this wrapper uses Swift, which is strong-typed (unlike c). It also circumvents the use of unsafe c-pointers when accessing ABAddressBook from Swift, by directly casting them to the correct type. All properties, previously only available via the correct key, can now be accessed conveniently via variables.

Here´s how you would access ABAddressBook via SwiftAddressBook: How To

Some minimal examples below:

  1. Request access (important: changed in 0.6.1)

    SwiftAddressBook.requestAccessWithCompletion({ (success, error) -> Void in
      if success {
        //do something with swiftAddressBook
      }
      else {
        //no success. Optionally evaluate error
      }
    })
  2. Use Addressbook:

    • Get array of all people and log their phone numbers

      if let people = swiftAddressBook?.allPeople {
        for person in people {
          NSLog("%@", person.phoneNumbers?.map( {$0.value} ))
        }
      }
    • Filter by people who have an email address

      if let people = swiftAddressBook?.allPeople?.filter({ $0.emails?.count > 0 }) {
        // do something with them
      }
    • Create Contacts

      var person = SwiftAddressBookPerson.create()
      person.firstName = "John"
      
      var email = MultivalueEntry(value: "[email protected]", label: "home", id: 0)
      person.emails = [email]
      
      swiftAddressBook?.addRecord(person)
      swiftAddressBook?.save()

Complicated Swift typecasting to NS-…, thousand times of unwrapping optionals, figuring out which constant is the key to your person property, distinguishing between group, source or person – nothing that you have to deal with any more

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

SwiftAddressBook is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "SwiftAddressBook"

Note: version 0.36 requires you to also specify the flag

use_frameworks!

as documented here
and then import SwiftAddressBook in your project (and import AddressBook for using constants from ABAddressBook)

If you don´t want to use CocoaPods, or need to maintain iOS7 compatibility, just copy all files from the folder Pod/Classes into your project. This way, you don´t need to import SwiftAddressBook

License

Copyright 2014 Socialbit GmbH

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.   

Latest podspec

{
    "name": "SwiftAddressBook",
    "version": "0.7.1",
    "summary": "Strong Typed ABAddressBook wrapper written in Swift 3.0",
    "description": "It is tedious and requires very much reading in the documentation if you want to understand the ABAddressBook in iOS. To provide a solution, this wrapper uses Swift, which is strong-typed (unlike c). It also circumvents the use of unsafe c-pointers when accessing ABAddressBook from Swift, by directly casting them to the correct type. All properties, previously only available via the correct key, can now be accessed conveniently via variables.",
    "homepage": "https://github.com/SocialbitGmbH/SwiftAddressBook",
    "license": "Apache 2.0",
    "authors": {
        "Tassilo Karge": "[email protected]"
    },
    "source": {
        "git": "https://github.com/SocialbitGmbH/SwiftAddressBook.git",
        "tag": "0.7.1"
    },
    "social_media_url": "https://twitter.com/socialbit_de",
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "module_name": "SwiftAddressBook",
    "source_files": "Pod/Classes/**/*",
    "frameworks": [
        "AddressBook",
        "AddressBookUI"
    ],
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This