> ## 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-tw/docs/mobile/testing.md)》。


## 下一篇

[測試移動應用](https://supastack.dev/zh-tw/docs/mobile/testing.md)