Provides easy access to font Awesome icons in iOS
Objective-C Ruby
Switch branches/tags
Latest commit b23a7b6 Apr 18, 2014 @acmacalister acmacalister changed to NS_ENUM
Permalink
Failed to load latest commit information.
FontAwesome-iOS.podspec reworked awesomeIcon logic Jan 19, 2014
LICENSE add license Apr 25, 2013
NSString+FontAwesome.h changed to NS_ENUM Apr 18, 2014
NSString+FontAwesome.m changed to NS_ENUM Apr 18, 2014
README.md update readme Dec 14, 2013

README.md

FontAwesome-iOS

FontAwesome-iOS takes the amazing font awesome (see that here: FontAwesome ) and makes it a simple category to make embedding the icons simple.

Requirements/Dependencies

Requires that you embed and use the Font Awesome font in your app.

Requires at least iOS 5/OSX 10.7 or above. Also required is: https://github.com/daltoniam/FontAwesome-iOS.

How to add a custom font to iOS app:

  1. Download the FontAwesome font.
  2. Add that font files into your project using Xcode as a resource. Make sure it is part of the "Copy Bundle Resources" in the Build Phases.
  3. Add a key to your Info.plist file called UIAppFonts. (Friendly name is: Fonts provided by application)
  4. Make sure this key an array.
  5. Enter the full name of your font file (including the extension) as an item to the UIAppFonts array. (Usually fontawesome-webfont.ttf)
  6. Save your Info.plist.
  7. Now in your application you can simply call [UIFont fontWithName:@"FontAwesome" size:12] to get the custom font to use with your UILabels and UITextViews, etc…

Also see this:

http://codewithchris.com/common-mistakes-with-adding-custom-fonts-to-your-ios-app/

If you get lost.

example

UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(20, 20, 100, 44)];
label.font = [UIFont fontWithName:@"FontAwesome" size:20];
label.text =  [NSString awesomeIcon:FaTwitter];

install

The recommended approach for installing FontAwesome-iOS is via the CocoaPods package manager, as it provides flexible dependency management and dead simple installation.

via CocoaPods

Install CocoaPods if not already available:

$ [sudo] gem install cocoapods
$ pod setup

Change to the directory of your Xcode project, and Create and Edit your Podfile and add FontAwesome-iOS:

$ cd /path/to/MyProject
$ touch Podfile
$ edit Podfile
platform :ios, '5.0'
# Or platform :osx, '10.7'
pod 'FontAwesome-iOS'

Install into your project:

$ pod install

Open your project in Xcode from the .xcworkspace file (not the usual project file)

License

##FontAwesome License

Contact

Dalton Cherry