跳转到内容
supastack
浏览文档

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/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 文件中。

然后按顺序继续——连接项目,如果应用销售内容则设置购买,为设备构建,提交上架:

如果你想继续完成设置,可以阅读《设置 EAS》。

常见问题

14 个问题

supastack 是什么?

supastack 是用于构建 AI 驱动 SaaS 产品的模块化基础。它把通用基础设施整合在一起,让你专注于产品专属的功能。

它支持 Web 和移动端吗?

支持。supastack 包含 Next.js 与 Expo 应用,作为 Web 与移动端体验的起点。

包含哪些认证方式?

Better Auth 覆盖邮箱/密码、OTP 与社交登录。个人工作区随账户一起开通,产品记录从第一天起就有边界。

AI 是如何支持的?

supastack 包含可配置的多供应商 AI、用量追踪、预算,以及加密的自带密钥(BYOK)支持。

订阅如何处理?

对于基于该套件构建的产品,Stripe 计费、订阅与权限构成付费访问的基础。供应商密钥仅存于服务端。

我的产品专属代码放在哪里?

产品专属功能保留在独立的代码库中,产品通过配置接入 supastack 的基础模块。

supastack 如何定价?

套件为一次性购买、终身更新:单框架 249 美元(限时优惠价,较常规价 349 美元优惠 100 美元),或全框架(Next.js、iOS、Android)499 美元(限时优惠价,较常规价 599 美元优惠 100 美元),每个额外开发者席位 75 美元。套件本身没有订阅。本站结账后通过邮件发送许可证密钥,仓库访问通过 GitHub 邀请授予。

工作区如何界定我的数据?

用户记录按 workspaceId 划定边界。身份、权限、AI 用量、计费事件与审计条目都留在个人工作区边界内。

后台任务如何工作?

Trigger.dev 是明确的任务运行时。JobRunner 契约只承诺 enqueue、status 与 cancel——工作流语义保持 Trigger.dev 专有且显式。

邮件与营销触达有何不同?

事务性邮件覆盖产品工作流,如任务完成通知。冷触达与营销活动属于产品自身的范畴,不在本套件的邮件模块内。

移动端购买如何运作?

移动端已支持 RevenueCat 原生购买和恢复购买,访问权限由服务端验证。发布前需配置商店账户并完成设备测试。Web 计费保持独立。

AI 供应商密钥存放在哪里?

自带密钥凭证经过加密且仅存于服务端。密钥在日志中被脱敏;用量与预算在工作区级别保持可见。

结账支持哪些付款方式?

Stripe 托管结账接受银行卡,在 Stripe 账户启用后还可提供支付宝与微信支付——方便中国买家。钱包授权为异步确认,付款完成后许可证页面会立即更新。

我能申请退款吗?

获得代码仓库访问权限后,supastack 将永久归你所有,因此无法退款。但请放心,你将获得包含终身更新的完整源代码,可为你自己或客户构建并发布无限数量的产品。你只需注意不能转卖代码,也不能将仓库作为启动模板二次分发。

CN
主题