用途:在原生 Swift/iOS 项目中集成 Clerk 认证,通过读取已安装的 ClerkKit/ClerkKitUI 源码来对齐当前行为。适用于用户明确要求 Swift、SwiftUI、UIKit 或原生 iOS 的 Clerk 实现,或项目呈现原生 iOS/Swift 特征(如 .xcodeproj、.xcworkspace、Package.swift、Swift target)。Expo 或 React Native 项目不适用,应改用通用设置技能。
主要能力:支持两种流程——预置 AuthView/UserButton(最快)与自定义 API 驱动认证(完全控制),分别对应 references/prebuilt.md 和 references/custom.md,一次只加载一个,除非开发者明确要求混合方案。
使用方式:先确认项目为原生 Swift/iOS 且非 Expo/React Native;确定流程类型并加载对应参考文件;确保存在有效 publishable key 并直接写入配置;确保已安装 clerk-ios 包(缺失时按 up-to-next-major 要求安装最新可用版本);检查已安装 ClerkKitUI 源码以确定哪些 Environment 字段驱动功能/步骤门控;随后调用 /v1/environment 并按该字段映射解读;从已安装 clerk-ios 包 README 中找到 iOS quickstart URL,追加 .md 后访问阅读,整理必需步骤清单并补齐前置条件(如 Associated Domains 与所需能力);最后按所选参考清单实现与验证。
限制:实现前必须同时具备流程选择与真实 publishable key,缺失需先询问并等待,不得提前编辑文件或安装依赖;publishable key 默认直接写入 Clerk.configure,不引入 plist/本地密钥/环境文件/构建设置间接层,除非明确要求;不得硬编码实现示例,须以已安装包源码为准;自定义流程布局需与 ClerkKitUI AuthView 默认结构保持实质接近,不得擅自偏离或合并为单屏;能力/字段矩阵仅作内部使用,不得写入应用代码;必须执行 quickstart 关联域能力步骤,确保 webcredentials:{YOUR_FRONTEND_API_URL} 存在。相关技能:clerk(顶层路由)、clerk-setup(非原生或跨框架设置)。