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.md (or send Accept: text/markdown).
移動端概覽
一個連線到同一服務端基礎的 Expo 端。
您的第一次移動會話
從計算機上按照下面的移動教程進行操作，附近有手機或已安裝的模擬器。您將安裝該專案，在 apps/mobile/.env.local 中寫入公共 API 地址並掃描 Expo 二維碼。 Expo 是在裝置上開啟 React Native 螢幕的開發工具。
Next.js API 和共享伺服器包仍然是帳戶、資料和許可權的來源：這是與手機通訊的正在執行的 Web 後端。 Expo的二維碼伺服器僅傳遞螢幕程式碼。預覽成功並不意味著後端、登入或商店購買都已配置；本教程展示瞭如何按順序測試每個邊界。
共享契約，保留原生呈現
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 本地黃金路徑。為每個釋出目標顯式跟蹤它們。
如果你想繼續完成設定，可以閱讀《執行移動應用》。