跳轉到內容
supastack
瀏覽檔案
WebNext.js

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

建立移動端賬戶

Expo、Apple、Google Play 和 RevenueCat 賬戶——各自用途以及何時建立。

詢問本指南
開啟方式

什麼時候需要它們

日常移動端開發一個都不需要:Expo Go 加上執行中的後端——apps/mobile/.env.local 裡的 EXPO_PUBLIC_API_URL——就能覆蓋介面預覽和登入測試。

當你走出 Expo Go 時再建立這些賬戶:Expo 賬戶驅動 EAS 雲端構建,商店賬戶用於提交上架,RevenueCat 驗證原生內購,而 Apple 開發者計劃在商店稽核時也是 Sign in with Apple 的必需條件。其中兩個要花錢:Apple Developer 每年 99 美元,Google Play 一次性註冊費 25 美元;Expo 和 RevenueCat 都有免費層。

Expo + EAS

1. 開啟 expo.dev → Sign up,建立賬戶並確認郵箱。

2. 在終端執行 npx eas-cli@latest login 並輸入相同憑據——eas 是 Expo Application Services 構建與提交的命令列工具。

3. 在 apps/mobile 目錄下執行 npx eas-cli@latest init,把程式碼庫關聯到 EAS 專案;它會把專案 ID 寫入 app.json/app.config.ts 配置。eas.json 構建配置已隨套件附帶。

預期結果:npx eas-cli@latest whoami 列印你的賬戶名,專案出現在 expo.dev 儀錶板中。

npx eas-cli@latest login
cd apps/mobile
npx eas-cli@latest init
npx eas-cli@latest whoami

Apple Developer Program

1. 開啟 developer.apple.com → Account → 註冊 Apple Developer Program——每年 99 美元;個人會員即可。

2. 註冊需要啟用雙重認證的 Apple ID,以及與你付款方式一致的法定姓名;審批可能需要一兩天。

3. 這一個賬戶覆蓋兩項要求:把 iOS 應用提交到 App Store,以及 Sign in with Apple——只要 iOS 應用提供 Google 或 GitHub 等第三方社交登入,App Review 就要求同時提供 Sign in with Apple。套件通過 AUTH_APPLE_ENABLED 加上後端的 APPLE_CLIENT_ID/APPLE_CLIENT_SECRET 憑據對來接入它。

同一個會員資格也覆蓋 macOS 桌面簽名——桌面賬戶指南會講那一側。

Google Play Console

1. 開啟 play.google.com/console,支付一次性 25 美元註冊費,以你的名義或公司名義建立開發者賬戶。

2. 暫時停在開發者賬戶這一步——應用條目本身在提交時才在 Play Console 內建立:新應用的首次上傳始終在那裡手動完成,eas submit 從第二個版本開始接手。

RevenueCat——僅當應用銷售內容時

如果移動應用不銷售數字內容或訂閱,可以完全跳過本節。如果銷售:1. 開啟 revenuecat.com 建立免費賬戶,2. 建立專案,3. 在專案中註冊 iOS 應用(連線 App Store Connect)和 Android 應用(Play 包名加服務憑據)。

4. 建立與商店商品對應的產品和一個 entitlement(權益)——套件在發放訪問許可權前會在服務端檢查配置的權益(REVENUECAT_ENTITLEMENT_ID、REVENUECAT_ENTITLEMENT_KEY)。

5. 把各平臺的公開 SDK 金鑰複製到 apps/mobile/.env.local,並按下面所示在兩側啟用服務商。SDK 金鑰是公開的客戶端值;REVENUECAT_SECRET_API_KEY 和 REVENUECAT_WEBHOOK_AUTHORIZATION 僅限服務端,屬於後端環境——絕不能放進 EXPO_PUBLIC_ 變數。

# apps/mobile/.env.local
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=revenuecat
EXPO_PUBLIC_REVENUECAT_IOS_API_KEY=your-public-ios-sdk-key
EXPO_PUBLIC_REVENUECAT_ANDROID_API_KEY=your-public-android-sdk-key

# apps/web/.env.local — server side
MOBILE_PURCHASES_PROVIDER=revenuecat
REVENUECAT_SECRET_API_KEY=your-secret-api-key
REVENUECAT_WEBHOOK_AUTHORIZATION=your-webhook-auth-value

移動端的登入服務商

