FontBlaster

Programmatically load custom fonts into your iOS app.

About

Say goodbye to importing custom fonts via property lists as FontBlaster automatically imports and loads all fonts in your app's NSBundles with one line of code.

Features

CocoaPods Support
Automatically imports fonts from NSBundle.mainbundle()
Automatically imports fonts from bundles inside your mainBundle
Able to import fonts from remote bundles
Sample Project

Installation Instructions

CocoaPods

pod 'FontBlaster'

Carthage

github "ArtSabintsev/FontBlaster"

Swift Package Manager

.Package(url: "https://github.com/ArtSabintsev/FontBlaster.git", majorVersion: 2)

Manual

Download FontBlaster.
Copy FontBlaster.swift into your project.

Setup

Typically, all fonts are automatically found in NSBundle.mainBundle(). Even if you have a custom bundle, it's usually lodged inside of the mainBundle. Therefore, to load all the fonts in your application, irrespective of the bundle it's in, simply call:

FontBlaster.blast() // Defaults to NSBundle.mainBundle() if no arguments are passed

If you are loading from a bundle that isn't found inside your app's mainBundle, simply pass a reference to your NSBundle in the blast(_:) method:

FontBlaster.blast(_:) // Takes one argument of type NSBundle, or as mentioned above, defaults to NSBundle.mainBundle() if no arguments are passed

If you need a list of all of the loaded fonts, an overloaded version of the blast(_:) method has a completion handler that returns just that. Just like the original method, this method takes either a custom NSBundle or defaults to `NSBundle.mainBundle()`` if no argument is passed.

// Defaults to NSBundle.mainBundle() as no argument is passed
FontBlaster.blast() { (fonts) in
  print(fonts) // fonts is an array of Strings containing font names
}

// Custom bundle is passed as argument
FontBlaster.blast(_:) { (fonts) in
  print(fonts) // fonts is an array of Strings containing font names
}

To turn on console debug statements, simply set debugEnabled() = true before calling either blast() method:

FontBlaster.debugEnabled = true
FontBlaster.blast()

Sample Project

A Sample iOS project is included in the repo. When you launch the app, all fonts are configured to load custom fonts, but don't actually display them until you push the button. After pushing the button, FontBlaster imports your fonts and redraws the view.

Inspiration

This project builds upon an old solution that Marco Arment proposed and wrote about on his blog.

Created and maintained by

Arthur Ariel Sabintsev

alexpopov/FontBlaster