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/local-setup.md (or send Accept: text/markdown).

執行移動應用

把 Expo 連到可達的開發 API。

詢問本指南

1.準備電腦、手機、後臺

完成在您開始並在編輯器中開啟移動儲存庫或所有平臺 monorepo 之前完成。在儲存庫根目錄的“終端”→“新終端”中，執行以下安裝命令。等待它完成。使用下面連結的官方 Expo 頁面在您的手機上安裝 Expo Go；其版本必須支援apps/mobile/package.json.中記錄的Expo SDK版本

後端是處理登入、工作區資料和 AI 請求的 Web 伺服器。如果您的結帳包含 apps/web，請首先在另一個終端中執行 Web 安裝程式並保持該伺服器執行。在嘗試本機註冊或登入之前，請完成 Postgres 設定。僅限移動裝置的結賬不包含 apps/web：將其連線到您正在執行的單獨提供的後端。啟動 Expo 會啟動螢幕預覽伺服器，而不是後端。

將手機和電腦置於同一個 Wi-Fi 下。如果 VPN 阻止本地連線，請暫時斷開它。手機的 localhost 表示手機本身。將您計算機的專用網路地址用於物理手機或 Android 裝置；同一臺Mac上的iOS模擬器可以使用http://localhost:3000,，Android模擬器常用http://10.0.2.2:3000.

corepack pnpm install

2.查詢並測試後端地址

在 Windows 上，在新的 PowerShell 終端中執行 ipconfig，找到活動的 Wi-Fi 介面卡並讀取 IPv4 地址。在 macOS 上，開啟系統設定 → Wi-Fi → 詳細資訊 → TCP/IP 並讀取 IP 地址。在 Linux 上開啟網路設定並讀取 IPv4 地址。地址可能類似於 192.168.1.25；你的通常會有所不同。

如果您的計算機地址為 192.168.1.25，請在 Web 伺服器執行時在手機瀏覽器中開啟 http://192.168.1.25:3000。替換您的實際地址。在繼續之前必須載入主頁。如果 Windows 防火牆要求，允許在專用網路上使用 Node 應用程式。如果無法載入，請檢查地址、Wi-Fi、防火牆和正在執行的 Web 伺服器； Expo 隧道僅承載預覽包，不會使您單獨的 API 可達。

# Windows PowerShell only:
ipconfig

3. 建立移動應用程式的配置檔案

在編輯器的資源管理器中，展開 apps → mobile，建立一個名為 .env.local 的新檔案，並將以下配置貼上到該檔案中。將 192.168.1.25 替換為您剛剛測試的地址，或者使用您提供的 HTTPS 後端地址。儲存檔案。其完整路徑為apps/mobile/.env.local； Expo 不會自動讀取 root .env。

首次預覽時，請保持手機的購買設定處於關閉狀態。 EXPO_PUBLIC_ 表示設定包含在手機應用程式中，因此這些值必須僅包含公共 URL、方案和公共客戶端設定。請勿在此處貼上 AI 提供商、資料庫或計費機密。 Web伺服器有自己的apps/web/.env.local；更改移動檔案不會更改伺服器。

EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off

4.啟動Expo並開啟預覽

從儲存庫根目錄執行以下命令。等待二維碼和地鐵等待訊息。保持該終端和後端終端開啟。安卓端開啟Expo Go並掃描二維碼； iPhone上使用相機，掃碼並在Expo Go中開啟。二維碼開啟開發應用程式，而不是您的後端主頁。

成功意味著應用程式的登入螢幕將在您的裝置上開啟。關閉購買後，這是 UI 預覽；在測試登入、儲存的工作區或聊天之前完成資料庫支援的 Web 身份驗證設定。如果已安裝的模擬器是您的目標，請在 Expo 終端（適用於 Android）或 i（適用於 iOS）中按 a。 iOS 模擬器需要 macOS 和 Xcode；它不能在 Windows 上執行。

corepack pnpm --filter @supastack/mobile start

5. 從預覽錯誤中恢復並測試實際流程

如果Expo Go報告不相容的專案，請將其支援的SDK與apps/mobile/package.json進行比較，並使用官方Expo頁面中的相容版本。不要僅僅為了消除該訊息而升級套件的依賴項版本。如果所需的本機模組不可用，請按照移動版本構建包含該模組的開發版本。

如果因網路錯誤導致登入失敗，請先在手機瀏覽器中重試後端 URL。如果URL可以工作但登入失敗，請檢查後端終端並驗證Postgres和遷移。本地/儀錶板演示會話不會讓您在電話上登入。如果配置看起來過時，請在 Expo 終端中按 Ctrl + C，然後執行下面的重新啟動命令並重新開啟預覽。

Expo Go 無法證明真實的 StoreKit 或 Play Billing 購買/恢復行為。關注 EAS 開發構建和商店測試帳戶的應用內購買和移動構建。首次本機構建和帳戶註冊可能需要超過五分鐘的時間。要停止此預覽，請在 Expo 終端中按 Ctrl + C；完成後單獨停止後端。

corepack pnpm --filter @supastack/mobile start --clear