从零开始搭建iOS项目框架

APP项目搭建

上周个人刚搭建完的项目框架，在这分享一下，主要还是采用MVC设计模式，没有使用storyboard,纯代码搭的界面。

1.新建工程

1.1 新建项目

* 删除无用的文件(Main.storyboard,ViewController)

* 删除plist文件中Main storyboard file base name一项

* appdelegate进行修改

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];

[self.window makeKeyAndVisible];

}

1.2 创建不同的target管理工程

有时候我们需要多个版本，开发版、测试版或者线上版，或因渠道不同需要区分企业版，AppStore版等。这个时候使用target来管理就比较方便

1.2.1 生成

1.2.2 修改名字

需要修改下名字target、scheme、info.plist三项的名字，主要用来区分下版本

注意:修改了info.plist名字需要修改新建的target的配置信息文件，让其能找到info.plist文件

1.2.3 修改下工程配置文件

就可以这样使用了：

#if DEVELOPMENT
NSLog(@"development");
#else
NSLog(@"release");
#endif

使用方法可参考:多个Target管理

1.3 导入CocoaPods管理依赖库

自从CocoaPods升级到1.0.1之后,为多个target导入依赖库,之前的link_with语法不能用了,使用如下方法:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, ‘7.0’

# ruby语法
# target数组 如果有新的target直接加入该数组
targetsArray = [‘MyApp’, ‘MyAppTest’]
# 循环
targetsArray.each do |t|
target t do
pod 'MJRefresh', '~> 3.1.12'
pod 'Masonry', '~> 0.6.1'
pod 'AFNetworking', '~> 3.1.0'
pod 'MJExtension'
pod 'MBProgressHUD'
pod 'SDWebImage'

end
end

使用方法可参考：CocoaPods安装教程

1.4 info.plist配置

1.4.1 开启http的访问权限

info.plist 中添加以下

1.4.2 添加应用白名单

iOS9之后分享等必须添加白名单后才可以打开相关应用。字段值为LSApplicationQueriesSchemes

1.4.3 其他

设置分享到微信、微博啊等URL Types

2.项目模块化

2.1 分类各模块

分类具体按照业务需求去归类，开发前把大体的分类号，主体的文件夹建立真实的文件夹，再把真实的文件夹拖到项目中，这样的好处是，避免了在项目中创建虚拟文件夹，然后导致各类文件都放在一块，不方便查找。

大致分类：

2.2 导入需要用的第三方库

先使用CocoaPods导入项目中一些常用的第三方库,后续再根据需求导入，有些无法用CocoaPods导入的或者是一些需要修改库中代码的拖入到工程中Vender文件夹中

2.3 创建pch文件

这个文件用来包含全局使用的头文件，例如:

1.第三方头文件

2.全局宏定义

3.自定义的头文件包含主题、网络请求地址、全局方法、key等

使用方法参考: Pch 文件的正确使用

3 全局的宏定义

具体方法大家可下载demo看下

3.1 全局配置参数DefineMacro

全局宏定义包含一些屏幕宽高、iOS版本、手机类型等

#define SCREEN_WIDTH   [UIScreen mainScreen].bounds.size.width
#define SCREENH_HEIGHT [UIScreen mainScreen].bounds.size.height
//随机颜色
#define KRandomColor [UIColor colorWithRed:arc4random_uniform(256)/255.0 green:arc4random_uniform(256)/255.0 blue:arc4random_uniform(256)/255.0 alpha:1.0]

3.2 样式定义DefineTheme

主要包含样式上的定义,主题颜色、各类字体大小颜色、控件大小等

//颜色
#define TITLE_COLOR [UIColor blackColor]//标题颜色
4000
#define TEXT_COLOR [UIColor grayColor]//正文颜色
#define TIPTEXT_COLOR UIColorFromRGB(0x888888)//提示语文本颜色
#define MAIN_GROUNDCOLOR UIColorFromRGB(0xF98B1B)//主题景色
#define BACKGROUNDCOLOR UIColorFromRGB(0xF7F7F7)//背景颜色
//字体大小
#define TITLEFONT [UIFont systemFontOfSize:18]
#define TEXTFONT [UIFont systemFontOfSize:16]
#define TIPTEXTFONT [UIFont systemFontOfSize:12]

3.3 API地址DefineRequest

访问的地址，各个接口的查询

#if DEVELOPMENT //***************开发版本*************
//****************测试环境***********
//app服务重构测试
//#define BaseURLString   @"http://www-test.baidu.com/rest/post"//beta
//#define BaseURLString @"http://docker-branch02-web-tomcat.baidu.com:8080/rest/post"//分之域名
//****************开发环境(个人服务器)************
//后台XXX
#define BaseURLString  @"http://192.168.1.175:8080/baidu/rest/post"
#else          //**************生产版本**************
#define BaseURLString @"https://www.baidu.com/rest/post"
#endif

