用途:在原生 Android 项目(Kotlin、Jetpack Compose)中按 clerk-android SDK 与官方文档实现 Clerk 认证。仅适用于原生 Android;若项目为 Expo 或 React Native,则不应使用本技能,应转到通用 setup 技能。
主要能力:区分两种实现路径。预构建流程使用 AuthView / UserButton,参考 references/prebuilt.md,依赖 clerk-android-ui(含 API)。自定义流程参考 references/custom.md,依赖 clerk-android-api,需保留多步认证与分因子处理,UI、状态编排与 Clerk API 集成相互分离,不应混用两份参考。
使用方式:先确认项目为原生 Android 而非 Expo/React Native;确定流程类型;确保提供真实 Clerk publishable key;安装对应 artifact;阅读官方 Android quickstart 并核对 Native API 已启用、最小 SDK 与 Java 目标、manifest 网络权限、应用级初始化;检查 clerk-android 源码与示例;最后按所选参考清单实现与验证。默认将 key 直接写入 Clerk.initialize(...)。
限制与要求:在流程类型和 publishable key 未提供前,必须向用户询问并暂停,不得编辑文件或安装依赖。需以 Clerk.isInitialized 判断认证就绪后再渲染认证 UI。行为应依据运行时能力字段(如已启用因子、社交提供方、MFA 标志)进行门控,不要硬编码认证因子。实现应依据所安装 SDK 版本的源码与文档,官方 quickstart 前置条件必须满足。
参考:https://github.com/clerk/clerk-android 与 https://clerk.com/docs/android/getting-started/quickstart