SuperAPI AI 工具集

tipkit

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

TipKit 用于小范围、情境化的功能发现场景:内联提示、气泡提示、规则门控的教学内容与轻量引导标记。通用 SwiftUI 导航、布局和首次启动长流程引导不属于本技能范围。

用途与主要能力:定义符合 Tip 协议的类型,通过 title、message、image 配置提示内容;使用 @Parameter 表达持久化用户状态,使用 Event 追踪用户交互,并通过 #Rule 对参数或事件捐款次数进行规则门控;支持内联 TipView 与锚定控件的 popoverTip 两种呈现方式;用户完成所教动作后用 invalidate(reason: .actionPerformed) 使提示失效。iOS 18+ 支持 TipGroup,通过 @State 存储以有序协调多个提示,避免界面杂乱;也支持 .cloudKitContainer 跨设备同步提示状态。

使用方式:在应用启动时于 init() 或 application(_:didFinishLaunchingWithOptions:) 中调用一次 try Tips.configure([...]),可配置 .datastoreLocation 与 .displayFrequency;共享提示状态可使用 .groupContainer(identifier:)。iOS 18+ API(TipGroup、.cloudKitContainer、MaxDisplayDuration)和 iOS 26+ API(resetEligibility())需显式做可用性检查。测试覆盖仅在调试构建中、调用 Tips.configure() 之前使用,可用 Tips.resetDatastore()、Tips.showAllTipsForTesting() 及启动参数 -com.apple.TipKit.ResetDatastore 1、-com.apple.TipKit.ShowAllTips 1。

限制与常见错误:提示是可关闭的教育性提示,不应用于错误或破坏性警告等关键信息;不要在视图的 onAppear 中配置 TipKit,以免与布局竞争并抛出数据存储错误;测试覆盖不可带入生产;动态提示需提供稳定 id 以便正确追踪持久化与失效状态。参考资料涵盖规则、事件与放置、自定义样式与分组测试、动作与 CloudKit 同步等主题。本资料未提供收费、价格或平台信息,相关内容暂未提供。