#Bee framework
A rapid development framework for iOS applications, from geek. :-)
QQ Group(QQ群号): 79054681
QQ: 5220509
Email: gavinkwoe@gmail.com
##v0.1 changes
- Add more DEMOs (useful~~)
- Add Heatmap (cool~~)
For all the coding ninjas out there
Ever want to build better iOS apps faster and cheaper? Check out Bee, a new rapid development framework that will turbo charge your new projects!
Welcome Bee
Bee is a rapid development framework for iOS applications, which integrates COCOA TOUCH components and provides concise interface, allowing developers to develop apps more quickly. Bee adds features to COCOA TOUCH to simplify implementation and reduce the amount of code you need to write, freeing up your time to do what you enjoy, building cool apps.
Who is Bee for?
- You want a compact framework 2 You need to develop a working app quickly
- You like to write simple and well structured codes
- You need to something with complete, clear documentation
- You hate complex designs
- You hate to all the hidden rules you need to follow in iOS development
If you agree with one or more of the above, congratulations! Bee framework is for you.
Basic requirements
- You have some knowledge of Objective-C
- You know what CocoaTouch is
- You know what MVC, View, ViewController are
If you know one or more of the above, congratulations! Bee framework is for you.
Join a growing family
Developers from top Asian sites like Baidu, Tencent and Sina are using this, join us!
QQ group: 79054681 Forum: http://bbs.whatsbug.com (website maintenance)
Bee is free
The Bee is distributed under the MIT open source license so please feel free to use it in any project:
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Bee is lightweight
The use of the base class library and MVC is optional, the core part of the framework is very compact.
Bee is fast and reliable
Bee allows your app to run quickly and smoothly. Tested in a number of projects to ensure reliability.
Bee uses M-V-C model
With Bee, the interface and logic has been separated, allowing you to reuse codes more easily. You can also resuse elements to build your interface.
M: Model - data persistence or and caching all in here
C: Controller - business logic and cloud interaction logic live here
V: View - ViewController interface display and interface logic here
Bee uses a clean VIEW structure
Bee split the complex and usually difficult UI development process into 3 parts: View, Layout and Data. For web developers this can be thought of as HTML, CSS, data. Interface gets redrawn when the data is loaded or changed. To simplify the code, you only need to know when View is filled with new data before the layout is updated.
The product's UI often needs refactoring, which makes life for IOS developers more difficult. So what should you do when you know the interface will change but you still want to use interface builder to build a demo quickly and don't want to write dynamic coordinate calculations?
Bee gives you a simple solution, you can use a UI "cell", the BeeUIGridCell class, for the most important elements. Here are the three simple steps (more details shown later):
- Calculate size of the canvas cellSize: bound:
- Calculate internal layout cellLayout: bound:
- Fill data (strings, images, etc.) bindData:
You can use these simple three functions to meet the requirements of various UI changes.
This solution is simple without sacrificing flexibility. BeeUIGridCell can correspond to multiple layouts and you can quickly finish UI adjustments without changing the logic and without increasing or decreasing the number of internal elements.
Here's an example cell layout (more details in later chapters):
-- xxxView.h
// Layout 1
@interface MyLayout1 : NSObject
AS_SINGLETON(MyLayout1)
@end
// Layout 2
@interface MyLayout2 : NSObject
AS_SINGLETON(MyLayout2)
@end
@interface MyCell : BeeUIGridCell
{
UILabel * _subView1;
UILabel * _subView2;
}
@end
-- xxxView.mm
@implementation MyLayout1
+ (CGSize)cellSize:(NSObject *)data bound:(CGSize)bound
{
return CGSizeMake( bound.width, 90.0f ); // width unchanged, height 90
}
- (void)cellLayout:(BeeUIGridCell *)cell bound:(CGSize)bound
{
_subView1.frame = …;
_subView2.frame = …;
}
- (void)bindData:(NSObject *)data
{
_subView1.text = …;
_subView2.text = …;
[super bindData:data]; // Bee will determine whether the data has changed, then recalculate layout
}
}
@end
...
{
MyCell * cell = [[MyCell alloc] init];
if ( ... )
cell.layout = [MyLayout1 sharedInstance];
else
cell.layout = [MyLayout2 sharedInstance];
}
-- xxxViewController.mm
{
MyCell * cell = ...;
[cell bindData:[NSDictionary dictionary]]; // mode 1, automatic layout
[cell layoutAllSubcells]; // mode 2, manual layout
}
After seeing this you may ask: we now have a 'HTML', 'CSS', 'Data', but where did 'Javascript' go to? How can events be passed and processed?
You have two options, a traditional Delegate or a new way using UISignal. The two options essentially do the same thing, but the latter is a simpler and better way of passing events between multilayers UIView.
Another example illustrates UISignal (more details in later chapters):
-- xxxView.h
@interface MyCell : BeeUIGridCell
AS_SIGNAL( TEST ) // declare SIGNAL
@end
-- xxxView.m
@implementation MyCell
DEF_SIGNAL( TEST ) // define SIGNAL
- (void)someEvent
{
[self sendUISignal:MyCell.TEST]; // send the signal
}
@end
-- xxxViewController.m
- (void)loadView
{
MyCell * cell = [[MyCell alloc] init];
[self.view addSubview:cell];
}
- (void)handleUISignal:(BeeUISignal *)signal
{
if ( [signal is:MyCell.TEST] )
{
// do something
}
[super handleUISignal:signal]; // pass to super view
As you can see, the UIView hierarchical relationship exists and UISignal can move up from views below. Define method is also easy, can just use DEF_SIGNAL().
Later chapters will introduce examples of more complex UI implementations developed using Bee to illustrate how it works.
Q: How can your interface can be split into a number of Cells? How to replace Delegate with Signal?
Using Bee for clean CONTROLLER structure
The Controller is where the logic of the application lives, also known as the "business logic". How to effectively organize business logic, how to effectively reuse business logic, and how to decouple the VIEW as much as possible?
Bee completely separates the Controller from the View via Message (the messaging mechanism). Bee allows automatic message routing that can be asynchronous. It is also responsible for communicating with the cloud (server).
You can see it this way:
- View just shows data in the right format and occasionally produces user driven events
- Controller is only responsible for the implementation of logic (even if executed on the server side) and the results (data) is returned to the View to be displayed.
As we mentioned earlier, the equivalent of this in web development is: View is HTML + CSS, Controller is AJAX. One thing to note, if the Controller contains logic executed in the Cloud, the request will take time, and will need to be asynchronous.
This example shows how to use the Controller ( will be described in more detail later):
-- xxxController.h
@interface MyController : BeeController
AS_MESSAGE( TEST ) // declare the message
@end
-- xxxController.mm
@implementation MyController
DEF_MESSAGE( TEST ) // define the message
- (void)TEST:(BeeMessage *)msg
{
if ( msg.sending ) // being sent
{
NSString * param1 = [msg.input objectForKey:@"param1"];
NSString * param2 = [msg.input objectForKey:@"param2"];
// Controller request data from a website
[msg POST:@"http://api.XXX.com/" data:...];
}
else if ( msg.progressed ) // send / receive progress updates
{
}
else if ( msg.succeed ) // success
{
NSDictionary * obj = [msg.response objectFromNSData]; // parse response to package
if ( nil == obj )
{
[msg setLastError:... domain:...]; // abnormal situation, do something
return;
}
[msg output:@"result", obj, nil]; // output results
}
else if ( msg.failed ) // error
{
}
else if ( msg.cancelled ) // canceled
{
}
}
-- xxxViewController.mm
....
{
// MyController automatically initialized and mounted by Bee
[MyController sharedInstance];
}
....
{
// Your code can send a message anywhere, it is automatically routed to MyController :: TEST method
[[self sendMessage:MyController.TEST] input:
@"param1", @"value1", // input parameters 1
@"param2", @"value2", // input parameters 2
nil];
}
....
- (void)handleMessage:(BeeMessage *)msg
{
if ( [msg is:MyController.TEST] )
{
[self showLoading:msg.sending]; // update interface state
if ( msg.succeed )
{
// Prompt success
}
else
{
// Send fail
}
}
}
You can see here the complete separation of the View from the Controller, and how simple the sending and receiving of messages has become.
Defining the message is also extremely simple, just DEF_MESSAGE ().
More details are introduced in later chapters.
Q: Think about how your APP should use several Controllers, and about the Messages to be sent between them?
The Bee using clean MODEL structure
Very simple, see Bee_Model.h. Will have ActiveRecord support in the future.
Bee also provides other powerful features
In-app debugging mode, performance monitoring, asynchronous network communication, multi-threaded, easy expandability, UIView extensions and more.
Bee-depth used by top Internet companies
Top Internet companies already use this framework to build many successful apps.
Bee Cheat Sheet
.Foundation
.Cache
BeeFileCache - file cache
BeeMemoryCache - memory cache
.Network
BeeRequest - network request
.Debug
BeeCallFrame - call stack
BeeRuntime - run
BeePerformance - perfromance testing
.FileSystem
BeeSandbox - sandbox
.Utility
BeeLog() / CC - log
BeeSystemInfo - system information
.Thread
BeeTaskQueue - multi-threaded execution queue
.MVC
.Controller
BeeMessage - message
BeeMessageQueue - message queue
BeeController - controller
.Model
BeeModel - data model
.View
.UI
BeeUIScrollView - horizontal / vertical scroll list
BeeUIPageControl - page
BeeUINavigationBar - navigation bar
BeeUIActionSheet - pop-up menu
BeeUIActivityIndicatorView - loading indicator
BeeUIAlertView - pop-up dialog box
BeeUIButton - button
BeeUIDatePicker - date picket
BeeUIFont - font
BeeUIGridCell - cell
BeeUIImageView - images
BeeUIKeyboard - keyboard
BeeUILabel - label
BeeUIOrientation - interface orientation
BeeUIProgressView - progress bar
BeeUIPullLoader - pull-down refresh
BeeUISegmentedControl - segmented indicator
BeeUISignal - signal
BeeUITabBar - tab menu
BeeUITextField - single-line text box
BeeUITextView - multi-line text box
BeeUIWebView - webview
BeeUIZoomView - zoom
.UIController
BeeUIBoard - whiteboard (UIViewController)
BeeUIStack - whiteboard stack (UINavigationController)
BeeUIStackGroup - stack
BeeUICameraBoard - camera
BeeUIFlowBoard - data stream
BeeUITableBoard - table
BeeUIWebBoard - browser
Requirements
- Mac OS X 10.6, Xcode 4
- iOS 4.0 or Higher
File Directory
- BeeDebugger/
- BeeFramework/
- External/: 3rd-party libs
- Foundation/: Bee foundation
- MVC/: Bee MVC
- Example/
- Documention/
How to run
- Open Example/WhatsBug.xcodeproj
- Build and run
Installation
- Copy BeeFramework/ and BeeDebugger into your project folder
- Drag and drop both two source folder into your XCode project
- Add Framework:
a. libz.dlib
b. CFNetwork.framework
c. CoreGraphics.framework
d. Foundation.framework
e. MobileCoreServies.framework (ASI)
f. QuartzCore.framework
g. Security.framework (MD5)
h. SystemConfiguration.framework (Reachibility)
i. UIKit.framework - Modify your precompile header file:
a. #define _BEE_DEVELOPMENT_ (1)
b. #define _BEE_LOG_ (1)
c. #define _BEE_DEBUGGER_ (1) - Build and run
- Good luck