//****************接口说明************
//获取用户信息
#define Request_type_getUserInfo @"getUserInfo"
//首页广告
#define Request_type_queryBannerByType @"queryBannerByType"

4. 初期代码编写

4.1 Category

4.1.1 Method swizzling

为Controller添加一些方法，即可省略继承baseViewController的麻烦，还可以对各工厂类进行操作

#import "UIViewController+swizzling.h"
#import <objc/runtime.h>

@implementation UIViewController (swizzling)

+ (void)load {
Method fromMethod = class_getInstanceMethod([self class], @selector(viewDidLoad));
Method toMethod = class_getInstanceMethod([self class], @selector(swizzlingViewDidLoad));

if (!class_addMethod([self class], @selector(swizzlingViewDidLoad), method_getImplementation(toMethod), method_getTypeEncoding(toMethod))) {
method_exchangeImplementations(fromMethod, toMethod);
}
}

// 我们自己实现的方法，也就是和self的viewDidLoad方法进行交换的方法。
- (void)swizzlingViewDidLoad {
NSString *str = [NSString stringWithFormat:@"%@", self.class];
if(![str containsString:@"UI"]){
NSLog(@"统计打点 : %@", self.title);
}
[self swizzlingViewDidLoad];
}
@end

4.1.2 appDelegate添加category

用以简化appDelegate中代码

AppDelegate+ViewController.h

- (void)setAppWindows
{
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];

[[UINavigationBar appearance] setTitleTextAttributes:@{NSForegroundColorAttributeName: [UIColor whiteColor]}];

[self.window makeKeyAndVisible];

}

- (void)setRootViewController
{
AppDelegate *app = (AppDelegate *)[[UIApplication sharedApplication] delegate];
app.window.rootViewController = [[RootTabViewController alloc] init];

}

AppDelegate+AppService.h

需要处理的各类服务都可以添加在这

/**
*  系统配置
*/
- (void)systemConfigration;

/**
*  友盟注册
*/
- (void)registerUmeng;
/**
*  个推注册
*/

- (void)registerGeiTui;

/**
*  检查更新
*/
- (void)checkAppUpDataWithshowOption:(BOOL)showOption;

/**
*  获取用户信息
*/
- (void)getUserData;

4.2 DataMange

存放对文件的处理方法，文件的路径

数据库的处理

NSUserDefault的处理

4.3 Other

建一个类存放比较杂乱的一些公共方法

/**验证该字符串是否是6-16位字母和数字组合*/
+ (BOOL)checkIsDigitalAndLetter:(NSString *)string;
/**利用正则表达式验证手机号码*/
+ (BOOL)checkTel:(NSString *)str;
/**利用正则表达式验证邮箱*/
+ (BOOL)checkEmail:(NSString *)email;

4.4 UITools

一些公共控件的封装，常用的一些控件进行封装（弹窗、广告轮播等），方便以后统一修改

4.4.1 NavigationViewController封装

@interface LWTNavigationViewController ()<UINavigationControllerDelegate>

@property (nonatomic, weak) id popDelegate;

@end

@implementation LWTNavigationViewController

- (void)viewDidLoad {
[super viewDidLoad];

self.popDelegate = self.interactivePopGestureRecognizer.delegate;
self.delegate = self;

//navigationBar样式设置
self.navigationBar.barTintColor = MAIN_GROUNDCOLOR;
[self.navigationBar setTitleTextAttributes:@{NSForegroundColorAttributeName : WHITCOLOR, NSFontAttributeName : [UIFont boldSystemFontOfSize:18]}];
[self.navigationBar setTintColor:WHITCOLOR];    // Do any additional setup after loading the view.
}

//解决手势失效问题
- (void)navigationController:(UINavigationController *)navigationController didShowViewController:(UIViewController *)viewController animated:(BOOL)animated
{
if (viewController == self.viewControllers[0]) {
self.interactivePopGestureRecognizer.delegate = self.popDelegate;
}else{
self.interactivePopGestureRecognizer.delegate = nil;
}
}

//push时隐藏tabbar
- (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated
{
if (self.viewControllers.count > 0) {
viewController.hidesBottomBarWhenPushed = YES;
}
[super pushViewController:viewController animated:animated];
}

//设置样式
- (UIStatusBarStyle)preferredStatusBarStyle
{
return UIStatusBarStyleLightContent;
}

//设置返回按钮样式
- (void)navigationController:(UINavigationController *)navigationController willShowViewController:(UIViewController *)viewController animated:(BOOL)animated
{

UIBarButtonItem *backBarButtonItem = [[UIBarButtonItem alloc] initWithTitle:@"返回" style:UIBarButtonItemStylePlain target:self action:@selector(backBarButtonItemAction)];
viewController.navigationItem.backBarButtonItem = backBarButtonItem;

}

- (void)backBarButtonItemAction
{
[self popViewControllerAnimated:YES];
}

- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}
@end

4.4.2 tabBarController封装

