SuperAPI AI 工具集

mobile-migrate

前端与建站

查看项目

更新于 10-16 03:41

技能介绍

用途:在已有 Web 项目中新增一个 Expo(React Native)移动应用,保持单一后端、单一认证系统,并共享逻辑与设计。产出结构为 apps/web 与 apps/mobile 共用 packages/shared,便于快速发布到 TestFlight 或内部测试轨道。

前提:需已有 monorepo 结构(否则先运行 /monorepo-scaffold)、Node.js 22+、使用 pnpm 作为工作区包管理器,并准备好 Apple Developer 与 Google Play Console 账号。

主要能力与流程:1) 检查 monorepo 结构;2) 在 apps/mobile/ 用 create-expo-app 脚手架创建 Expo 应用,推荐 Expo Router;3) 把类型、schema、工具与 API 客户端抽取到 packages/shared/;4) 用 NativeWind 与共享设计令牌统一设计语言;5) 生成镜像 Web 信息架构的初始屏幕;6) 集成 Clerk SDK for Expo 认证;7) 用 Convex React Native 客户端连接同一后端;8) 配置 EAS Build 的 dev/preview/production 构建配置;9) 生成商店素材与提交清单;10) 在模拟器验证并发布预览构建。

验证方式:依次检查工作区完整性、共享代码类型安全、Expo 配置与 expo doctor、运行时冒烟测试(iOS 模拟器、Android 模拟器、登录、读写后端、共享校验一致),以及 iOS/Android 的 EAS 预览构建。

可自动化:monorepo 与 Expo 脚手架、工作区依赖接线、共享包抽取、NativeWind 与设计令牌、EAS 配置与预览构建、路由/屏幕脚手架、基础认证与后端客户端接线。需人工:应用命名、bundle 标识、商店元数据、Apple/Google 账号与证书、最终 UX 与无障碍打磨、商店截图与隐私披露、提交与审核沟通。

常见陷阱:在非 monorepo 中加 Expo、复制逻辑而非抽取共享包、直接共享 UI 组件而非令牌与基础组件、Web 专用依赖泄漏进共享包、TypeScript 路径不一致、缺少认证/深链/安全存储的原生配置、把 EAS 配置当后置事项、过晚发现商店要求、仅用 Expo Go 测试。

完成标准:移动应用可在模拟器启动、使用同一认证、读写同一后端、与 Web 共享核心类型与校验,并能产出双平台预览 EAS 构建。