引导页是App必不可少的功能之一；本Demo用简单有效的代码，封装引导页，仅需3行代码搞定，同时支持GIF图片.
GuideView.h
引导页GuideView : UIViewController,在.h文件中，暴露接口，支持自定义设置
@interface GuideView : UIViewController
/**
引导页图片数组（gif图 需要添加后缀名：icon.gif）
*/
@property (nonatomic,strong)NSArray *imageArray;
/**
跳过按钮是否显示(默认为NO)
*/
@property (nonatomic,assign)BOOL cancelButtonShow;
/**
分页控件是否显示(默认为NO)
*/
@property (nonatomic,assign)BOOL pageControlShow;
/**
未选中圆点颜色
*/
@property (nonatomic,strong)UIColor *pageIndicatorColor;
/**
选中圆点颜色
*/
@property (nonatomic,strong)UIColor *currentPageIndicatorColor;
/**
设置引导页图片
@param imageArray 引导页数组
@param rootController 根控制器
*/
- (void)showGuideViewWithImageArray:(NSArray *)imageArray WindowRootController:(UIViewController *)rootController;
@end
GuideView.m
利用SDWebImage加载GIF，导入#import "UIImage+GIF.h"，
坑点：sd_animatedGIFNamed 不能带.gif 后缀否则只能加载第一张; 使用GCD倒计时，解决滑动时，倒计时不准确问题
#import "GuideView.h"
#import "UIImage+GIF.h"
#define K_Screen_width [UIScreen mainScreen].bounds.size.width
#define K_Screen_height [UIScreen mainScreen].bounds.size.height
@interface GuideView ()<UIScrollViewDelegate>
/**
滚动视图
*/
@property (nonatomic,strong)UIScrollView *imageScrollView;
/**
圆点
*/
@property (nonatomic,strong) UIPageControl *pageControl;
/**
跳过按钮
*/
@property (nonatomic,strong)UIButton *cancelButton;
/**
跟控制器
*/
@property (nonatomic,strong)UIViewController *rootController;
@end
@implementation GuideView
- (void)viewDidLoad {
[super viewDidLoad];
[self createScrollView];
[self createPageControl];
[self createCancelButton];
}
- (void)createScrollView
{
_imageScrollView = [[UIScrollView alloc]initWithFrame:self.view.bounds];
_imageScrollView.delegate = self;
_imageScrollView.bounces = YES;
_imageScrollView.pagingEnabled = YES;
_imageScrollView.showsVerticalScrollIndicator = NO;
_imageScrollView.showsHorizontalScrollIndicator = NO;
_imageScrollView.backgroundColor = [UIColor whiteColor];
_imageScrollView.contentSize = CGSizeMake(K_Screen_width *self.imageArray.count, K_Screen_height);
[self.view addSubview:_imageScrollView];
for (int i = 0; i < self.imageArray.count; i++) {
NSString *imageName = self.imageArray[i];
UIImageView *imageView = [[UIImageView alloc]init];
imageView.userInteractionEnabled = YES;
imageView.backgroundColor = [UIColor purpleColor];
imageView.frame = CGRectMake(K_Screen_width * i, 0, K_Screen_width, K_Screen_height);
[_imageScrollView addSubview:imageView];
// 判断是否为gif
if ( [imageName.pathExtension.lowercaseString isEqualToString:@"gif"]) {
// sd_animatedGIFNamed 不能带.gif 后缀否则只能加载第一张
// 过滤掉 .gif
NSString *tureName = [imageName substringToIndex:imageName.length - 4];
imageView.image = [UIImage sd_animatedGIFNamed:tureName];
}else{
imageView.image = [UIImage imageNamed:imageName];
}
}
}
- (void)createPageControl
{
_pageControl = [[UIPageControl alloc]initWithFrame:CGRectMake(0, K_Screen_height - 80, K_Screen_width, 30)];
_pageControl.hidden = _pageControlShow;
_pageControl.pageIndicatorTintColor = _pageIndicatorColor;
_pageControl.currentPageIndicatorTintColor = _currentPageIndicatorColor;
_pageControl.numberOfPages = self.imageArray.count;
[self.view addSubview:_pageControl];
}
- (void)createCancelButton
{
_cancelButton = [UIButton buttonWithType:UIButtonTypeCustom];
_cancelButton.layer.cornerRadius = 2;
_cancelButton.hidden = _cancelButtonShow;
_cancelButton.titleLabel.font = [UIFont systemFontOfSize:15];
_cancelButton.backgroundColor = [[UIColor whiteColor] colorWithAlphaComponent:0.5];
_cancelButton.frame = CGRectMake(K_Screen_width - 70, 20, 60, 20);
[_cancelButton setTitle:@"跳过" forState:UIControlStateNormal];
[_cancelButton addTarget:self action:@selector(cancelButtonAction:) forControlEvents:UIControlEventTouchUpInside];
[self.view addSubview:_cancelButton];
}
// 倒计时
- (void)startTimer
{
__block NSInteger second = 10;
//全局队列 默认优先级
dispatch_queue_t quene = dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0);
//定时器模式 事件源
dispatch_source_t timer = dispatch_source_create(DISPATCH_SOURCE_TYPE_TIMER, 0, 0, quene);
//NSEC_PER_SEC是秒，＊1是每秒
dispatch_source_set_timer(timer, dispatch_walltime(NULL, 0), NSEC_PER_SEC * 1, 0);
//设置响应dispatch源事件的block，在dispatch源指定的队列上运行
dispatch_source_set_event_handler(timer, ^{
//回调主线程，在主线程中操作UI
dispatch_async(dispatch_get_main_queue(), ^{
if (second >= 0) {
[_cancelButton setTitle:[NSString stringWithFormat:@"%lds跳过",second] forState:UIControlStateNormal];
second--;
}
else
{
//这句话必须写否则会出问题
dispatch_source_cancel(timer);
[_cancelButton setTitle:@"跳过" forState:UIControlStateNormal];
self.view.window.rootViewController = _rootController;
}
});
});
//启动源
dispatch_resume(timer);
}
- (void)setImageArray:(NSArray *)imageArray
{
_imageArray = imageArray;
}
- (void)setCancelButtonShow:(BOOL)cancelButtonShow
{
_cancelButtonShow = cancelButtonShow;
if (_cancelButtonShow){
// 加载完毕开始倒计时
[self startTimer];
}
}
- (void)scrollViewDidScroll:(UIScrollView *)scrollView{
// pageControl 与 scrollView 联动
CGFloat offsetWidth = scrollView.contentOffset.x;
int pageNum = offsetWidth / [[UIScreen mainScreen] bounds].size.width;
self.pageControl.currentPage = pageNum;
if (scrollView.contentOffset.x >= scrollView.contentSize.width - K_Screen_width + 40) {
self.view.window.rootViewController = _rootController;
}
}
- (void)showGuideViewWithImageArray:(NSArray *)imageArray WindowRootController:(UIViewController *)rootController
{
_imageArray = imageArray;
_rootController = rootController;
}
- (void)cancelButtonAction:(UIButton *)sender
{
self.view.window.rootViewController = _rootController;
}
@end
使用(重点来了)
判断是否是第一次进入，如果是第一次 就就如引导页，不是就设置正常的根控制器(怎么判断是否第一次进入app 就不多说了)
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
self.window = [[UIWindow alloc]initWithFrame:[UIScreen mainScreen].bounds];
self.window.backgroundColor = [UIColor whiteColor];
[self.window makeKeyAndVisible];
// if 条件 是 判断是否是第一次进入，如果是第一次 就就如引导页，不是就设置正常的根控制器
if (YES) {
GuideView *vc = [[GuideView alloc]init];
[vc showGuideViewWithImageArray:@[@"10.gif",@"1.png",@"2.png",@"3.png"] WindowRootController:[ViewController new]];
self.window.rootViewController = vc;
}else{
/**-------------------你工程的根控制器--------------**/
}
return YES;
}
Demo.gif
