For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile.md (or send Accept: text/markdown).
移动端概览
一个连接到同一服务端基础的 Expo 端。
您的第一次移动会话
从计算机上按照下面的移动教程进行操作，附近有手机或已安装的模拟器。您将安装该项目，在 apps/mobile/.env.local 中写入公共 API 地址并扫描 Expo 二维码。 Expo 是在设备上打开 React Native 屏幕的开发工具。
Next.js API 和共享服务器包仍然是帐户、数据和权限的来源：这是与手机通信的正在运行的 Web 后端。 Expo的二维码服务器仅传递屏幕代码。预览成功并不意味着后端、登录或商店购买都已配置；本教程展示了如何按顺序测试每个边界。
共享契约，保留原生呈现
Expo 包括本机登录和会话处理、工作区和设置界面、聊天控件以及 RevenueCat 购买工作流程。 Next.js API 和共享服务器包仍然是共享数据、授权和提供商验证的来源；本机屏幕调用它们而不是嵌入服务器凭据。
Expo 应用程序位于 apps/mobile. 中，它通过 API 使用共享基础，而不是嵌入服务器凭据。本机身份验证、安全会话存储、深层链接、聊天控制和 RevenueCat 购买演示均具有客户端模块。
配置 API 与应用 scheme
把 EXPO_PUBLIC_API_URL 设为模拟器或真机可达的 API origin。手机上的 localhost 指的是手机本身，所以要用可达的开发主机地址。EXPO_PUBLIC_APP_SCHEME 标识应用的 deep-link scheme。
测试回调之前，先看 apps/mobile/app.config.ts 与认证配置。公开的 Expo 值会被打包进客户端，绝不能包含供应商密钥。
在目标设备上验证
首先运行确定性会话存储、深层链接、聊天取消和权利测试。然后在预期的 EAS 开发版本中验证登录返回、会话恢复、注销和购买同步； Expo Go 无法验证真实商店购买情况。
真机与供应商验收独立于 Web 本地黄金路径。为每个发布目标显式跟踪它们。
如果你想继续完成设置，可以阅读《运行移动应用》。