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

# 移動端概覽

一個連線到同一服務端基礎的 Expo 端。

## 您的第一次移動會話

從計算機上按照下面的移動教程進行操作，附近有手機或已安裝的模擬器。您將安裝該專案，在 apps/mobile/.env.local 中寫入公共 API 地址並掃描 Expo 二維碼。 Expo 是在裝置上開啟 React Native 螢幕的開發工具。

Next.js API 和共享伺服器包仍然是帳戶、資料和許可權的來源：這是與手機通訊的正在執行的 Web 後端。 Expo的二維碼伺服器僅傳遞螢幕程式碼。預覽成功並不意味著後端、登入或商店購買都已配置；本教程展示瞭如何按順序測試每個邊界。

[完整的手機首次執行教程](https://supastack.dev/zh-tw/docs/mobile/ship-in-5-minutes.md)

[安裝工具並獲取程式碼](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)


## 共享契約，保留原生呈現

Expo 包括本機登入和會話處理、工作區和設定介面、聊天控制元件以及 RevenueCat 購買工作流程。 Next.js API 和共享伺服器包仍然是共享資料、授權和提供商驗證的來源；本機螢幕呼叫它們而不是嵌入伺服器憑據。

Expo 應用程式位於 apps/mobile. 中，它通過 API 使用共享基礎，而不是嵌入伺服器憑據。本機身份驗證、安全會話儲存、深層連結、聊天控制和 RevenueCat 購買演示均具有客戶端模組。


## 配置 API 與應用 scheme

把 EXPO_PUBLIC_API_URL 設為模擬器或真機可達的 API origin。手機上的 localhost 指的是手機本身，所以要用可達的開發主機地址。EXPO_PUBLIC_APP_SCHEME 標識應用的 deep-link scheme。

測試回撥之前，先看 apps/mobile/app.config.ts 與認證配置。公開的 Expo 值會被打包進客戶端，絕不能包含供應商金鑰。


## 在目標裝置上驗證

首先執行確定性會話儲存、深層連結、聊天取消和權利測試。然後在預期的 EAS 開發版本中驗證登入返回、會話恢復、登出和購買同步； Expo Go 無法驗證真實商店購買情況。

真機與供應商驗收獨立於 Web 本地黃金路徑。為每個釋出目標顯式跟蹤它們。


如果你想繼續完成設定，可以閱讀《[執行移動應用](https://supastack.dev/zh-tw/docs/mobile/local-setup.md)》。


## 下一篇

[5 分鐘啟動移動應用](https://supastack.dev/zh-tw/docs/mobile/ship-in-5-minutes.md)