SDK 概览
SubHub 提供 iOS 与 Android 原生 SDK，各平台仅暴露六个公开方法。保持轻量 — 不包含鉴权、分析或 Remote Config。
选择平台
iOS SDK 基于 Swift，通过 Swift Package Manager 集成，内部使用 StoreKit 2。完整参考见侧边栏「iOS SDK」。
Android SDK 基于 Kotlin，通过 Maven Central 集成，内部使用 Play Billing Library 6.0+。完整参考见侧边栏「Android SDK」。
两个 SDK 共享相同的方法签名与语义，业务逻辑统一由 SubHub 后端处理。
完整 SDK 接口
以下六个方法在两个平台上名称与行为一致。详细参数与示例请参阅各平台文档。
| 方法 | 说明 |
|---|---|
| configure() | 初始化 SDK，传入 Publishable Key |
| identify() | 关联开发者提供的 opaque 用户标识 |
| purchase() | 发起应用内购买并自动验证凭证 |
| restore() | 恢复历史购买 |
| entitlements() | 列出当前成员持有的权益 |
| hasEntitlement() | 检查单个权益（客户端鉴权推荐方式） |
最佳实践
- 使用 hasEntitlement() 做客户端鉴权，不要使用 hasProduct() 或直接查 Product
- configure() 必须在 App 启动时、其他 SDK 方法之前调用
- identify() 可选 — 未调用时成员以 anonymousId 标识
- purchase() 的 productId 为商店 SKU，非平台内部 Product ID