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-tw/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，並在目標裝置上開啟預覽。更改主題、重啟應用並確認選擇保留；然後觸發深連結，檢查應用而不是瀏覽器負責路由。
如果你想繼續完成設定，可以閱讀《測試移動應用》。