原文:iOS Programming Architecture and Design Guidelines
原文来自破船的分享
原文作者是开发界中知晓度相当高的 Mugunth Kumar,他是 MKNetworkKit 的作者(虽然没有 AFNetworking 使用那么广泛,但也是一个很棒的 Network Kit),更是最近流传甚广的《iOS 5/6 Programming – Pushing The Limits》的作者。
文章中 MK 介绍了几点开发中常用的小技巧,几条 Tips 简单易懂,但是很实用,不但可以提高开发效率,而且可以提高代码的可读性和可复用性。
Types in Objective-C 和 Naming Conventions 两个章节介绍性内容较多,下面从 Subclassing 开始简单直译一下,第一次翻译,有诸多不到位的地方,各位多包涵。
大多语言允许开发者子类化框架所提供的类,但是在 Objective-C 中不完全是这样。大部分常用的类,诸如 NSArray、NSSet、NSDictionary 基本上都是集合类型的。不建议继承这些类,除非你准备转发调用或者实现所有必要的原始方法。
在传统的开发语言中,通常会通过继承基础类型(类似 NSArray 的类)来新增方法,重载已有的方法,或是自定义 UI 组件的外观。在 Objective-C 中,一般通过 Category 来扩展新方法。通过混合方法(swizzling the method?)来重载 SDK 提供的实现。以及外观相关的代理协议(Protocol)来定制 UI 组件的外观。
虽说如此,还是有一些类是经常会继承它们的,比如 UIViewController、UITableViewController、UIControl 等。继承 UIViewController 大概是开发过程中最棒的一件事,因为它使得添加常见的功能变得异常简单。在我开发的每个 App 中,会有一个继承自 UIViewController 的子类,它实现了一组常用的方法。所有其他的 View Controllers 则都继承自这个基础类。
(译者注:Web 开发中也常会有一个用于被继承的 BaseController 来提供公共方法,看来开发是触类旁通的,要多思考)
所以,以下继承方法:
1 |
@interface MyAppFeaturedYouTubeVideosViewController : UIViewController |
应该替换成:
1 2 |
@interface MyAppFeaturedYouTubeVideosFeaturedViewController : MyAppViewController @interface MyAppViewController : UIViewController |
这个公用基础类可以在后续开发过程中用来添加公用的方法。在这个基础父类中,我通常会申明以下方法:
1 2 3 4 5 6 |
-(UIView*) errorView; -(UIView*) loadingView; -(void) showLoadingAnimated:(BOOL) animated; -(void) hideLoadingViewAnimated:(BOOL) animated; -(void) showErrorViewAnimated:(BOOL) animated; -(void) hideErrorViewAnimated:(BOOL) animated; |
实现如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
-(UIView*) errorView { return nil; } -(UIView*) loadingView { return nil; } -(void) showLoadingAnimated:(BOOL) animated { UIView *loadingView = [self loadingView]; loadingView.alpha = 0.0f; [self.view addSubview:loadingView]; [self.view bringSubviewToFront:loadingView]; double duration = animated ? 0.4f:0.0f; [UIView animateWithDuration:duration animations:^{ loadingView.alpha = 1.0f; }]; } -(void) hideLoadingViewAnimated:(BOOL) animated { UIView *loadingView = [self loadingView]; double duration = animated ? 0.4f:0.0f; [UIView animateWithDuration:duration animations:^{ loadingView.alpha = 0.0f; } completion:^(BOOL finished) { [loadingView removeFromSuperview]; }]; } -(void) showErrorViewAnimated:(BOOL) animated { UIView *errorView = [self errorView]; errorView.alpha = 0.0f; [self.view addSubview:errorView]; [self.view bringSubviewToFront:errorView]; double duration = animated ? 0.4f:0.0f; [UIView animateWithDuration:duration animations:^{ errorView.alpha = 1.0f; }]; } -(void) hideErrorViewAnimated:(BOOL) animated { UIView *errorView = [self errorView]; double duration = animated ? 0.4f:0.0f; [UIView animateWithDuration:duration animations:^{ errorView.alpha = 0.0f; } completion:^(BOOL finished) { [errorView removeFromSuperview]; }]; } |
现在,App 中的每个 View Controller 中,可以很方便的通过调用以上方法来改变当前 View 的状态为 Loading 或者 Error。而且,View Controller 可以通过重载 -errorView 和 -loadingView 方法来提供自定义错误界面和 Loading 界面。
你还可以通过重载这个基础类中的 -viewDidLoad 来统一修改所有 View 的表现。比如为所有的 View 添加相同的背景图片或背景色:
1 2 3 4 5 |
- (void)viewDidLoad { [super viewDidLoad]; self.view.backgroundColor = [UIColor appOffWhiteColor]; // changes all my views to "off-white" } |
自定义 UI 可以大致分成两类,一是自定义控件,二是皮肤/主题。前者可以让 App 更出色,而后者是大部分 App 都需要的。我建议给 UIFont 和 UIColor 写 Category 扩展来提供自定义字体和自定义颜色。
例如,给 UIFont 添加如下方法:
1 2 3 4 5 6 7 8 9 |
+(UIFont*) appFontOfSize:(CGFloat) pointSize { return [UIFont fontWithName:@"MyriadPro-Regular" size:pointSize]; } +(UIFont*) boldAppFontOfSize:(CGFloat) pointSize { return [UIFont fontWithName:@"MyriadPro-Black" size:pointSize]; } |
你就可以很方便地使用 [UIFont appFontOfSize:13] 得到 MyriadPro-Regular 字体。这样当你的设计需求变更时,就可以很快速的更换整个 App 中的字体。
相同的设计模式也可以应用到自定义颜色中。给 UIColor 添加以下方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
#define GREY(color) [UIColor colorWithRed:color/255.0 green:color/255.0 blue:color/255.0 alpha:1] +(UIColor*) appBackgroundColor { return [UIColor colorWithPatternImage:[UIImage imageNamed:@"BGPattern"]]; } +(UIColor*) appBlack1Color { return GREY(38); } +(UIColor*) appOffWhiteColor { return GREY(234); } |
所以,千万不要用 Interface Builder 来选颜色。
还有一个小窍门,当开发者继承 UILabel、UITextField 和 UITextView 时,通常在 -initWithFrame: 和 -initWithCoder: 方法中设置字体和颜色,参见以下代码:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
@implementation AppPrefixLabel -(void) setup { self.font = [UIFont fontWithName:@"SourceSansPro-Semibold" size:self.font.pointSize]; self.textColor = [UIColor redColor]; } -(id) initWithFrame:(CGRect)frame { if((self = [super initWithFrame:frame])) { [self setup]; } return self; } -(id) initWithCoder:(NSCoder *)aDecoder { if((self = [super initWithCoder:aDecoder])) { [self setup]; } return self; } @end |
这个技巧使得开发者可以在 Interface Builder 中自定义这些元素的外观。在 IB 中拖入一个 UILabel,并且修改它的类为你自定义的类,瞬间就完成了这个 Label 字体和颜色的自定义,不用任何多余的代码。
这个技巧多数情况下相当管用,但是当你的 App 支持自定义主题,且用户可以通过设置界面更换主题时,就会显得有些麻烦。
-initWithFrame: 和 initWithCoder: 会在 UI 组件创建的时候被调用,所以在这之后如果要改变字体和颜色,就需要很多额外的代码。因此,如果你的 App 支持主题,写一个主题管理器的全局单例来提供全局的主题、字体、颜色。
如果你用到了我说的第一个方法,你的 UIFont 的 Category 现在可以这样实现了:
1 2 3 4 5 |
+(UIFont*) appFontOfSize:(CGFloat) pointSize { NSString *currentFontName = [[ThemeProvider sharedInstance] currentFontName]; return [UIFont fontWithName:currentFontName size:pointSize]; } |
UIColor 同理。其实没有正确或错误的方法,上述方法都是可行的。
遵从这里提到的设计模式,可以让你的代码干净得像写的很漂亮的 JS/CSS。试着在你的下一个项目中用这些方法吧。