iOS中的优雅引导教程：Material Showcase

束恺俭Jessie

于 2024-10-10 07:16:08 发布

阅读量566

点赞数 21

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00148/article/details/142802341

iOS中的优雅引导教程：Material Showcase

material-showcase-ios ✨ An elegant way to guide your beloved users in iOS apps - Material Showcase. 项目地址: https://gitcode.com/gh_mirrors/ma/material-showcase-ios

项目介绍

Material Showcase for iOS 是一个基于Material Design指南设计的轻盈且美观的点击展示视图库，专为iOS应用程序而生。它提供了一种优雅的方式来指导用户了解您的应用特性。本项目兼容iOS 10.0及以上版本，并使用Swift 4.2或更高版本进行构建。

GitHub仓库

项目快速启动

安装方式

使用CocoaPods

将以下行添加到您的Podfile中，然后运行pod install：

pod 'MaterialShowcase'

使用Carthage

首先通过Homebrew安装Carthage（如果尚未安装）:

$ brew update
$ brew install carthage

接着，在Cartfile中加入：

github "aromajoin/material-showcase-ios" ~> 0.8.0

执行carthage update后，将生成的MaterialShowcase.framework拖入Xcode项目中。

Swift Package Manager

在Xcode里选择“File” > “Swift Packages” > “Add Package Dependency”，输入仓库URL：https://github.com/aromajoin/material-showcase-ios

基础使用示例

在一个适合的生命周期方法中，如viewWillAppear: 或 viewDidAppear:，展示引导提示：

import MaterialShowcase

let showcase = MaterialShowcase()
showcase.setTargetView(view: button)
showcase.primaryText = "行动按钮"
showcase.secondaryText = "点击以查看详情"
showcase.show(completion: {
    // 可在此处保存展示状态，以便后续判断是否再次显示。
})

应用案例与最佳实践

当集成至Objective-C项目时，请参考官方文档完成配置。对于Swift项目，确保在目标视图正确布局后再调用展示方法，以避免因视图未就绪导致的问题。

支持多种目标视图类型，如UIView, UIBarButtonItem, UITabBarItem以及特定索引的UITableViewCell。此外，通过设置代理来处理展示与消失时的行为，增强用户体验。

extension YourViewController: MaterialShowcaseDelegate {
    func showcaseWillDismiss(_ showcase: MaterialShowcase, didTapTarget: Bool) {
        print("即将消失: \(showcase.primaryText)")
    }
    
    func showcaseDidDismiss(_ showcase: MaterialShowcase, didTapTarget: Bool) {
        print("已经消失: \(showcase.primaryText)")
    }
}