1. 核心“契约”先行(决定并行开发效率) 不要等后端写完再联调,前端必须先动起来。 生成强类型API客户端:基于后端的 openapi.yaml,使用 OpenAPI Generator 直接生成 iOS(Swift) 和 Android(Kotlin) 的 API 请求层代码。这样接口请求对象直接固化,杜绝手写URL和解析JSON时因字段拼写错误导致的Bug。 搭建本地Mock BFF层:在原生工程里内置一个轻量级 Mock 拦截器。后端接口未完成时,返回符合契约的假数据(含边界情况如空列表、超时),保证UI渲染和交互逻辑先行跑通。 2. 双端基建与SDK版本“硬锁定”(避免集成灾难) 原生端涉及大量三方SDK,版本冲突是最大的坑,必须在上周锁死。 广告聚合SDK(GroMore):根据穿山甲官方最新适配表,锁定 Android(Gradle)和 iOS(CocoaPods/SPM)的具体版本号,并提前配置好 测试广告位ID(用于调试加载/展示/激励回调)。 即时通讯(OpenIM):提前集成 OpenIM 官方原生 SDK,并写好 “登录与连接分离” 的适配层(即先拿业务Token,再异步连接IM,且连接失败不能阻塞主界面)。 支付与提现:提前向微信/支付宝申请好 沙箱环境测试密钥,并配置好 iOS 的 URL Scheme 白名单和 Android 的 AppLinks 校验文件。 3. 播放器内核选型与预埋(短剧体验的生命线) 短剧App的核心是播放体验,不能等到开发时才选型。 选型确认:建议 iOS 使用 AVPlayer + 自定义缓存代理,Android 使用 ExoPlayer + 缓存扩展。需提前验证 “无缝切换清晰度” 和 “预加载下一集首帧” 的技术方案是否可行。 上报埋点:提前定义好播放心跳上报协议(包含 deviceId、drama_id、episode_id、current_time),确保后端多端同步进度时有数据源。 4. UI设计资产转换(原生开发最难标准化的一环) 设计Token提取:要求UI设计师产出 “Design Token”(颜色、字体、圆角、间距的规范变量),直接转换成 iOS 的 Asset Catalog 和 Android 的 values/themes.xml,禁止硬编码色值。 深色/浅色适配:明确是否支持深色模式,若支持,所有切图必须提供 Light 和 Dark 两套资源。 5. 构建系统与证书自动化(Gitea CI/CD 配前端的坑) 你的 Gitea CI/CD 目前可能只配了后端,前端需要补齐: 签名与证书:提前将 iOS 的 .p12 和 Provisioning Profile,以及 Android 的 .keystore 以 Base64 加密变量 的形式存入 Gitea Secrets,禁止明文放在工程里。 工程化脚本:准备 fastlane 或 Shell 脚本,让 CI 能自动完成 Pod install、Gradle assemble 以及版本号自增(如 1.0.0+${CI_PIPELINE_ID})。 6. 双端路由与导航骨架(先搭架子,后填功能) 统一路由表:不要等写业务时再跳转。提前定义好全量页面路由表(如 lemon://player?drama_id=123)。这对 AI 生成跳转代码 非常友好,直接生成标准 URI,避免硬编码 ViewController 或 Activity 类名。