fcgll520 / macproject

这是一个用 Objective-C 写的 iOS 轻量级框架，旨在快速构建 iOS App，欢迎 Star

#MACProject 传送门：https://github.com/azheng51714/MACProject

这是使用 Objective-C 整理的一套 iOS 轻量级框架，内部包含大量或自己整理或修改自网络的 Category 、Utils、DataManager、Macros & UIComponents 旨在快速构建中小型 iOS App，并尝试用其整理了个 MACProject 样例以来抛砖引玉，愿与大犇们相互学习交流，不足之处望批评指正， 更欢迎 Star。

##目录结构

基于MVC：对常用控件、常用扩展类、数据缓存、网络请求、工具类、常用动画进行封装或二次封装；

1. 对包括 UIImageView、UILabel、UIButton、UINavgationBar、UINavgationController、UITableView、UITextView、UISearchBar、UIViewController 等在内的常用控件及其扩展类进行了整理，其中对常用的数据加载、提示语、AlertView、sheetView也进行了一键集成；

2. 对包括 NSData、NSDate、NSString、NSArray、NSDictionary、NSNumber、NSObject 等数据类型常用的转换或解析方法进行了整理；

3. 对包括 NSBundle、NSFile、NSFileManger 等数据读取或操作的常用方法行了整理；

4. 对 UIFont、UIColor、UIImage、UIApplication、NSTimer 等也进行了分类整理，保证相关操作简洁高效，常用方法一键实现；

5. 对数据下载(DownLoadManager)、网络请求(BaseService)、GCD、Animation、UserAuth 等也行了简洁的封装。

这里对几个常用控件源代码进行简单的说明： 基于AF网络请求库的二次封装，根据状态码递归解析请求的加密数据；接口类型包括： 普通访问接口、带数据缓存接口、带有网络提示、带有上传文件等；

 #import <Foundation/Foundation.h>
/**
 *  HTTP访问回调
 *
 *  @param urlString 状态码 0 访问失败   200 正常  500 空 其他异常
 *  @param result    返回数据 nil 为空
 *  @param error     错误描述
 */
typedef void(^ResultBlock)(NSInteger stateCode, NSMutableArray* result, NSError *error);
//block不是self的属性或者变量时，在block内使用self也不会循环引用：

@interface BaseService : NSObject

/**
 *  普通的访问请求(有提示，带判断网络状态)
 *
 *  @param URLString    接口地址
 *  @param parameters   字典参数
 *  @param requestBlock 回调函数
 */
+ (void)POST:(NSString *)URLString  parameters:(id)parameters result:(ResultBlock)requestBlock;
/**
 *  普通的访问请求(无提示，不带判断网络状态)
 *
 *  @param URLString    接口地址
 *  @param parameters   字典参数
 *  @param requestBlock 回调函数
 */
+ (void)POSTWithNormal:(NSString *)URLString  parameters:(id)parameters result:(ResultBlock)requestBlock;

/**
 *  访问请求(有提示带缓存，带判断网络状态)
 *
 *  @param URLString    请求地址
 *  @param parameters   请求参数
 *  @param requestBlock 请求回调
 */
+ (void)POSTWithCache:(NSString *)URLString parameters:(id)parameters  completionBlock:(ResultBlock)requestBlock;

/**
 *  无提示的访问请求(带缓存，带判断网络状态)
 *
 *  @param URLString    请求地址
 *  @param parameters   请求参数
 *  @param requestBlock 请求回调
 */
+(void)POSTWithCacheNormal:(NSString *)URLString parameters:(id)parameters  completionBlock:(ResultBlock)requestBlock cacheBlock:(ResultBlock)cacheBlock;
/**
 *  上传多媒体文件接口
 *
 *  @param URLString    请求地址
 *  @param parameters   请求参数
 *  @param mediaDatas   多媒体数据  图片传 UIImage  语音传url字符串地址
 *  @param requestBlock 请求回调
 */
+(void)POSTWithFormDataURL:(NSString *)URLString parameters:(id)parameters mediaData:(NSMutableArray *)mediaDatas completionBlock:(ResultBlock)requestBlock;

同时对 UITableView 空白页文字、空白页图片、上拉下拉事件等进行了高度封装，命名为MACTableView，使用简单高效，一键集成:

typedef NS_ENUM(NSInteger, MACRefreshState) {

    /** 下拉刷新的状态 */
    MACRefreshing,
    /** pull刷新中的状态 */
    MACPulling,
};

@protocol MACTableViewDelegate <NSObject>

@optional

/**
 *  获取数据
 *
 *  @param state MACRefreshing为Refresh MACPulling 为 Pull
 */
-(void)loadDataRefreshOrPull:(MACRefreshState)state;

@end

@interface MACTableView : UITableView<DZNEmptyDataSetSource, DZNEmptyDataSetDelegate>
/**
 *  macTableView delegate
 */
@property (nonatomic,weak) id<MACTableViewDelegate> macTableViewDelegate;
/**
 *  是否支持下拉刷新 默认为YES
 */
@property (nonatomic,assign) BOOL isRefresh;
/**
 *  是否可以加载更多 默认为YES
 */
@property (nonatomic,assign) BOOL isLoadMore;
/**
 *  当前访问的page 下标
 */
@property (nonatomic,assign) NSInteger page;

/**
 *  是否展示空白页 默认为YES
 */
@property(nonatomic,assign)BOOL isShowEmpty;


/**
 *  空白页的标题 默认为 “" 为空不显示
 */
@property(nonatomic,copy) NSString *titleForEmpty;
/**
 *  空白页的副标题 默认为 “" 为空不显示
 */
@property(nonatomic,copy) NSString *descriptionForEmpty;
/**
 *  空白页展位图名称 默认为 “img_placehoder_icon" 为空或nil无图片
 */
@property(nonatomic,copy) NSString *imageNameForEmpty;

/**
 *  CellDataAdapter arr 暂未 用到
 */
@property(nonatomic,strong) NSMutableArray *cellDataArr;

/**
 *
 *  获取当下访问接口下标
 */
-(NSNumber *)getCurrentPage;
/**
 *  开始加载
 */
-(void)beginLoading;
/**
 *  结束刷新
 */
-(void)endLoading;
///**
// *  提示无更多数据
// */
//-(void)noMoreData;
@end

##首页

###仿闲鱼同城界面：

GCD、CollectionView、Xib 约束、Frame 约束、AutoLayout 代码约束简单应用，抛砖引玉；

###城市模糊查询：

定位 、 KMP & SearchTree 搜索实现快速数据检索 与 系统匹配不一样的感受；

##朋友圈

###仿QQ通信录：

高仿QQ聊天通讯录，人员分组：

高仿朋友圈 & QQ空间

我的消息

##云周边（暂未开放）

##发现（动画&控件）