Ohana is a framework for working with a user's contacts on the iOS platform. It provides a component-based architecture for loading and processing contacts, as well as managing state such as contact selection and tagging. Whether loading contacts to display to a user, or processing contact data programatically, Ohana provides a simple, but extensible, framework for contact access in your application. Check out the wiki to learn how the library works. There are two quickstart guides available: one for Swift and one for Objective-C. If you have any questions, feel free to ask on Stack Overflow (tag "ohana").
- Easy to get started
- Extensible architecture
- Runtime-injectable components
To integrate Ohana into your project using CocoaPods, add the following line to your Podfile:
pod 'Ohana', '~> 1.3'
To consume Ohana using Carthage add this to your Cartfile:
github "uber/ohana-ios" ~> 1.3
You'll need to manually import Ohana, and its dependencies, libPhoneNumber and UberSignals.
Running the Examples App
- Clone the repo
git clone email@example.com:uber/ohana-ios.git
- Open the Example directory
- Run the
OhanaExamplescheme in Xcode
- Nick Entin (@NickEntin)
- Maxwell Elliott (firstname.lastname@example.org, @maxwellE)
- Doug Togno (email@example.com, @Darj)
- Adam Zethraeus (firstname.lastname@example.org, @zethraeus)
We'd love for you to contribute to our open source projects. Before we can accept your contributions, we kindly ask you to sign our Uber Contributor License Agreement.
- If you find a bug, open an issue or submit a fix via a pull request.
- If you have a feature request, open an issue or submit an implementation via a pull request
- If you want to contribute, submit a pull request.
Check out the Contribution Guidelines for more information.
Ohana is released under the MIT license. See the LICENSE file for more info.