#import "RootTabViewController.h"
#import "LWTNavigationViewController.h"

# define kTabbarSelectTintColor [UIColor brownColor]
# define kTabbarNormalTintColor [UIColor blackColor]

@interface RootTabViewController ()<UITabBarControllerDelegate>

@end

@implementation RootTabViewController

- (void)viewDidLoad {
[super viewDidLoad];

[self buildUI];
// Do any additional setup after loading the view.
}

/**构建视图*/
- (void)buildUI{

self.tabBar.translucent     = NO;
self.tabBar.backgroundImage = [CommonMethods createImageWithColor:[UIColor clearColor]];
self.tabBar.shadowImage     = [CommonMethods createImageWithColor:[UIColor grayColor]];

NSArray * normalItems       = @[@"home_gray",@"circle_gray",@"me"];
NSArray * selectItmes       = @[@"home_blue",@"circle_blue",@"me_blue"];

NSArray * controllClass     = @[@"HomePageViewController",@"MessageViewController",@"MyViewController"];
self.delegate               = self;
NSArray * itemTitles        = @[@"首页",@"信息",@"我"];
NSMutableArray * controllers = [[NSMutableArray<
bed9
/span> alloc]init];
for (int i = 0; i < normalItems.count; i++)
{
UIViewController * homeview =[[NSClassFromString(controllClass[i]) alloc]init];
LWTNavigationViewController * navigation =[[LWTNavigationViewController alloc]initWithRootViewController:homeview];
navigation.tabBarItem.image                     = [[UIImage imageNamed:normalItems[i]] imageWithRenderingMode:UIImageRenderingModeAlwaysOriginal];
navigation.tabBarItem.selectedImage             = [[UIImage imageNamed:selectItmes[i]] imageWithRenderingMode:UIImageRenderingModeAlwaysOriginal];
navigation.tabBarItem.titlePositionAdjustment   = UIOffsetMake(0,-3);
[controllers addObject:navigation];

// 设置文字的样式
NSMutableDictionary *textAttrs                  = [NSMutableDictionary dictionary];
textAttrs[NSForegroundColorAttributeName]       = kTabbarNormalTintColor;
NSMutableDictionary *selectTextAttrs            = [NSMutableDictionary dictionary];
selectTextAttrs[NSForegroundColorAttributeName] = kTabbarSelectTintColor;
[homeview.tabBarItem setTitleTextAttributes:textAttrs forState:UIControlStateNormal];
[homeview.tabBarItem setTitleTextAttributes:selectTextAttrs forState:UIControlStateSelected];
// 设置tabbaritem 的title
navigation.tabBarItem.title                     = itemTitles[i];
}
self.viewControllers = controllers;
}
@end

4.5 第三方库的封装

4.5.1 网络框架

//基本参数设置
+ (AFHTTPSessionManager *)httpManager{
//获取请求对象
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
// 设置请求格式
manager.requestSerializer = [AFJSONRequestSerializer serializer];
// 设置返回格式
manager.responseSerializer = [AFHTTPResponseSerializer serializer];
[manager.requestSerializer setValue:@"application/json" forHTTPHeaderField:@"Accept"];
[manager.requestSerializer setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
manager.requestSerializer.timeoutInterval = RequestTimeOut;
return manager;
}

//请求处理
+ (void)postParameters:(id)parameters
success:(void (^)(NSDictionary *resDict))success
failure:(void (^)(NSError *error))failure
{

//    if ([[AFNetworkReachabilityManager sharedManager] networkReachabilityStatus] <= 0) {
//        [MBProgressHUD showMessageInWindow:@"网络无连接" afterDelayHide:AfterDelayHide];
//        return;
//    }
AFHTTPSessionManager *manager = [self httpManager];
//开始请求
[manager POST:BaseURLString
parameters:parameters
progress:^(NSProgress * _Nonnull uploadProgress) {
}
success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
NSMutableDictionary *resDict = (NSMutableDictionary *)[responseObject mj_JSONObject];
//              NSDictionary *dict = [HttpManager checkResultVaild:resDict withFunction:parameters[@"function"]];

//这里可以处理数据 针对接口返回的特定参数进行处理，如单点登录等需求
NSLog(@"\n接口：%@\n返回数据：%@",parameters[@"function"],[[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding]);

success(resDict);
}
failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
failure(error);
NSLog(@"\n当前接口：%@\n错误信息：%@",parameters[@"function"],error);
}];
}

4.5.2 其他第三方

UM、HUD等很多第三方框架，都需要进行封装，针对自己app需求进行配置，使用起来就比较方便。

Demo

有什么建议可以提出来，有更好的欢迎探讨，不定期更新

demo下载

参考

文中的内容有参考过以下文章，大家可以参考下

多个Target管理

CocoaPods安装教程

Pch 文件的正确使用

iOS黑魔法－Method Swizzling

手把手教你iOS项目基本框架