bb9z/rfkit

Toolkit for daily Cocoa development. Since 2012.

RFKit

English 简体中文 🇨🇳

RFKit is a useful toolkit for daily Cocoa development.

Requirements

RFKit Version	Minimum Xcode Version	Minimum iOS Target	Minimum macOS Target	Minimum watchOS Target	Minimum tvOS Target
2.5+	Xcode 9	iOS 9	macOS 10.9	watchOS 2.0	tvOS 9.0
2.4	Xcode 8	iOS 8	macOS 10.8	watchOS 2.0	tvOS 9.0
2.0-2.3	Xcode 8	iOS 6	macOS 10.8	watchOS 2.0	tvOS 9.0
1.7	Xcode 7	iOS 6	macOS 10.8	watchOS 2.0	tvOS 9.0
1.6	Xcode 8	iOS 6	N/A	watchOS 2.0	N/A

Install

CocoaPods

To install using CocoaPods, add the following to your project Podfile:

pod 'RFKit'

Specify develop branch to install the lastest version:

pod 'RFKit', :git => 'https://github.com/BB9z/RFKit.git', :branch => 'develop'

A more complex sample:

pod 'RFKit',
    :git => 'https://github.com/BB9z/RFKit.git',
    :subspecs => ['Default', 'Category/NSDateFormatter']

Carthage

Although I recommend using CocoaPods, Carthage is still supported.

Specify RFKit in your Cartfile:

github "BB9z/RFKit"

Manual

You can always import RFKit by adding source code into your project. Just copy any files you needs.

dout

dout contains a set of convenient log toolcha, which was designed for debugging.

Features:

• Out out format is better than NSLog(), and more faster.

• Auto add expression before the results.

  e.g.:

  int a = 10;
  dout_int(101+a)  // Output: 101+a = 111

• Optimized for multiple threads debugging, you can easily find the output come from which thread.

• Support add position information in log output to help tracking location of log statements. Set DOUT_FALG_TRACE as 1 to active.

• Special log methods for warning and error. Can change theirs behave to throw exception or assert fail.

• Behavior can be highly customizable through the switch.

• As macro, usually no performance loss.

Details: dout Document(in Chinese)

RFRuntime

Handle build or runtime differences. Provides an unified and simple interface for upper components. Contains：debugging switch define, default header file, RFARC and language extensions.

Debugging switch

RFDEBUG, RFKit debug mode switch. Set as 1 to active. If it´s not defined, will defined as 1 when DEBUG is true and NDEBUG not defined.

RFDebugLevel, controlling debugging behavior. If it´s not defined, will be defined as 2 if RFDEBUG is true, otherwise 1.

Default header file

UIKit and Foundation header is included in RFRuntime by default.

RFFeatureSupport

Defined some fake protocols for declaring a class support something or not.

RFDispatch

Some helper function for GCD.

Language extensions

Include some components from libextobjc:

• metamacros.h, macros for metaprogramming.
• EXTKeyPathCoding, allows compile-time verification of key paths.
• EXTScope, several tools relative to scope.

@keypathClassInstance is similar with @keypath, but accept a class as parameter instead of a instance variable.

UIKit & Foundation Categories

Important part of RFKit. They contains many useful methods.

RFKitDefaultCategories.h defends which extension is imported by default.

See each header file to know the specific features.

RFGeometry

Add new methods and constants for geometry structures: CGPoint, CGSize, CGRect. Add an new CGAngle angle structure.

RFResizeAnchor and RFAlignmentAnchor provides a reference for resizing and aligning.

RFPerformance & doutkit

Performance toolkit.

Others

Some external components were placed under external folder.

Change log

rfkit's Issues

2.0 Roadmap

• Remove all deprecated code.
• doc to wiki
• Merge RFUI/Core
• CI
• Lisence file rename
• change log file
• Swift enhance