Sagit.Framework For IOS 开发框架入门开发教程2：一行代码实现引导页

前言：

开篇比较简单：Sagit.Framework For IOS 开发框架入门开发教程1：框架下载与环境配置

第二篇教程之前写了一半，感觉不太好写，而且内容单纯介绍API，要说的很多，又枯燥乏味。

所以那半篇文章就放下了。

后来又开始思考这教程该怎么写，经过几天的沉淀，终于有了一个决定：

这个教程，就用IT恋里的实例来和大伙分享了，看看在实战是怎么被应用的。

这篇文章分两部分，前面讲实战的应用，后面补充框架设计原理，及未来设想的扩展等。

Sagit 实现引导页功能：

1：首先，我们要有N张引导页的图片

IT恋里就放有3张了，如下（这里图片把翻页的效果直接带上了，我们就省点事了）：

2：然后，逻辑与代码：

逻辑流程：

AppDelegate启动时=》检测如果是第一次启动App=》WelcomeController（欢迎引导页）

if([ITGlobal share].IsFirstRun)
    {
        //欢迎界面
        self.window.rootViewController = [WelcomeController new];
    }
    else if (launchOptions) {}

滑动显示三张图片之后，最后一张触发点击事件，根据条件进入以下界面：

A：(更新App时)存在Token，跳转到：MainController（主界面）
 
