用途:把现有 Auth0.Android v3 集成迁移到 v4。技能会检测当前版本、校验目标版本、检查平台与构建工具前置条件,并只对项目实际调用的 API 做改动。
主要能力:支持传入目标版本参数(如 /auth0-android-major-migration 4.0.0),无参数时自动解析最新 v4.x 发布版(含预发布);迁移前创建安全分支并确认当前版本可构建;通过读取源码审计项目实际使用的 Auth0 API,跳过未使用的部分;覆盖 PasskeyAuthProvider 移除、Management API(UsersAPIClient)移除、已弃用 MFA 方法迁移到 MfaApiClient、WebAuthProvider.useDPoP 移至登录构建器、DPoPException.UNSUPPORTED_ERROR 移除、SSOCredentials.expiresIn 改名 expiresAt、SecureCredentialsManager 构造器移除、minTtl 默认值变化、clearCredentials 行为变化、Storage 新增 removeAll() 等破坏性变更。
使用方式:需已有 v3 集成、Android SDK/Gradle 工具链、项目可正常构建且处于 git 干净工作区。按步骤执行:备份与预检、检测并解析目标版本、前置条件门禁(v4 要求 minSdk 26、Java 17、Gradle 8.11.1+、AGP 8.10.1+、Kotlin 2.0.21)、拉取并阅读 v4 SDK 源码、审计项目 API 使用、更新依赖、应用破坏性变更、构建验证。
限制:不适用于全新集成、小版本升级、iOS/macOS、React Native/Expo 或 Flutter 项目;minSdk 低于 26 为硬性阻塞;Management API 调用需改为后端实现,技能仅添加 TODO 并提示;预发布版本需精确固定,不能用动态版本范围。