SuperAPI AI 工具集

axiom-deep-link-debugging

测试与质量

查看项目

更新于 10-16 00:22

技能介绍

用途:为仅调试构建添加深链接(debug deep link),使开发者、Claude Code 或自动化测试无需手动点击即可导航到指定界面或特定状态,便于截图与验证。

主要能力:通过 debug:// URL scheme 路由界面(如 debug://settings、debug://profile?id=123、debug://reset);与 NavigationStack 的 NavigationPath 集成,实现多级导航(如先到 recipe 再到 recipeEdit);支持状态配置链接(如 login-error、recipe-empty、recipe-error)以及参数化测试场景(user、recipes、network 等组合);可由 xcrun simctl openurl 调用,并能与 /axiom:screenshot 命令及 simulator-tester 智能体配合完成截图自动化。

使用方式:在 SwiftUI App 的 onOpenURL 中处理 debug URL;将处理代码包裹在 #if DEBUG 中;在 Info.plist 注册 URL scheme,并通过运行脚本或独立 plist 在 Release 构建中移除;使用如下命令导航与截图:xcrun simctl openurl booted "debug://settings",随后执行 /axiom:screenshot 或 xcrun simctl io booted screenshot 文件名。

适用场景:模拟器测试、自动化测试导航、截图验证、错误与空状态复现、减少手动点击带来的迭代耗时。

限制与注意事项:不用于生产深链接、Universal Links 或 App Clips,也不用于复杂路由架构;所有调试代码需 #if DEBUG 包裹并从发布构建剥离 URL scheme;参数需校验,避免强制解包;应复用现有导航系统而非重复实现。需先在模拟器手动验证各链接,并在 README 或注释中记录。