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/configuration.md (or send Accept: text/markdown).
配置移动应用
设置原生构建使用的后端地址和深链接方案，并让交接两端保持同步。
安装与配置
把面向设备的值放在 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，并在目标设备上打开预览。更改主题、重启应用并确认选择保留；然后触发深链接，检查应用而不是浏览器负责路由。
如果你想继续完成设置，可以阅读《测试移动应用》。