iOS 的修炼之道

┌────────────────────────────────────┐
│ Cocoa Touch：UIKit/SwiftUI 框架     │ ← 开发者在这（≈ Android 框架层）
├────────────────────────────────────┤
│ 媒体层：Core Animation/Graphics     │ ← 流畅动画
├────────────────────────────────────┤
│ 系统服务：Core Foundation/文件/安全  │
├────────────────────────────────────┤
│ Darwin（XNU 内核）                 │ ← BSD Unix 血统（≈ Linux 内核）
└────────────────────────────────────┘

【沙箱（比 Android 更严）】
  每个 App 独立目录（Documents/Library/tmp）
  只能访问自己沙箱 + 用户授权的资源（相册/定位）
  后台能力受限（后台任务有时间限制）

【App 状态机（iOS 13+ Scene 版）】
  NotRunning（没启动）
  → Inactive（前台但无交互：来电/通知）
  → Active（前台可交互）
  → Background（后台：保留内存但受限）
  → Suspended（挂起：内存还在，随时可能被清）
  → 系统内存紧张 → 杀 Suspended 进程（和 Android 同款命运！）

【对比 Android（第十七本）】
  iOS：沙箱更严 + 单渠道（App Store）+ 不开源
  Android：沙箱 + 多渠道 + 开源
  → 开发逻辑相通，生态规则不同（第10站）

【开发硬性前提】
  必须 Mac 电脑 + Xcode！(Windows 装虚拟机也不行——苹果强制)
  iPhone 真机调试 + 开发者账号（$99/年）

// 可选类型：空安全（Kotlin 同款）
var name: String? = nil
let display = name ?? "匿名用户"       // Elvis 运算符（?: 的 Swift 版）
print(display)

// struct：值类型 + 方法（比 Kotlin data class 更常用）
struct User {
    var id: Int
    var name: String
    var phone: String?
}

// 协议 + 扩展：接口 + 默认实现
protocol Payable { func pay(amount: Double) }
extension Payable {
    func pay(amount: Double) { print("支付 \(amount) 元") }  // 默认实现
}
struct Card: Payable {}               // 零代码继承默认实现

// 闭包：函数式（map/filter/reduce）
let adults = users
    .filter { $0.age >= 18 }
    .map { $0.name }
    .sorted()

// async/await（第6站主角）
func loadData() async throws -> [Order] {
    let (data, _) = try await URLSession.shared.data(from: url)
    return try JSONDecoder().decode([Order].self, from: data)
}

【Swift vs Kotlin（表兄弟对照）】
  可选类型  String?      ≈  Kotlin String?
  结构体    struct       ≈  data class（但 Swift 更常用）
  协议      protocol     ≈  interface + 扩展函数
  闭包      { $0.x }     ≈  lambda { it.x }
  async/await            ≈  suspend/协程
  → 会 Kotlin 的人，Swift 两天上手！

【Playground 练手】
  Xcode 里的「游乐场」——边写边看结果（类似 Jupyter）

import SwiftUI

struct OrderListView: View {
    @StateObject private var vm = OrderViewModel()   // 状态（≈ ViewModel）

    var body: some View {
        NavigationStack {
            List(vm.orders) { order in                // 列表（≈ LazyColumn）
                HStack {
                    VStack(alignment: .leading) {
                        Text(order.title).font(.headline)
                        Text("¥\(order.amount)").foregroundStyle(.blue)
                    }
                    Spacer()
                    Image(systemName: "checkmark.circle")
                }
            }
            .navigationTitle("我的账单")
            .toolbar {
                Button("刷新") { vm.refresh() }       // 命令绑定
            }
        }
    }
}

// 状态驱动：点一下，界面自动更新（≈ mutableStateOf）
struct CounterView: View {
    @State private var count = 0
    var body: some View {
        Button("点击了 \(count) 次") { count += 1 }
    }
}

【SwiftUI vs Compose（完全对照）】
  @State / @StateObject  ≈  mutableStateOf / ViewModel
  List / HStack/VStack   ≈  LazyColumn / Row / Column
  NavigationStack        ≈  NavHost
  .foregroundStyle(.blue)≈  Modifier.color(Blue)
  body: some View        ≈  @Composable fun
  → 声明式 UI 的哲学完全一致！

【UIKit 老项目要点（维护会碰到）】
  Storyboard（可视化布局）/ Auto Layout（约束）
  UITableView / UIViewController
  → 新代码用 SwiftUI，老项目 UIKit——两边都要能读

// Scene 生命周期监听（@Environment scenePhase）
struct ContentView: View {
    @Environment(\.scenePhase) private var scenePhase

    var body: some View {
        Text("你好，iOS")
            .onAppear { loadData() }              // 界面出现：加载数据
            .onDisappear { cleanup() }            // 界面消失：清理
            .onChange(of: scenePhase) { _, phase in
                switch phase {
                case .active:   refresh()          // 回前台：刷新
                case .background: saveState()      // 切后台：保存状态！
                default: break
                }
            }
    }
}

