Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/artsabintsev/fontblaster
Programmatically load custom fonts into your iOS, macOS and tvOS app.
https://github.com/artsabintsev/fontblaster
carthage cocoapods custom-fonts plist swift swift-package-manager tvos
Last synced: 3 months ago
JSON representation
Programmatically load custom fonts into your iOS, macOS and tvOS app.
- Host: GitHub
- URL: https://github.com/artsabintsev/fontblaster
- Owner: ArtSabintsev
- License: mit
- Archived: true
- Created: 2015-05-06T02:43:14.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-29T14:27:46.000Z (4 months ago)
- Last Synced: 2024-09-25T23:03:19.922Z (3 months ago)
- Topics: carthage, cocoapods, custom-fonts, plist, swift, swift-package-manager, tvos
- Language: Swift
- Homepage: https://sabintsev.com/
- Size: 15 MB
- Stars: 1,160
- Watchers: 21
- Forks: 103
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FontBlaster
### Programmatically load custom fonts into your iOS, macOS, and tvOS app.
  [](https://cocoapods.org/pods/FontBlaster) [](https://swift.org/package-manager/)
---
## About
Say goodbye to importing custom fonts via property lists as **FontBlaster** automatically imports and loads all fonts in your app's Bundles with one line of code.
## Features
- [x] CocoaPods Support
- [x] Swift PM Support
- [x] Automatically imports fonts from `Bundle.main`
- [x] Able to import fonts from remote bundles
- [x] Sample Project
## Installation Instructions
| Swift Version | Branch Name | Will Continue to Receive Updates?
| ------------- | ------------- | -------------
| 5.1+ | master | **Yes**
| 5.0 | swift5.0 | No
| 4.2 | swift4.2 | No
| 4.1 | swift4.1 | No
| 3.2 | swift3.2 | No
| 3.1 | swift3.1 | No
### CocoaPods
```ruby
pod 'FontBlaster' # Swift 5.1+
pod 'FontBlaster', :git => 'https://github.com/ArtSabintsev/FontBlaster.git', :branch => 'swift5.0' # Swift 5.0
pod 'FontBlaster', :git => 'https://github.com/ArtSabintsev/FontBlaster.git', :branch => 'swift4.2' # Swift 4.2
pod 'FontBlaster', :git => 'https://github.com/ArtSabintsev/FontBlaster.git', :branch => 'swift4.1' # Swift 4.1
pod 'FontBlaster', :git => 'https://github.com/ArtSabintsev/FontBlaster.git', :branch => 'swift3.2' # Swift 3.2
pod 'FontBlaster', :git => 'https://github.com/ArtSabintsev/FontBlaster.git', :branch => 'swift3.2' # Swift 3.1
```
### Swift Package Manager
``` swift
.Package(url: "https://github.com/ArtSabintsev/FontBlaster.git", majorVersion: 4)
```
### Manual
1. [Download FontBlaster](//github.com/ArtSabintsev/FontBlaster/archive/master.zip).
2. Copy `FontBlaster.swift` into your project.
## Setup
Typically, all fonts are automatically found in `Bundle.main`. 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:
```Swift
FontBlaster.blast() // Defaults to Bundle.main 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 `Bundle` in the `blast(_:)` method:
```Swift
FontBlaster.blast(bundle:) // Takes one argument of type Bundle, or as mentioned above, defaults to Bundle.main 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 `Bundle` or defaults to `Bundle.main` if no argument is passed.
```Swift
// Defaults to Bundle.main 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(bundle:) { (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:
```Swift
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 on the navigation bar. After pushing the button, **FontBlaster** imports your fonts and redraws the view.
## Inspiration
This project builds upon an old solution that [Marco Arment](http://twitter.com/marcoarment) proposed and wrote about on his [blog](http://www.marco.org/2012/12/21/ios-dynamic-font-loading).
## Created and maintained by
[Arthur Ariel Sabintsev](http://www.sabintsev.com/)