📦 Auth0 Expo — Auth0 是一种身份验证平台，Expo 是一个用于构建跨平台应用程序的框架。Auth0 与 Expo 集成，可以为 Expo 应用程序提供安全的身份验证和授权功能。Auth0 为 Expo 提供了一个简单的 API 集成，允许开发者轻松地将身份验证功能添加到他们的 Expo 应用程序中。

Auth0 Expo 集成 使用 react-native-auth0 和 Expo Config Plugin 为 Expo（React Native）应用添加身份验证。

代理指令：在提供 SDK 设置说明之前，通过运行以下命令获取最新的发布版本： gh api repos/auth0/react-native-auth0/releases/latest --jq '.tag_name' 在所有依赖项行中使用返回的版本，而不是任何硬编码版本。如果命令失败，请回退到检查 https://github.com/auth0/react-native-auth0/releases。

前提条件 Expo SDK 53 或更高（react-native-auth0 v5.x 需要 Expo 53+） React 19 和 React Native 0.78.0 或更高 Node.js 20+（用于 bootstrap 脚本自动化） 具有本机应用配置的 Auth0 账户 如果尚未设置 Auth0，请先使用 auth0-quickstart 技能 不兼容 Expo Go — 需要自定义开发客户端或 EAS Build

何时不使用 用例 推荐技能 Bare React Native CLI 项目（无 Expo） auth0-react-native React web SPA（Vite/CRA） auth0-react Next.js 应用 auth0-nextjs Vue.js SPA auth0-vue Angular SPA auth0-angular Express.js 后端 auth0-express 本机 Android（Kotlin/Java） auth0-android 后端 API（JWT 验证） auth0-fastify-api 或 auth0-express

快速入门工作流 代理指令：首先检查用户的提示是否已包含 Auth0 客户端 ID 和域。如果两个都提供，则跳过设置选择问题并直接转到步骤 2（验证 Expo Dev 客户端）并使用这些值。如果任一值缺失，则使用 AskUserQuestion 提问： “您想如何为此 Expo 项目配置 Auth0？” 自动设置（推荐）— 运行一个 bootstrap 脚本，创建 Auth0 应用、数据库连接、回调 URL 并将插件配置写入 app.json 手动设置 — 用户提供其 Auth0 客户端 ID 和域

根据用户的选择，遵循以下相应部分。

• 配置 Auth0 自动设置

代理指令：在运行 bootstrap 脚本之前执行这些快速检查。不要从代理运行 auth0 login — 它是交互式的，会挂起。 检查 Node.js：node --version。如果缺失或低于 20，请询问用户：安装（brew install node）或切换到手动设置。 检查 Auth0 CLI：command -v auth0。如果缺失，请询问用户：安装（brew install auth0/auth0-cli/auth0）或切换到手动设置。 检查 Auth0 登录：auth0 tenants list --csv --no-input 2>&1。如果失败或返回空：告诉用户：“请在您的终端运行 auth0 login 并让我知道何时完成。”等待用户确认，然后重新运行检查以验证。 确认活动租户：解析 CSV 输出的第一行以识别活动租户域。告诉用户：“您的活动 Auth0 租户是：<域>。这是正确的租户吗？”如果是，则继续。如果不是，请询问用户在其终端运行 auth0 tenants use <租户域>，然后重新运行步骤 3 以确认新的活动租户。 一旦确认，请运行 bootstrap 脚本： cd /auth0-expo/scripts npm install node bootstrap.mjs 脚本验证 Expo 项目，创建本机 Auth0 应用，设置数据库连接，并将插件配置写入 app.json。代理不应手动处理 client_id 或 domain。如果脚本由于会话过期而失败，请询问用户重新运行 auth0 login，然后重新运行脚本。对于其他失败，请回退到以下手动设置。 脚本完成后，转到步骤 2（验证 Expo Dev 客户端）。

手动设置（用户提供的凭据） 代理指令：询问用户提供其 Auth0 凭据，使用 AskUserQuestion： “我需要您的 Auth0 凭据来设置身份验证。请提供： Auth0 域（例如 your-tenant.us.auth0.com） 客户端 ID（32 个字符的字母数字字符串） 您可以在 Auth0 仪表板的应用程序 > 应用程序 >您的应用 > 设置下找到这两个值。如果您尚未创建 Auth0 应用，请创建一个类型为本机的应用，并从设置页面复制域和客户端 ID。” 然后将配置写入 app.json 并转到步骤 2。

• 验证 Expo Dev 客户端

代理指令：在安装 Auth0 SDK 之前，检查项目是否已安装 expo-dev-client。 读取项目的 package.json 并在依赖项或 devDependencies 中查找 expo-dev-client。 如果找到 expo-dev-client： 继续到步骤 3。 如果未找到 expo-dev-client： 使用 AskUserQuestion 提问： “react-native-auth0 SDK 需要自定义 Expo 开发客户端 —— 它不适用于 Expo Go。您的项目尚未安装 expo-dev-client。您想如何继续？ 为我安装 —— 我将运行 npx expo install expo-dev-client 并继续设置 我将自己设置 —— 跳过此步骤并继续到 Auth0 SDK 安装” 如果用户选择选项 1，请运行： npx expo install expo-dev-client 然后继续到步骤 3。 如果选项 2，请直接继续到步骤 3。

• 安装 SDK

npx expo install react-native-auth0

• 配置 Expo Config Plugin

添加 react-