B：(第一次时）无Token时，跳转到：StartController（登陆注册引导界面）

然后就是核心的一行代码实现功能了，一切都来的这么简单轻松：

[[self.view addScrollView:nil direction:X imgName:@"welcome_1", @"welcome_2", @"welcome_3", nil].lastSubView click:name];

追加一张效果图：

Sagit 框架原理解说：

1：Controller加载View的原理：

在往上看的第一张图中，注意细节：

A：可以看到引导欢迎界面，只有一个WelcomeController，木有WelcomeView。
 
B：而引导注册界面，有和StartController对应的StartView。

这个功能是我这两天增加的，主要是考虑到当View里的代码极少时，节省文件的同时，也更简洁。

所以，目前Controller检测加载View的流程是：

@implementation STController
 
- (void)viewDidLoad {
    [super viewDidLoad];//获取当前的类名
    NSString* className= NSStringFromClass([self class]);
    NSString* viewClassName=[className replace:@"Controller" with:@"View"];
    Class viewClass=NSClassFromString(viewClassName);
    if(viewClass!=nil)//view
    {
        self.view=self.stView=[[viewClass alloc] initWithController:self];
        [self.stView initView];
    }
    else
    {
        self.view=[[STView alloc] initWithController:self];//将view换成STView
        [self initUI];
    }
}
//空方法（保留给子类复盖）
-(void)initUI{}

代码读下来是这样的：

1: 如果XXXController检测到存在XXXView，则进行加载，并调用其initView方法（里面会再调用initUI方法）
 
--所以框架的默认加载的约定的是XXX名字前缀一样，就会被加载。
 
2: 如果检测不存在，则调用自身的initUI方法（这就是这里单独一个WelcomeController存在的原因）。

2：UIView的AddUI相关的方法。

框架扩展了UIView，增了常用了组件方法，并对这些组件，进行了些特殊的处理：

-(void)addView:(UIView *)view name:(NSString*)name;
-(UIView*)addUIView:(NSString*)name;
-(UIButton*)addSwitch:(NSString*)name;
-(UIButton *)addStepper:(NSString *)name;
-(UIButton *)addSlider:(NSString *)name;
-(UIButton *)addProgress:(NSString *)name;
 
-(UILabel*)addLabel:(NSString*)name;
-(UILabel*)addLabel:(NSString*)name text:(NSString*)text;
-(UILabel*)addLabel:(NSString*)name text:(NSString*)text font:(NSInteger)px;
-(UIImageView*)addImageView:(NSString*)name;
-(UIImageView*)addImageView:(NSString*)name imgName:(NSString*)imgName;
-(UIImageView*)addImageView:(NSString*)name imgName:(NSString*)imgName xyFlag:(XYFlag)xyFlag;
 
-(UITextField*)addTextField:(NSString*)name;
-(UITextField*)addTextField:(NSString*)name placeholder:(NSString*)placeholder;
-(UITextView*)addTextView:(NSString*)name;
 
-(UIButton*)addButton:(NSString*)name;
-(UIButton*)addButton:(NSString*)name imgName:(NSString*)imgName;
-(UIButton*)addButton:(NSString*)name imgName:(NSString*)imgName buttonType:(UIButtonType)buttonType;
-(UIButton*)addButton:(NSString*)name title:(NSString*)title;
-(UIButton*)addButton:(NSString*)name title:(NSString*)title font:(NSInteger)px;
-(UIButton*)addButton:(NSString*)name title:(NSString*)title font:(NSInteger)px buttonType:(UIButtonType)buttonType;
-(UIButton*)addButton:(NSString*)name title:(NSString*)title font:(NSInteger)px imgName:(NSString*)imgName buttonType:(UIButtonType)buttonType;
-(UIView*)addLine:name color:(id)colorOrHex;
-(UIScrollView*)addScrollView:(NSString*)name;
-(UIScrollView *)addScrollView:(NSString*)name direction:(XYFlag)direction imgName:(NSString*)imgName,...NS_REQUIRES_NIL_TERMINATION;

有些组件目前还没涉及，后续根据项目情况可能会追加或进一步优化。

这里先讲一下addScrollView的基础用法：

-(UIScrollView *)addScrollView:(NSString*)name direction:(XYFlag)direction imgName:(NSString*)imgName,...NS_REQUIRES_NIL_TERMINATION;

核心讲解：

：每个UI都有个name属性，这个name很核心，可以关联事件，用于寻找UI，也用于对UI取值赋值，如果实在没用到，可以赋nil。
 
：XYFlag 指求滑动是左右的X，还是上下的Y。
 
：可以指定一个可追加的图片名称，用于加载图片（内部加载时，会自动根据数据调整ScrollView和图片的宽高等属性）。
 
：对于一个add的UIView，没指定xy宽高时，会自动继承上一个相对视图的frame属性，这里是继承父视图，全屏了。

3：事件的触发

AddScrollView只是追加了图片，并可以滑动，但我们需要对最后一张图片增加点击事件：

所以需要先拿到最后一张图片，框架对UIView扩展了四个属性：

-(UIView*)lastSubView;
-(UIView*)firstSubView;
-(UIView*)preView;
-(UIView*)nextView;

用于方便拿到子视图的第一个和最后一个，以及自己同级的上一个和下一个。

接着，是对这个UIView，追加点击事件。

框架对于UIView扩展了两种点击事件的绑定方式：

#pragma mark 扩展系统事件
-(UIView*)click:(NSString*)event;
- (UIView*)addClick:(onClick)block;

click用于指定一个事件的名称，addClick用于追加一个事件执行的代码块。

这里先讲click传的event名字的寻找事件的流程：

：先找传进来的event在所在的Controller中是否有对应的事件，若有，执行，若没有继续以下：
 
：对event追加后缀变成eventClick和eventClick:再看有没有对应的事件，若有，执行，若没有继续以下：
 
：对event追加后缀变成EventController，看有没有对应的控制器，若有，执行默认的open:事件跳转，若没有，则无绑定事件。

OK，原理讲解到这里，大伙再重温一下这行代码：

[[self.view addScrollView:nil direction:X imgName:@"welcome_1", @"welcome_2", @"welcome_3", nil].lastSubView click:name];

总结：

这些天一直在改进框架，相信随着框架的不断完善，可以让大伙编写IOS代码时，变的轻松很多！！！

下一篇，我们以跳转到登陆注册引导页为示例，继续下一篇教程。

最后，谢谢大伙对Sagit框架和本人IT连创业项目的关注！