(Swift)开屏引导

一) 使用场景

• 多用于用户首次安装，启动开屏引导；

• 效果如下；

  
  hnhch-byjbh.gif

二) 使用方法

• 3行代码即可引入使用；

let resourceArray = ["user_guide01", "user_guide02", "user_guide03", "user_guide04"]
let guideConfig = CCGuideConfig(resource: resourceArray)
window?.rootViewController = CCGuideViewController(config: guideConfig)

三) 源码分享

//
//  CCGuideViewController.swift
//  HelloSwift
//
//  Created by well on 2021/9/14.
//

struct CCGuideConfig {
    /// 资源名称
    fileprivate var resourceName: [String]
    /// 是否展示跳过按钮(默认展示)
    fileprivate var isSkip: Bool
    
    init(resource: [String], skip: Bool = true) {
        isSkip = skip
        resourceName = resource
    }
}

class CCGuideViewController: CCViewController, UIScrollViewDelegate {
    
    /// 引导视图配置参数
    private var guideConfig: CCGuideConfig
    /// 资源图片的个数
    private var displayCount: Int
    /// 引导圆点pageControl
    private var pageControl = UIPageControl()
    
    /// 懒加载skipButton
    private lazy var skipButton: UIButton = {
        let button = UIButton()
        button.layer.cornerRadius = 4
        button.setTitle("跳过", for: .normal)
        button.titleLabel?.font = RegularFont(16)
        button.setTitleColor(.white, for: .normal)
        button.backgroundColor = .hexColor("#000000", 0.8)
        button.addTarget(self, action: #selector(skipButtonDidSeleted), for: .touchUpInside)
        return button
    }()
    
    /// 懒加载startButton
    private lazy var startButton: UIButton = {
        let button = UIButton()
        button.layer.cornerRadius = 4
        button.setTitle("开始体验", for: .normal)
        button.titleLabel?.font = RegularFont(16)
        button.setTitleColor(.white, for: .normal)
        button.backgroundColor = .hexColor("#000000", 0.8)
        button.addTarget(self, action: #selector(startButtonDidSeleted), for: .touchUpInside)
        return button
    }()
    
    /// 设置状态栏为字体颜色为白色
    override var preferredStatusBarStyle: UIStatusBarStyle { .lightContent }
    
    required init?(coder: NSCoder) { fatalError("init(coder:) has not been implemented") }
    
    // MARK: - 反初始化器
    deinit { print("CCGuideViewController deinit~") }
    
    // MARK: - 初始化器
    init(config: CCGuideConfig) {
        guideConfig = config
        displayCount = config.resourceName.count
        super.init(nibName: nil, bundle: nil)
    }
    
    override func setUI() {
        // 非空校验
        guard !guideConfig.resourceName.isEmpty else {
            kAppDelegate().window?.rootViewController = CCTabBarController()
            return
        }
        
        func createImageView(imageName: String) -> UIImageView {
            let imgView = UIImageView()
            imgView.image = UIImage(named: imageName)
            imgView.layer.masksToBounds = true
            imgView.contentMode = .scaleAspectFill
            return imgView
        }
        
        let scrollView = UIScrollView()
        view.addSubview(scrollView)
        scrollView.delegate = self
        scrollView.isPagingEnabled = true
        scrollView.showsVerticalScrollIndicator = false
        scrollView.showsHorizontalScrollIndicator = false
        scrollView.contentInsetAdjustmentBehavior = .never
        scrollView.contentSize = CGSize(width: kScreenWidth().i * displayCount, height: 0)
        scrollView.frame = CGRect(x: 0, y: 0, width: kScreenWidth(), height: kScreenHeight())
        scrollView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }

        var viewArray = [UIImageView]()
        for name in guideConfig.resourceName {
           let imgView =  createImageView(imageName: name)
            viewArray.append(imgView)
        }
        
        let stackView = UIStackView(arrangedSubviews: viewArray)
        scrollView.addSubview(stackView)
        stackView.alignment = .fill
        stackView.axis = .horizontal
        stackView.distribution = .fillEqually
        stackView.frame = CGRect(x: 0, y: 0, width: kScreenWidth().i * displayCount, height: kScreenHeight().i)
        
        
        addPageControl()
        addStartButton()
        
        if guideConfig.isSkip { addSkipButton() }
        
    }
    
    /// 添加跳过按钮skipButton
    private func addSkipButton() {
        view.addSubview(skipButton)
        skipButton.frame = CGRect(x: kScreenWidth().i - 100, y: kSafeMarginTop(0).i, width: 70, height: 30)
    }
    
    /// 添加开始按钮startButton
    private func addStartButton() {
        view.addSubview(startButton)
        startButton.frame = CGRect(x: kScreenWidth().i / 2 - 50, y: kScreenHeight().i - kAdaptedHeight(100).i, width: 100, height: 36)
        dismissAnimation()
    }
    
    /// 添加显示圆点pageControl
    private func addPageControl() {
        view.addSubview(pageControl)
        pageControl.hidesForSinglePage = true
        pageControl.numberOfPages = displayCount
        pageControl.currentPageIndicatorTintColor = .random
        pageControl.frame = CGRect(x: 0, y: kScreenHeight().i - kAdaptedHeight(100).i, width: kScreenWidth().i, height: 30)
    }
    
    @objc func skipButtonDidSeleted() {
        setRootViewController()
    }
    
    @objc func startButtonDidSeleted() {
        setRootViewController()
    }
        
    func setRootViewController() {
        kAppDelegate().window?.rootViewController = CCTabBarController()
        CCCache.setString("yes", forKey: CCAppKeys.firstKey)
    }
    
    /// scrollView代理方法
    func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
        let currentIndex = Int(scrollView.contentOffset.x / kScreenWidth())
        guard currentIndex != pageControl.currentPage else { return }
        pageControl.currentPage = currentIndex
        (pageControl.currentPage == displayCount - 1) ? showAnimation() : dismissAnimation()
    }

    private func showAnimation() {
        pageControl.isHidden = true
        startButton.transform = CGAffineTransform(scaleX: 0, y: 0)
        UIView.animate(withDuration: 0.25) {
            self.startButton.transform = .identity
        }
    }
    
    private func dismissAnimation() {
        pageControl.isHidden = false
        UIView.animate(withDuration: 0.25) {
            self.startButton.transform = CGAffineTransform(scaleX: 0, y: 0)
        }
    }
}

四) 更多组件，传送门

GitHub