// UIKit ViewController 生命周期（老项目）
// viewDidLoad（创建）→ viewWillAppear（即将出现）
// → viewDidAppear → viewWillDisappear → viewDidDisappear
// ≈ Android Activity 的 onCreate → onResume → onPause

【为什么状态保存重要】
  切后台 → 系统可能杀进程 → 用户回来 → 要恢复
  保存：UserDefaults / 文件 / Core Data（第5站）
  恢复：scenePhase 判断 + 读取保存的数据

【前台 vs 后台能力（iOS 严格限制）】
  后台任务：有窗口期（几分钟）——长任务用 BGTask
  后台音乐/定位：要申请特殊权限（Background Modes）
  → 比 Android 的后台限制更严（苹果省电哲学）

// ① Codable：JSON 自动互转（Gson 的 Swift 版）
struct Order: Codable, Identifiable {
    let id: Int
    let title: String
    let amount: Double
}

// ② URLSession：网络请求（Retrofit 的 iOS 版）
func fetchOrders() async throws -> [Order] {
    let url = URL(string: "https://api.ledger.com/orders")!
    let (data, _) = try await URLSession.shared.data(from: url)
    return try JSONDecoder().decode([Order].self, from: data)
}

// ③ SwiftData：本地数据库（Room 的 iOS 版）
@Model
final class OrderModel {
    var id: Int
    var title: String
    var amount: Double
}

// ④ UserDefaults：偏好存储（DataStore 的 iOS 版）
UserDefaults.standard.set("paid", forKey: "user_tier")
let tier = UserDefaults.standard.string(forKey: "user_tier")

【Repository 模式（第十六本老朋友）】
  网络 + 本地 + 缓存统一入口 → ViewModel 调用
  → 和 Android/后端完全同构！

【沙箱目录规矩】
  Documents：用户数据（备份到 iCloud/电脑）
  Library/Caches：缓存（系统可清）
  Library/Preferences：UserDefaults 存这
  tmp：临时文件（用完即删）

【选择建议】
  小数据/设置   → UserDefaults
  结构化数据    → SwiftData（新）/ Core Data（老）
  文件/图片     → 沙箱文件目录 + FileManager

// ✅ 新一代：async/await（推荐）
struct OrderService {
    func loadOrders() async throws -> [Order] {
        // await 挂起：不阻塞主线程
        let (data, _) = try await URLSession.shared.data(from: url)
        return try JSONDecoder().decode([Order].self, from: data)
    }
}

// MainActor：UI 更新自动回主线程
@MainActor
final class OrderViewModel: ObservableObject {
    @Published var orders: [Order] = []

    func refresh() async {
        do {
            orders = try await service.loadOrders()   // 自动主线程更新
        } catch {
            errorMessage = "加载失败：\(error.localizedDescription)"
        }
    }
}

// ❌ 老一代 GCD（维护老代码会看到）
DispatchQueue.global().async {
    let data = loadData()                     // 后台干活
    DispatchQueue.main.async {                 // 手动回主线程
        self.orders = data
    }
}

// Actor：并发安全的数据类型（无锁竞争）
actor Counter {
    private var value = 0
    func increment() -> Int { value += 1 }
}
let c = Counter()
let n = await c.increment()                    // 自动串行访问

【async/await 心法（第十八本同款）】
  await 挂起 → 不占线程 → 完成后继续
  @MainActor 保证 UI 更新在主线程——告别手动切队列
  Task { } 创建异步任务；TaskGroup 并行多个

【对比三平台（你会哪个都不亏）】
  Swift async/await ≈ Kotlin 协程 ≈ C# async/await
  MainActor ≈ Dispatchers.Main ≈ UI 同步上下文
  → 一套思想，三套语法！

// ① 协议：依赖接口（测试可换 Mock）
protocol OrderServicing {
    func loadOrders() async throws -> [Order]
}

struct OrderService: OrderServicing { ... }        // 真实现
struct MockOrderService: OrderServicing { ... }    // 测试用假货

// ② ViewModel：状态 + 逻辑（MVVM）
@MainActor
final class OrderViewModel: ObservableObject {
    @Published var orders: [Order] = []
    @Published var isLoading = false

    private let service: OrderServicing

    init(service: OrderServicing) { self.service = service }  // 注入

    func refresh() async {
        isLoading = true
        defer { isLoading = false }
        orders = (try? await service.loadOrders()) ?? []
    }
}

// ③ View：SwiftUI 消费状态（第3站）
struct OrderListView: View {
    @StateObject private var vm = OrderViewModel(service: OrderService())
    var body: some View { List(vm.orders) { ... } }
}

【SPM 依赖（官方包管理）】
  Package.swift 声明依赖：
  dependencies: [ .package(url: "https://github.com/...", from: "1.0.0") ]
  → Xcode 自动拉取（Maven/NuGet 同款）

