通用开源 In-App Purchase 组件库(设计阶段)。
- StoreKit 1 为全平台基线,StoreKit 2 作为 iOS 15+ 运行时自动选中的增强后端,两者共存、Router 统一路由。
- 上层协议抽象,公开 API 统一
async/await。 - 聚焦 IAP 边界事件:Ask to Buy 延迟批准、发货中途崩溃、退款 / 撤销、跨设备恢复、 沙盒续订洪泛、开发者账号转移、宽限期 / billing retry 等。
- 持久化履约账本(at-least-once 调用 + 业务幂等实现 effectively-once)+ 多来源权益裁决引擎。
iOS 13 · macOS 10.15 · tvOS 13 · watchOS 6.2 · visionOS 1 · Swift tools 5.9+ (依据见 docs/DEPLOYMENT-TARGET.md)
| 文档 | 内容 |
|---|---|
| docs/README.md | 定位、设计目标、Non-Goals、支持矩阵 |
| docs/ARCHITECTURE.md | 分层、模块、Provider 路由、并发模型、可观测性、测试 |
| docs/PROTOCOLS.md | 领域模型值类型 + 协议签名草案 |
| docs/STATE-MACHINE.md | 履约账本状态机 + 权益裁决引擎 + reconcile |
| docs/EDGE-CASES.md | 边界场景 × SK1/SK2 机制 × 库策略 矩阵 |
| docs/SERVER.md | App Store Server API / ASSN v2 / 凭证抽象 / 对账 |
| docs/DEPLOYMENT-TARGET.md | 部署底线决策与同类库调研 |
| docs/OPEN-QUESTIONS.md | 待决策项与风险登记册 |
| docs/ARCHITECTURE-REVIEW.md | 实现前架构审计、收敛决策、target 图与里程碑门禁 |
待定(建议 MIT)。