> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 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.

[安装工具并获取代码](https://supastack.dev/zh/docs/web/before-you-start.md)

[了解如何运行命令和编辑文件](https://supastack.dev/zh/docs/web/terminal-basics.md)

[启动Web后端](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)

[安装与您的项目兼容的Expo Go版本](https://expo.dev/go)

```
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；完成后单独停止后端。

[设置并测试本机登录](https://supastack.dev/zh/docs/mobile/authentication.md)

[创建本机开发版本](https://supastack.dev/zh/docs/mobile/builds.md)

[配置本机购买和恢复](https://supastack.dev/zh/docs/mobile/revenuecat.md)

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


## 下一篇

[运行移动应用](https://supastack.dev/zh/docs/mobile/local-setup.md)