移动端必懂基础

如果你已经能跑起 01MVP Web 模板，移动端要理解的第一件事很简单：App 就是另一个客户端。它复用同一个账号、同一个 API、同一套会员数据，只是跑在手机上而已。

你不用一开始就懂 React Native、原生开发、商店审核。先把下面这些基础概念搞清楚，再让 AI 帮你干活，效率高很多。

核心要点

App 不是新后端

移动端通过公开地址访问现有 Web/API 服务，不需要重新做一套 server。

真机比模拟器重要

上架是独立工作

App 能跑起来，只代表开发通过；商店截图、证书、审核和发布要单独准备。

先看准备清单

账号和设备清单放在移动应用入口页。读完那张表后，再回到这里理解 Expo、真机、登录、API、环境变量和上架流程。

一张图看懂移动端

手机 App

Expo / React Native

公开配置

EXPO_PUBLIC_SERVER_URL

01MVP API

Hono / oRPC / Auth

业务数据

用户 / 会员 / 订单

用户看到的是 App 界面，但 App 背后真正依赖的是 Web/API 服务。你在手机上点登录、查会员状态、拉用户资料，本质上都是 App 去访问后端接口。

你先理解这 6 件事

概念	新手理解方式	为什么重要
Expo	帮你做 iOS / Android App 的开发工具箱	不用一开始写原生 iOS 和 Android 代码
Expo Router	App 里的页面导航	让移动端像 Web 一样按页面组织
Expo Go	快速预览 App 的手机壳	适合早期看界面，不适合验证所有原生能力
Development Build	带自定义原生能力的开发版 App	需要相机、支付、推送、Widget 等能力时要用它
EAS Build	云端帮你打包 App	用来生成 iOS / Android 安装包和商店包
EXPO_PUBLIC_*	会进入 App 包的公开配置	只能放公开地址，不能放数据库密码、支付密钥、服务端密钥

Expo 官方也把 Development Build 作为开发自定义原生能力的推荐路径。你可以把它理解成”属于你自己的开发版 App”，比 Expo Go 更接近真实上架版。

Expo Go 和开发版 App 怎么选

适合先用 Expo Go

只想看页面布局
只调用普通 API
刚开始替换品牌和文案
还没有接支付、推送、Widget

应该切到 Development Build

要验证真实登录回跳
要接 RevenueCat 或原生支付
要用相机、麦克风、文件、推送
要准备商店截图和真机 QA

新手常见误区：看到 Expo Go 能打开页面，就以为 App 准备好上架了。并不是。上架前你至少要用 EAS 生成 preview 或 production 包，在真机上完整走一遍登录、会员、核心业务和异常网络场景。

移动端改造顺序

先改身份信息：App 名称、Bundle ID、Android package、scheme、图标和启动页。

再连后端：把 EXPO_PUBLIC_SERVER_URL 指向你的 Web/API 地址，跑一下 health、登录、profile 看能不能正常请求。

再做会员和支付：先在 Web 端确认会员权益模型，再让 App 只展示和读取结果。

最后处理上架：准备 Apple Developer、Google Play、EAS profile、截图、隐私说明和审核资料。

复制给 AI

当你准备把 01MVP mobile 模板改成自己的 App，直接把这段发给 AI：

请帮我把 01MVP mobile 模板改成我的 App。我的产品名称是「这里填名称」，核心功能是「这里填一句话」，目标平台是 iOS / Android。

请先检查 products/01mvp/apps/mobile 的当前结构，再按这个顺序执行：
1. 替换 App 名称、Bundle ID、Android package、scheme、图标和启动页说明。
2. 检查公开环境变量，只允许 EXPO_PUBLIC_* 进入移动端。
3. 连接现有 01MVP Web/API 服务，验证 health、登录、profile 和会员状态。
4. 保留模板基础能力，不要加入和我产品无关的复杂业务。
5. 更新 mobile 文档和验收清单。
6. 运行移动端可用的 lint、type-check、test 或构建检查，并汇报结果。

如果你的 App 需要相机、录音、推送、Widget、文件上传，把这些能力单独告诉 AI。别一次性要求它把所有原生能力都塞进模板。

常见坑

坑	正确做法
把服务端密钥写进 App	移动端只放公开配置，密钥留在 Web/API 后端
只在模拟器测试登录	登录、支付、深链要用真机测
一开始就做复杂原生功能	先跑通登录、API、会员状态，再加业务能力
App 和 Web 各做一套账号	复用同一个 Better Auth 后端和用户数据
忽略商店资料	上架需要截图、隐私政策、证书、审核说明和测试账号