FabrizioBrancati/BFKit-Swift — 997 Stars

Topics

#appkit #bfkit #bfkit-swift #carthage #cocoapods #codebeat #codecov #foundation #ios #linux #macos #swift #swift-3 #swift-extensions #swift-package-manager #uikit #watchkit #xcode

Language breakdown

Swift 99.3%

Ruby 0.3%

Shell 0.2%

Objective-C 0.2%

▸ Files click to expand

README

[ Version ][Documentation] [][Documentation]

Features • Classes and Extensions Compatibility • Requirements • Communication • Contributing • Installing and Usage • Documentation • Changelog • Example • Todo • Author • License

Features ========

BFKit-Swift is a collection of useful classes, structs and extensions to develop Apps faster.
For example you can use every iOS font with just an enum!
It also adds some useful functions with Custom classes and extends Foundation, UIKit, AppKit and WatchKit classes.

Classes and Extensions Compatibility ====================================

BFKit

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | BFApp | ![✓] | ![✓] | ![✓] | ![✓] | | BFBiometric | ![✓] | | | | | BFButton | ![✓] | | | | | BFDataStructures
(List - Queue - Stack) | ![✓] | ![✓] | ![✓] | ![✓] | | BFLog | ![✓] | ![✓] | ![✓] | ![✓] | | BFPassword | ![✓] | ![✓] | ![✓] | ![✓] | | BFSystemSound | ![✓] | | | | | BFTextField | ![✓] | | | | | BFTouchID | ![✓] | | | |

Foundation

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | Array | ![✓] | ![✓] | ![✓] | ![✓] | | Collection | ![✓] | ![✓] | ![✓] | ![✓] | | Data | ![✓] | ![✓] | ![✓] | ![✓] | | Date | ![✓] | ![✓] | ![✓] | ![✓] | | FileManager | ![✓] | ![✓] | ![✓] | ![✓] | | Number | ![✓] | ![✓] | ![✓] | ![✓] | | NSObject | ![✓] | ![✓] | ![✓] | ![✓] | | NSAttributedString | ![✓] | ![✓] | ![✓] | | | NSPointerArray | ![✓] | ![✓] | ![✓] | | | ProcessInfo | ![✓] | ![✓] | ![✓] | ![✓] | | Set | ![✓] | ![✓] | ![✓] | ![✓] | | String | ![✓] | ![✓] | ![✓] | ![✓] | | Thread | ![✓] | ![✓] | ![✓] | ![✓] |

Core Graphics

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | CGPoint | ![✓] | ![✓] | ![✓] | |

UIKit / AppKit

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | UIBarButtonItem | ![✓] | | | | | UIButton | ![✓] | | | | | UIColor | ![✓] | ![✓] | ![✓] | | | UIDevice | ![✓] | | | | | UIFont | ![✓] | | ![✓] | | | UIImage | ![✓] | | ![✓] | | | UIImageView | ![✓] | | | | | UILabel | ![✓] | | | | | UINavigationBar | ![✓] | | | | | UIPasteboard | ![✓] | | | | | UIScreen | ![✓] | | | | | UIScrollView | ![✓] | | | | | UITableView | ![✓] | | | | | UITextField | ![✓] | | | | | UITextView | ![✓] | | | | | UIToolbar | ![✓] | | | | | UIView | ![✓] | | | | | UIViewController | ![✓] | | | | | UIWindow | ![✓] | | | |

WebKit

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | UIWebView | ![✓] | ![✓] | | |

WatchKit

| | iOS | macOS | watchOS | Linux | |-----------------|---------|-----------|-------------|-----------| | WKInterfaceController | | | ![✓] | |

Requirements ============

| Swift | Xcode | BFKit-Swift | iOS | macOS | watchOS | Linux | |-----------|-------------|-----------------|----------|------------|-------------|-----------| | 1.2 | 6.3 | 1.0.0...1.4.1 | 7.0+ | | | | | 2.0...2.1 | 7.0 | 1.5.0...1.6.2 | 7.0+ | | | | | 2.2 | 7.3 | 1.6.3...1.7.0 | 7.0+ | | | | | 2.3 | 8.0 | 1.8.0 | 7.0+ | | | | | 3.0...3.1 | 8.0...8.3 | 2.0.0...2.3.0 | 8.0+ | | | ![✓] | | 3.0...3.1 | 8.0...8.3 | 2.4.0...2.5.0 | 8.0+ | | 2.0+ | ![✓] | | 3.0...3.2 | 8.0...9.0 | 2.6.0 | 8.0+ | 10.10+ | 2.0+ | ![✓] | | 4.0 | 9.0...9.2 | 3.0.0...3.1.1 | 8.0+ | 10.10+ | 3.0+ * | ![✓] | | 4.1 | 9.3...9.4 | 3.1.2...3.2.1 | 8.0+ | 10.10+ | 3.0+ * | ![✓] | | 4.2 | 10.0 | 4.0.0...4.1.0 | 8.0+ | 10.10+ | 3.0+ * | ![✓] | | 5.0 | 10.2...10.3 | 5.0.0 | 8.0+ | 10.10+ | 3.0+ * | ![✓] | | 5.1 | 11.2 | 6.0.0...6.0.1 | 8.0+ | 10.10+ | 3.0+ * | ![✓] |

* With App Extension Support

Communication =============

If you need help, open an issue
If you found a bug, open an issue.
If you have a feature request, open an issue.
If you want to contribute, see Contributing section.

Contributing ============

See CONTRIBUTING.md file.

Installing and Usage ====================

See Requirements section to check Swift, Xcode, BFKit-Swift and OS versions.

Manual

Open and build the framework from the project (BFKit.xcodeproj)
Import BFKit.framework into your project
Import the framework with
```
BFKit
```
Enjoy!

CocoaPods

Create a Podfile in your project directory and write into:

platform :ios, '8.0' xcodeproj 'Project.xcodeproj' use_frameworks!

pod 'BFKit-Swift'

Change "Project" with your real project name
Open Terminal, go to your project directory and type:
```
install
```
Import the framework with
```
BFKit
```
Enjoy!

Carthage

Create a Cartfile in your project directory and write into:

github "FabrizioBrancati/BFKit-Swift"

Open Terminal, go to project directory and type:
```
update
```
Include the created Framework in your project
Add Build Phase with the following contents:

/usr/local/bin/carthage copy-frameworks

Add the paths to the BFKit-Swift framework under Input Files

$(SRCROOT)/Carthage/Build/iOS/BFKit.framework

Add the paths to the copied frameworks to the Output Files

$(BUILTPRODUCTSDIR)/$(FRAMEWORKSFOLDERPATH)/BFKit.framework

This script works around an App Store submission bug triggered by universal binaries and ensures that necessary bitcode-related files are copied when archiving

(Optional) Add Build Phase with the following contents

/usr/local/bin/carthage outdated --xcode-warnings

To automatically warn you when one of your dependencies is out of date

Import the framework with
```
BFKit
```
Enjoy!

Swift Package Manager

Create a Package.swift file in your project directory and write into:

// swift-tools-version:5.1     import PackageDescription
let package = Package(         name: "Project",         products: [             .executable(name: "Project", targets: ["Project"])         ],         dependencies: [             .package(url: "https://github.com/FabrizioBrancati/BFKit-Swift.git", .upToNextMajor(from: "4.0.0"))         ],         targets: [             .target(name: "Project", dependencies: ["BFKit"])         ]     )