SuperAPI AI 工具集

tipkit

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:在 iOS 17+ 应用中实现与审查 TipKit 功能发现 UI,面向小规模、上下文相关的功能教学时刻,如内联提示、弹出提示、规则门控教育和轻量教练标记。通用 SwiftUI 架构、导航、布局及长流程首次引导不在本技能范围。

主要能力:覆盖可用性说明、Tips.configure 配置、提示设计、Tip 定义、呈现方式、规则与事件、选项与失效、操作与样式、TipGroup 分组、测试及常见错误清单。核心 API 在 iOS/iPadOS/macOS 14+/tvOS/watchOS 10+/visionOS 1+ 可用;TipGroup、CloudKit 同步、MaxDisplayDuration 为 iOS 18+,resetEligibility() 为 iOS 26+。

使用方式:在应用初始化时调用一次 Tips.configure(:),不要放在视图 onAppear 或 .task 中。用 TipView 呈现内联提示,用 .popoverTip 指向控件;用 @Parameter 与 Tips.Event 构建规则,规则之间为 AND 关系。用户完成被教学操作后调用 invalidate(reason:),失效为永久,除非重置数据存储或在 iOS 26+ 调用 resetEligibility()。测试覆盖需在 Tips.configure(:) 之前应用,且仅限 DEBUG/测试代码。

限制:不应用于关键安全或错误信息,也不适合长解释或多屏引导;测试覆盖不得进入生产;可复用提示的 id 必须稳定,否则会出现重复或过时教育;事件默认只查询最近 1000 次捐赠,捐赠负载应保持小。配置选项在应用组内需保持一致。

资料还提供 references/tipkit-patterns.md 及 Apple 文档、HIG、WWDC 视频等参考链接。