移動端登入複用你為 Web 建立的同一批 Google 和 GitHub OAuth 應用——回撥保持 {APP_URL}/api/auth/callback/<provider>,因為 Better Auth 處理服務端,而應用通過其 EXPO_PUBLIC_APP_SCHEME 深鏈 scheme 返回。僅僅因為客戶端是原生的,並不需要額外的服務商應用。

例外是 iOS 商店稽核:在 iOS 上提供 Google 或 GitHub 按鈕,必須同時提供 Sign in with Apple,所以上面的 Apple Developer 賬戶同時也是登入的依賴項。

完成的標誌

繼續之前檢查每個賬戶:npx eas-cli@latest whoami 列印你的 Expo 賬戶且專案出現在儀錶板中;Apple Developer 會員顯示 Active;Play Console 賬戶已存在;RevenueCat 專案列出兩個商店應用及其產品和權益,金鑰也在正確的 env 檔案中。

然後按順序繼續——連線專案,如果應用銷售內容則設定購買,為裝置構建,提交上架:

常見問題

14 個問題

supastack 是什麼?

supastack 是用於構建 AI 驅動 SaaS 產品的模組化基礎。它把通用基礎設施整合在一起,讓你專注於產品專屬的功能。

它支援 Web 和移動端嗎?

支援。supastack 包含 Next.js 與 Expo 應用,作為 Web 與移動端體驗的起點。

包含哪些認證方式?

Better Auth 覆蓋郵箱/密碼、OTP 與社交登入。個人工作區隨賬戶一起開通,產品記錄從第一天起就有邊界。

AI 是如何支援的?

supastack 包含可配置的多供應商 AI、用量追蹤、預算,以及加密的自帶金鑰(BYOK)支援。

訂閱如何處理?

對於基於該套件構建的產品,Stripe 計費、訂閱與許可權構成付費訪問的基礎。供應商金鑰僅存於服務端。

我的產品專屬程式碼放在哪裡?

產品專屬功能保留在獨立的程式碼庫中,產品通過配置接入 supastack 的基礎模組。

supastack 如何定價?

套件為一次性購買、終身更新:單棧 249 美元(Next.js(Web)、Expo(iOS 與 Android)、Tauri(macOS 與 Windows 桌面)倉庫任選其一),雙棧 398 美元(任選兩個倉庫),或完整套裝 399 美元(全部三個倉庫與完整 monorepo),每個額外開發者席位 75 美元。套件本身沒有訂閱。本站結賬後通過郵件傳送許可證金鑰,倉庫訪問通過 GitHub 邀請授予。

工作區如何界定我的資料?

使用者記錄按 workspaceId 劃定邊界。身份、許可權、AI 用量、計費事件與審計條目都留在個人工作區邊界內。

後臺任務如何工作?

Trigger.dev 是明確的任務執行時。JobRunner 契約只承諾 enqueue、status 與 cancel——工作流語義保持 Trigger.dev 專有且顯式。

郵件與營銷觸達有何不同?

事務性郵件覆蓋產品工作流,如任務完成通知。冷觸達與營銷活動屬於產品自身的範疇,不在本套件的郵件模組內。

移動端購買如何運作?

移動端已支援 RevenueCat 原生購買和恢復購買,訪問許可權由服務端驗證。釋出前需配置商店賬戶並完成裝置測試。Web 計費保持獨立。

AI 供應商金鑰存放在哪裡?

自帶金鑰憑證經過加密且僅存於服務端。金鑰在日誌中被脫敏;用量與預算在工作區級別保持可見。

結賬支援哪些付款方式?

Stripe 託管結賬接受銀行卡,在 Stripe 賬戶啟用後還可提供支付寶與微信支付——方便中國買家。錢包授權為非同步確認,付款完成後許可證頁面會立即更新。

我能申請退款嗎?

獲得程式碼倉庫訪問許可權後,supastack 將永久歸你所有,因此無法退款。但請放心,你將獲得包含終身更新的完整原始碼,可為你自己或客戶構建併發布無限數量的產品。你只需注意不能轉賣程式碼,也不能將倉庫作為啟動模板二次分發。唯一的例外是上線返現——上線一款用 supastack 打造的真實產品並公開分享,在購買後 60 天內達到 5,000 次自然瀏覽或 50 個自然按讚,即可退還已付款項的 50%;詳見條款。

TW
主題