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/ship-in-5-minutes.md (or send Accept: text/markdown).

5 分钟启动移动应用

在手机或模拟器上打开 Expo 应用程序，配置设备可以访问的 API 地址，并将 UI 预览与真实登录和本机购买区分开来。

询问本指南

1.准备电脑、手机、后台

完成在您开始并在编辑器中打开移动存储库或所有平台 monorepo 之前完成。在存储库根目录的“终端”→“新终端”中，运行以下安装命令。等待它完成。使用下面链接的官方 Expo 页面在您的手机上安装 Expo Go；其版本必须支持apps/mobile/package.json.中记录的Expo SDK版本

后端是处理登录、工作区数据和 AI 请求的 Web 服务器。如果您的结帐包含 apps/web，请首先在另一个终端中运行 Web 安装程序并保持该服务器运行。在尝试本机注册或登录之前，请完成 Postgres 设置。仅限移动设备的结账不包含 apps/web：将其连接到您正在运行的单独提供的后端。启动 Expo 会启动屏幕预览服务器，而不是后端。

将手机和电脑置于同一个 Wi-Fi 下。如果 VPN 阻止本地连接，请暂时断开它。手机的 localhost 表示手机本身。将您计算机的专用网络地址用于物理手机或 Android 设备；同一台Mac上的iOS模拟器可以使用http://localhost:3000,，Android模拟器常用http://10.0.2.2:3000.

corepack pnpm install

2.查找并测试后端地址

在 Windows 上，在新的 PowerShell 终端中运行 ipconfig，找到活动的 Wi-Fi 适配器并读取 IPv4 地址。在 macOS 上，打开系统设置 → Wi-Fi → 详细信息 → TCP/IP 并读取 IP 地址。在 Linux 上打开网络设置并读取 IPv4 地址。地址可能类似于 192.168.1.25；你的通常会有所不同。

如果您的计算机地址为 192.168.1.25，请在 Web 服务器运行时在手机浏览器中打开 http://192.168.1.25:3000。替换您的实际地址。在继续之前必须加载主页。如果 Windows 防火墙要求，允许在专用网络上使用 Node 应用程序。如果无法加载，请检查地址、Wi-Fi、防火墙和正在运行的 Web 服务器； Expo 隧道仅承载预览包，不会使您单独的 API 可达。

# Windows PowerShell only:
ipconfig

3. 创建移动应用程序的配置文件

在编辑器的资源管理器中，展开 apps → mobile，创建一个名为 .env.local 的新文件，并将以下配置粘贴到该文件中。将 192.168.1.25 替换为您刚刚测试的地址，或者使用您提供的 HTTPS 后端地址。保存文件。其完整路径为apps/mobile/.env.local； Expo 不会自动读取 root .env。

首次预览时，请保持手机的购买设置处于关闭状态。 EXPO_PUBLIC_ 表示设置包含在手机应用程序中，因此这些值必须仅包含公共 URL、方案和公共客户端设置。请勿在此处粘贴 AI 提供商、数据库或计费机密。 Web服务器有自己的apps/web/.env.local；更改移动文件不会更改服务器。

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4.启动Expo并打开预览

从存储库根目录运行以下命令。等待二维码和地铁等待消息。保持该终端和后端终端打开。安卓端打开Expo Go并扫描二维码； iPhone上使用相机，扫码并在Expo Go中打开。二维码打开开发应用程序，而不是您的后端主页。

成功意味着应用程序的登录屏幕将在您的设备上打开。关闭购买后，这是 UI 预览；在测试登录、保存的工作区或聊天之前完成数据库支持的 Web 身份验证设置。如果已安装的模拟器是您的目标，请在 Expo 终端（适用于 Android）或 i（适用于 iOS）中按 a。 iOS 模拟器需要 macOS 和 Xcode；它不能在 Windows 上运行。

corepack pnpm --filter @supastack/mobile start

5. 从预览错误中恢复并测试实际流程

如果Expo Go报告不兼容的项目，请将其支持的SDK与apps/mobile/package.json进行比较，并使用官方Expo页面中的兼容版本。不要仅仅为了消除该消息而升级套件的依赖项版本。如果所需的本机模块不可用，请按照移动版本构建包含该模块的开发版本。

如果因网络错误导致登录失败，请先在手机浏览器中重试后端 URL。如果URL可以工作但登录失败，请检查后端终端并验证Postgres和迁移。本地/仪表板演示会话不会让您在电话上登录。如果配置看起来过时，请在 Expo 终端中按 Ctrl + C，然后运行下面的重新启动命令并重新打开预览。

Expo Go 无法证明真实的 StoreKit 或 Play Billing 购买/恢复行为。关注 EAS 开发构建和商店测试帐户的应用内购买和移动构建。首次本机构建和帐户注册可能需要超过五分钟的时间。要停止此预览，请在 Expo 终端中按 Ctrl + C；完成后单独停止后端。

corepack pnpm --filter @supastack/mobile start --clear