罗朝辉(飘飘白云)

关注嵌入式操作系统,移动平台,图形开发。-->加微博 ^_^

  C++博客 :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理 ::
  85 随笔 :: 0 文章 :: 169 评论 :: 0 Trackbacks
[Cocoa]在工程中
使用
Three20 库
罗朝辉 (http://www.cppblog.com/kesalin/
CC 许可,转载请注明出处
Three20 是 facebook 开源的一款功能齐全又强大的库,覆盖 UI,network,JSON/XML解析等。其 github 仓库在这里:https://github.com/facebook/three20 ,这个页面也有如何在工程中添加 three20 库的介绍,不过在 Lion 版下以及 xcode 4.2 下有些许不同,英文好的同学可以参看原文。现整理如下:
1,新建一个名为 Three20Demo 的 Empty Application;

2,在这页面上下载 three20 zip源代码工程;解压到与 Three20Demo 项目平级的目录下;

3,拖拽 "three20/src/Three20/" 目录下的 Three20.xcodeproj 到 Three20Demo 工程中,如下图。


4,选中  Three20Demo 的 target ,在 Build Phases 的 Link Binary With Libraries 中添加 three20 的静态库。如下图:


5,拖拽 "three20/src" 下面的Three20.bundle 到 Three20Demo 工程下,在弹出的对话框中不要选择 Copy Item into 那个选项,选择第二个 Create groups for any added folders。


6,类似第4步,向 three20Demo 中添加 QuartzCore.framework 。

7,在工程的 Build settings 中向 "Other Linker Flags" 添加 -ObjC 和 -all_load 两项。


8,编译运行工程,然后至你自己用户的 Library 目录下拷贝 three20 头文件至你的项目目录下。(Lion版本无法查看隐藏目录,command + shift + G ,然后输入 ~/Library,就可以找到隐藏的library)。 three20 目录位于:
/Users/yourname/Library/Developer/Xcode/DerivedData/Three320Demo-XXXXXX/Build/Products/three20


9,在工程的 Build settings 中向 "Header Search Paths" 添加 three20,并选中 Recursive 选项。


10, 至此,所有的配置工作完成,你可以在工程中使用包含如下头文件:#import <Three20/Three20.h> 来使用 Three20 库。

Three20 解压的包里面有个 sample 目录,里面展示了大部分 api 的使用,可以运行看看。
下面我将演示如何使用 TTTableViewController。

向工程中添加类 KSDataSource 这个类作为 TTTableView 的 datasource。
KSDataSource.h
//
//  DataSource.h
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import <Three20/Three20.h>

// Model
//
@interface KSMockModel : NSObject <TTModel> 
{
@private
    NSArray * allNames;
    NSMutableArray * names;
    NSMutableArray * delegates;
    
    NSTimer* fakeSearchTimer;
    NSTimeInterval fakeSearchDuration;
    NSTimer* fakeLoadingTimer;
    NSTimeInterval fakeLoadingDuration;
}

@property(nonatomic,retain) NSArray * names;
@property(nonatomic) NSTimeInterval fakeSearchDuration;
@property(nonatomic) NSTimeInterval fakeLoadingDuration;

+ (NSMutableArray *) fakeNames;

- (id)initWithNames:(NSArray *)names;
- (void)search:(NSString *)text;

@end

// DataSource
//
@interface KSDataSource : TTSectionedDataSource
{
    KSMockModel * mockModel;
}

@property(nonatomic,readonly) KSMockModel * mockModel;

@end

KSDateSource.m:
//
//  DataSource.m
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import "KSDataSource.h"

@interface KSMockModel ()

- (void) loadNames;

@end

@implementation KSMockModel

@synthesize names;
@synthesize fakeSearchDuration, fakeLoadingDuration;

+ (NSMutableArray *) fakeNames
{
    return [NSMutableArray arrayWithObjects:
            @"Hector Lewis",
            @"Juanita Fredrick",
            @"Richard Raymond",
            @"Marcia Myer",
            @"Shannon Mahoney",
            @"James Steiner",
            @"Daniel Lloyd",
            @"Fredrick Hutchins",
            @"Tracey Smith",
            @"Brandon Rutherford",
            @"Megan Lopez",
            @"Jean Trujillo",
            @"Franklin Diamond",
            @"Mildred Jacobsen",
            @"Sandra Adams",
            @"Debra Pugliese",
            @"Cynthia Hall",
            @"Joshua Hicks",
            @"Lorenzo Evatt",
            @"Erica Dozier",
            @"Barbara Lazarus",
            @"Joye Hocker",
            @"Henry Arana",
            @"Glen Cabrales",
            nil];
}

- (id) initWithNames:(NSArray *)nameArray
{
    self = [super init];
    if (self)
    {
        delegates = nil;
        allNames = [nameArray copy];
        names = nil;
        fakeSearchTimer = nil;
        fakeSearchDuration = 0;
    }

    return self;
}

- (void) dealloc
{
    TT_INVALIDATE_TIMER(fakeSearchTimer);
    TT_INVALIDATE_TIMER(fakeLoadingTimer)
    TT_RELEASE_SAFELY(allNames);
    TT_RELEASE_SAFELY(names);
    TT_RELEASE_SAFELY(delegates);
    
    [super dealloc];
}

// TTModel
//
- (NSMutableArray*) delegates
{
    if (!delegates)
    {
        delegates = TTCreateNonRetainingArray();
    }
    
    return delegates;
}

- (BOOL)isLoadingMore
{
    return NO;
}

- (BOOL)isOutdated
{
    return NO;
}

- (BOOL)isLoaded
{
    return !!names;
}

- (BOOL)isLoading
{
    return !!fakeSearchTimer || !!fakeLoadingTimer;
}

- (BOOL)isEmpty
{
    return !names.count;
}

- (void)fakeLoadingReady
{
    fakeLoadingTimer = nil;
    
    [self loadNames];
    
    [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
}

- (void)load:(TTURLRequestCachePolicy)cachePolicy more:(BOOL)more
{
    [delegates perform:@selector(modelDidStartLoad:) withObject:self];
    
    if (fakeLoadingDuration)
    {
        TT_INVALIDATE_TIMER(fakeLoadingTimer);
        fakeLoadingTimer = [NSTimer scheduledTimerWithTimeInterval:fakeLoadingDuration
                                                            target:self
                                                           selector:@selector(fakeLoadingReady)
                                                          userInfo:nil
                                                           repeats:NO];
        [delegates perform:@selector(modelDidStartLoad:) withObject:self];
    } 
    else
    {
        [self loadNames];

        [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
    }
}

- (void)invalidate:(BOOL)erase 
{
}

- (void)cancel
{
    if (fakeSearchTimer)
    {
        TT_INVALIDATE_TIMER(fakeSearchTimer);
        [delegates perform:@selector(modelDidCancelLoad:) withObject:self];
    }
    else if (fakeLoadingTimer)
    {
        TT_INVALIDATE_TIMER(fakeLoadingTimer);
        [delegates perform:@selector(modelDidCancelLoad:) withObject:self];    
    }
}

// public
//
- (void)loadNames
{
    TT_RELEASE_SAFELY(names);
    names = [allNames mutableCopy];
}

- (void)search:(NSString *)text
{
    [self cancel];
    
    TT_RELEASE_SAFELY(names);
    if (text.length)
    {
        if (fakeSearchDuration)
        {
            TT_INVALIDATE_TIMER(fakeSearchTimer);
            fakeSearchTimer = [NSTimer scheduledTimerWithTimeInterval:fakeSearchDuration
                                                               target:self
                                                              selector:@selector(fakeSearchReady:)
                                                             userInfo:text
                                                              repeats:NO];
            [delegates perform:@selector(modelDidStartLoad:) withObject:self];
        }
        else
        {
            [self fakeSearch:text];
            [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
        }
    }
    else
    {
        [delegates perform:@selector(modelDidChange:) withObject:self];
    }
}

@end

//
// DataSource
//
@implementation KSDataSource

@synthesize mockModel;

- (id) init
{
    self = [super init];
    if (self)
    {
        mockModel = [[KSMockModel alloc] initWithNames:[KSMockModel fakeNames]];
        self.model = mockModel;
    }
    return self;
}

- (void)dealloc
{
    TT_RELEASE_SAFELY(mockModel);

    [super dealloc];
}

// UITableViewDataSource
//
- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView
{
    return [TTTableViewDataSource lettersForSectionsWithSearch:YES summary:NO];
}

- (void) tableViewDidLoadModel:(UITableView *)tableView
{
    self.items = [NSMutableArray array];
    self.sections = [NSMutableArray array];
    
    NSMutableDictionary * groups = [NSMutableDictionary dictionary];
    for (NSString * name in mockModel.names)
    {
        NSString * letter = [NSString stringWithFormat:@"%C", [name characterAtIndex:0]];
        NSMutableArray * section = [groups objectForKey:letter];
        if (!section)
        {
            section = [NSMutableArray array];
            [groups setObject:section forKey:letter];
        }
        
        TTTableItem * item = [TTTableTextItem itemWithText:name URL:nil];
        [section addObject:item];
    }
    
    NSArray * letters = [groups.allKeys sortedArrayUsingSelector:@selector(caseInsensitiveCompare:)];
    for (NSString * letter in letters)
    {
        NSArray * items = [groups objectForKey:letter];
        [_sections addObject:letter];
        [_items addObject:items];
    }
}

- (id<TTModel>) model
{
    return mockModel;
}

@end

然后修改 KSViewController.h为:
#import <Three20/Three20.h>

@interface KSViewController : TTTableViewController <TTTableViewDataSource, TTTableViewDelegate>

@end

KSViewController.m为:
//
//  KSViewController.m
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import "KSViewController.h"
#import "KSDataSource.h"

@implementation KSViewController

// TTTableView
//
- (void) createModel
{
    KSDataSource *dataSource = [[KSDataSource alloc] init];
    dataSource.mockModel.fakeLoadingDuration = 2.0;
    dataSource.mockModel.fakeSearchDuration  = 2.0;
   
    self.dataSource = dataSource;
    [dataSource release];
}

- (id<TTTableViewDelegate>) createDelegate
{
    TTTableViewDragRefreshDelegate *delegate = [[TTTableViewDragRefreshDelegate alloc] initWithController:self];
    
    return [delegate autorelease];
}

// TTTableViewDelegate
//
- (void)tableView:(UITableView *)tableView touchesBegan:(NSSet *)touches withEvent:(UIEvent*)event
{
    
}

- (void)tableView:(UITableView *)tableView touchesEnded:(NSSet *)touches withEvent:(UIEvent*)event
{
    
}

@end

现在编译运行,你应该可以看到一个 loading 界面,2秒(代码中有设定)之后进入 tableview 界面,在 tableview 中进行下拉操作,可以看到刷新功能以及在里面了!这个效果和我们使用下拉刷新库 EGOTableViewPullRefresh 的效果是一样的。
posted on 2011-12-31 17:45 罗朝辉 阅读(2577) 评论(0)  编辑 收藏 引用 所属分类: 移动开发Cocoa 开发

只有注册用户登录后才能发表评论。
【推荐】超50万行VC++源码: 大型组态工控、电力仿真CAD与GIS源码库
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理