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

# 配置移动应用

设置原生构建使用的后端地址和深链接方案，并让交接两端保持同步。

## 安装与配置

把面向设备的值放在 `apps/mobile/.env.local`；Expo 读取该文件，而不是仓库根目录的 `.env`。`EXPO_PUBLIC_API_URL` 是手机可访问的 Web 后端源，应与你在手机浏览器中测试的值一致。`EXPO_PUBLIC_APP_SCHEME` 是应用的原生 URI 方案；使用反向 DNS 值，例如 `com.example.app`。

`app.json` 管理产品名称、slug、版本、包标识符和插件。`app.config.ts` 从 `EXPO_PUBLIC_APP_SCHEME` 派生深链接方案和生产源，因此更改方案需要重新构建原生应用，而不仅是重启 Metro。在服务器上，把应用将使用的每个源加入 `MOBILE_ALLOWED_ORIGINS`；两端不一致时，交接会安全失败。

每个 `EXPO_PUBLIC_*` 值都会打包进应用。把提供商密钥留在服务器上，公开值只用于地址和方案。

```
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app
```


## 实现流程

修改 `.env.local` 后重启 Expo。运行包测试和类型检查，然后用开发构建确认解析后的方案：打开认证回调链接，检查它返回应用而不是浏览器。Expo Go 无法验证原生构建的自定义方案。


## 验证与排障

修改 `.env.local` 后重启 Expo，并在目标设备上打开预览。更改主题、重启应用并确认选择保留；然后触发深链接，检查应用而不是浏览器负责路由。


如果你想继续完成设置，可以阅读《[测试移动应用](https://supastack.dev/zh/docs/mobile/testing.md)》。


## 下一篇

[测试移动应用](https://supastack.dev/zh/docs/mobile/testing.md)