Skip to content

Latest commit

 

History

History
96 lines (67 loc) · 2.73 KB

README.md

File metadata and controls

96 lines (67 loc) · 2.73 KB
Raw

UI7Kit

UI7Kit is a GUI toolkit to backport flat-style UIKit from iOS7 to iOS5/iOS6. Additionally, UI7Kit can be used to patch legacy UIKit to UI7Kit in runtime.

NOTE: This project is very immature and in progressing. It is not a good idea that try this for complex real-world product. Reporting or contributing any missing feature would be appreciated.

Goal

  • Implement flat-style iOS7 theme to iOS5/6 (Except status bar).
  • Patch the classic UIKit to UI7Kit in runtime. (Renew your legacy app just in a line!)
  • 100% UIKit compatibility.

How to use

Case 1: Dynamic patch (Mostly recommended)

#import <UI7Kit/UI7Kit.h>
UI7KitPatchAll(NO); // in main.m, before UIApplicationMain()

Case 2: Partial usage : Use UI7 instead of UI. : ex) UI7NavigationController, instead of UINavigationController

Case 3: Partial dynamic patch

#import <UI7Kit/UI7Kit.h>
[UI7<class> patch]; // ex) [UI7TableView patch];

Example

Example with current code. (0.0.7)

Current status.

Contact

  • Github issues are appreciated.
  • Email: Address is in LICENSE or git log.
  • IRC: Visit irc://irc.freenode.org/#youknowone for instant message. (You need an IRC client)

How to run test app

Download source code

# Copy and paste this lines
git clone git://github.com/youknowone/UI7Kit.git
cd UI7Kit
pod install
open UI7Kit.xcworkspace # You should open xcwordspace

If you don't have cocoapods, visit http://www.cocoapods.org or follow steps below:

# At first, install Commoand Line Tools from XCode->Preferences->Downloads.
sudo gem install cocoapods # May takes long time
pod setup # Do not sudo here

Run test app now.

How to update

Update source code and cocoapods

git pull # if you edited code, 'git fetch origin && git rebase origin/master'
pod update
open UI7Kit.xcworkspace # You should open xcwordspace

If you have problem with missing methods, 'pod update' usually solves it.

How to install to my project

NOTE: This project is very immature yet.

If you don't have cocoapods, visit http://www.cocoapods.org or follow steps below:

# Install Commoand Line Tools in XCode->Preferences->Downloads first.
sudo gem install cocoapods
pod setup # Do not sudo here

If you have Podfile, add 'UI7Kit'. Or follow steps below:

# Copy and paste this lines
echo "platform :ios" > Podfile
echo "pod 'UI7Kit'" >> Podfile
pod install
open *.xcworkspace

This command will generate or edit YourProject.xcworkspace. Open this instead of your original YourProject.xcodeproj.

Implementations

  • Hope to list here something ;)