Unified 快速开始

连接一个兼容 Web 宿主与一个客户端,无需维护十五组重复教程。

请先完成宿主核心闭环,再添加支付、上传或推送。真机联调应使用独立数据库和 HTTPS Staging URL。

1. 选择并配置宿主

按照 Next.js Unified Host 配置数据库、Better Auth URL 与 Secret、可信原生 Origin 和 App API。
按照 Nuxt Unified Host 配置数据库、Better Auth URL 与 Secret、可信原生 Origin 和 App API。
按照 TanStack Unified Host 配置数据库、Better Auth URL 与 Secret、可信原生 Origin 和 App API。

执行宿主 Schema migration,在 Web 注册,并验证 /api/auth/get-session 后再继续。

2. 选择并配置客户端

选择 soar_api,设置宿主 Base URL 与原生 Origin,并将 Bearer Token 保存在 Keychain。按照 Swift Soar API Setup 配置。
选择 soarApi,设置宿主 Base URL 与 Origin,并使用 Keystore Session 存储。按照 Kotlin Soar API Setup 配置。
在 iOS/Android 构建中选择 soarApi 并配置 SecureStore。Expo Web 不支持 Unified。按照 Expo Soar API Setup 配置。
选择 soarApi,配置主进程 API Origin 与加密 Session 存储。按照 Electron Soar API Setup 配置。
选择 soarApi,配置 Rust API Origin 与私有 Keyring Session 存储。按照 Tauri Soar API Setup 配置。

配置错误必须让当前构建明确失败,不得初始化另一个 Backend 作为回退。

3. 验证共享产品闭环

  • 在客户端注册或登录,然后在 Web 打开同一账户。
  • 在一端更新 Profile,并从另一端读取。
  • 跨端创建、编辑、排序和删除 Todo。
  • 上传允许的文件,并确认完成后的 URL 可读。
  • 从另一设备撤销客户端 Session,确认客户端返回登录页。
  • 配置购买 Provider,确认两端读取同一个权益快照。
  • 注册设备 Token,并只在兼容矩阵标记支持的平台测试推送。

如需具体示例,请使用 Next.js + Swift Unified Setup

本页目录