【Combine vs 新 Observation】
  Combine：@Published + sink（iOS 13+，成熟）
  @Observable：iOS 17+ 新宏——更简洁（新项目可选）

【对比 Android（第十七本）】
  MVVM 一模一样
  Combine ≈ Flow
  SPM ≈ Gradle 依赖
  协议注入 ≈ 接口 + Hilt
  → 架构完全同构，换个名字而已

【从源码到 App Store 的完整流程】
  ① Mac + Xcode 开发（模拟器调试）
  ② 真机调试：开发者证书 + Provisioning Profile（绑定设备）
  ③ 测试：XCTest 单元测试 + XCUITest UI 测试（第9站）
  ④ 打包：Xcode Archive（归档）→ 上传 App Store Connect
  ⑤ TestFlight 内测：邀请测试员 → 真机试用（必经流程）
  ⑥ 提交审核：App Store Review → 等 1~3 天
  ⑦ 发布：通过后上架（可定时发布）
  → 整个流程 3~7 天，审核被拒就打回重来（第10站）

【证书体系（重点，Android 没有这么复杂）】
  开发证书：真机调试用（开发者账号 $99/年）
  发布证书：上架用（.p12 + 密钥，丢了要撤销重建）
  Provisioning Profile：证书 + 设备 + App ID 的「通行证」
  → Xcode 自动管理（Signing & Capabilities 面板）

【TestFlight 好处】
  100 名内部测试员 + 1 万外部测试员
  真机验证、收集反馈、审核前「排雷」
  → 上架前的必经一步

【CI/CD（自动化）】
  Xcode Cloud（官方）/ GitHub Actions + fastlane
  fastlane：自动签名/打包/上传/截图——iOS 自动化神器

// ① XCTest：单元测试（JUnit 同款）
import XCTest

final class OrderViewModelTests: XCTestCase {
    func test_金额格式化() {
        let vm = OrderViewModel(service: MockOrderService())
        XCTAssertEqual(vm.formatAmount(1299.00), "¥1,299.00")
    }
}

// ② XCUITest：UI 测试（点按钮断言界面）
func test_点击刷新_列表更新() throws {
    let app = XCUIApplication()
    app.launch()
    app.buttons["刷新"].tap()
    XCTAssertTrue(app.staticTexts["订单 #1"].waitForExistence(timeout: 5))
}

// ③ Instruments：性能体检（Xcode 内置）
//   Time Profiler：找出最耗时的函数（cProfile 同款）
//   Leaks：内存泄漏检测（LeakCanary 同款）
//   Allocations：内存占用分析（OOM 排查）

【崩溃监控（Crashlytics）】
  集成 SDK → 崩溃自动上报 → 堆栈 + 设备 + 版本
  发布后盯 48 小时：崩溃率 > 0.5% 紧急处理
  → 和 Android 第十七本同款流程

【iOS 特有性能坑】
  内存：iPhone 内存紧张——大图/大列表容易 OOM
    优化：图片压缩/懒加载/缓存策略
  启动：冷启动 < 2 秒——启动任务异步化
  卡顿：主线程别干重活（第6站 async 的用武之地）

【发布质量门槛】
  XCTest 核心逻辑 100% 覆盖
  Instruments 无泄漏告警
  TestFlight 测试 3~7 天无崩溃
  启动 < 2 秒 / 不掉帧

【过审 Checklist】
  □ App 能跑：无崩溃、无卡死（第9站质量门槛）
  □ 功能完整：每个按钮都能用（半成品=拒）
  □ 隐私：隐私政策 + 隐私标签 + 权限用途说明
  □ 内容合规：无违规内容/无仿冒
  □ UI 规范：遵循 Apple 设计规范（HIG）
  □ 内购正确：虚拟商品走 IAP（别偷偷用微信/支付宝！）

【权限说明（Info.plist）】
  NSCameraUsageDescription: "用于扫描账单二维码"
  NSLocationWhenInUseUsageDescription: "用于记账时自动定位"
  → 用途必须真实具体，苹果会抽查！

【隐私标签（隐私营养表）】
  声明：收集哪些数据（联系信息/位置/使用数据…）
  用途：是否用于追踪/广告
  → 用户下载前就能看到——「诚实是最好策略」

【IAP 规则（苹果税）】
  虚拟商品（会员/金币/订阅）→ IAP，抽成 30%
  实体商品/线下服务（外卖/打车/实物）→ 不受限
  → 设计付费时先想清楚：数字内容还是实体服务！

【适配要点（第17本 Android 同款思路）】
  Safe Area：刘海/灵动岛避让（SafeAreaInsets）
  深色模式：颜色语义化（系统自动适配）
  动态字体：文本自适应大字体（无障碍）
  机型矩阵：SE（小屏）~ Pro Max（大屏）+ 折叠屏