1 小时搭出 iOS App MVP 雏形

📚 独立 App 出海指南 · 第 3 篇 / 共 7 篇 系列总览：App 出海指南

MVP 不是粗糙版大产品，而是只验证一个核心假设的小产品。

这一小时你不会写完整版本，但陌生用户能在 30 秒内完成一次核心动作，并且你能从数据里看到他们在哪里流失。

🎯 你将完成

一个 TestFlight 能发的 v1 App（功能极简但完整）
核心路径：从开屏 → onboarding → 核心动作 → 付费墙
关键事件埋点：6 个必装事件
一个可以发给前 50 个用户的真实包

⏱️ 时间分配

0–10min

脚手架：SwiftUI 项目 + 依赖

10–25min

核心动作：5 个屏幕跑通主路径

25–40min

Onboarding + 付费墙

40–50min

装 RevenueCat + PostHog 埋点

50–60min

TestFlight 提交

📋 前置要求

Xcode 16+，免费 Apple Developer 账号已注册
上一篇 App 细分定位的产出：≤ 5 个核心功能 + 一句定位
RevenueCat 免费账号 + PostHog 免费账号

第 1 步：脚手架（0–10 分钟）

新建项目

File → New Project → iOS → App
Interface: SwiftUI
Language: Swift
Storage: 暂时选 None（用 UserDefaults 就够）

加依赖

File → Add Package Dependencies：

https://github.com/RevenueCat/purchases-ios
https://github.com/PostHog/posthog-ios

只装这两个。不要装 Firebase / Mixpanel / Amplitude——多了拖编译。

项目结构

YourApp/
  App.swift           // @main + 注册 RC/PH
  ContentView.swift   // 主路由
  Onboarding/         // 4 步引导
  Core/               // 核心动作页面
  Paywall/            // 付费墙
  Analytics.swift     // 埋点封装

第 2 步：核心动作（10–25 分钟）

心法：用户打开后 30 秒内能完成一次关键任务。其他全砍。

5 个屏幕

最多就这 5 个屏幕：

开屏 / Onboarding 起点
核心动作输入（最关键的那一个交互）
结果页（用户看到价值的那一刻）
付费墙（出现在用户感受到价值之后）
设置 / 历史（最小可有）

SwiftUI 基础骨架

struct ContentView: View {
    @AppStorage("hasOnboarded") var hasOnboarded = false

    var body: some View {
        if !hasOnboarded {
            OnboardingFlow()
        } else {
            MainTabView()
        }
    }
}

不要做的事

❌ 用户账号系统（v1 用 Apple ID / 设备本地存就够）
❌ 后端 API（v1 全本地，能不依赖网络就不依赖）
❌ 多语言（先做你的主市场的语言，后面再加）
❌ iPad 自适应布局（除非你的核心场景就是 iPad）

第 3 步：Onboarding + 付费墙（25–40 分钟）

4–5 步 Onboarding

不是产品说明书，是承接广告承诺 → 触发付费的漏斗：

欢迎页：复述广告里的核心承诺（"Never get sunburned again"）
痛点共鸣：3 句话说"你是不是也…"，让用户自己点头
核心收益展示：一张 GIF 或 3 步插画，展示 App 怎么解决
权限请求（如需要）：通知 / 位置 / 相机，配合 "we'll only…" 解释
付费墙：紧接着出现，因为情绪刚被铺垫好

付费墙模板

┌─────────────────────────────┐
│ [一句价值主张]               │
│ Unlock streak tracking.     │
│ Miss a day = back to zero.  │
│                             │
│ ✓ 无限连续记录              │
│ ✓ 历史导出                  │
│ ✓ Widget                    │
│                             │
│ [ Yearly  $29.99/yr ]       │
│ [ Monthly $4.99/mo ]        │
│                             │
│ Start 7-day free trial      │
│                             │
│ Restore  |  Terms  |  Privacy│
└─────────────────────────────┘

关键点：

价格清楚、试用期清楚、试用结束怎么扣费清楚
不能用假倒计时、假"限时优惠"逼订阅
Restore Purchase 必须有，不然审核打回
关闭按钮要让用户能跳过

第 4 步：装 RevenueCat + PostHog（40–50 分钟）

RevenueCat（5 分钟）

在 app.revenuecat.com 建 project，拿 API key，在 App.swift：

import RevenueCat

@main
struct YourApp: App {
    init() {
        Purchases.configure(withAPIKey: "appl_xxxxxx")
    }
    var body: some Scene { ... }
}

App Store Connect 那边在产品 → 内购里建好订阅产品（年订 + 月订），sandbox 测试账号也建好。

PostHog（5 分钟）

import PostHog

let config = PostHogConfig(apiKey: "phc_xxx", host: "https://us.i.posthog.com")
PostHogSDK.shared.setup(config)

6 个必装事件

事件名	触发时机
`app_opened`	App 启动
`onboarding_completed`	走完 onboarding
`core_action_done`	用户完成一次核心动作
`paywall_shown`	付费墙出现
`trial_started`	点了试用
`purchase_completed`	真正付款成功

封装到 Analytics.swift：

enum Event: String {
    case appOpened = "app_opened"
    case onboardingCompleted = "onboarding_completed"
    case coreActionDone = "core_action_done"
    case paywallShown = "paywall_shown"
    case trialStarted = "trial_started"
    case purchaseCompleted = "purchase_completed"
}

func track(_ event: Event, properties: [String: Any]? = nil) {
    PostHogSDK.shared.capture(event.rawValue, properties: properties)
}

埋点原则：先全埋上，后面看哪个有用。漏埋 > 错埋。