The AppActor iOS SDK is the native Swift integration surface for apps that want server-authoritative purchase infrastructure on top of StoreKit 2.

Requirements

  • iOS 15+
  • Swift 5.9+
  • Swift Package Manager or CocoaPods
Some capabilities have narrower availability than the base SDK target:
  • certain promoted purchase helpers require iOS 16.4+
  • newer store features can require later iOS versions than the base minimum

What the SDK covers

  • configure and identity lifecycle
  • offerings and packages
  • package, product, and purchase-intent purchase APIs
  • customer info and entitlements
  • restore, quiet sync, and receipt queue recovery paths
  • Remote Config
  • Experiments
  • customer attributes, profile helpers, integration IDs, and attribution
  • Apple Search Ads helpers and diagnostics

Important architecture note

For standard native iOS apps, integrate the AppActor SDK. The companion AppActorPlugin target exists for hybrid wrapper surfaces and should not be presented as the default native integration path.

Integration truths to remember

  • There is no built-in paywall renderer.
  • configure() is an active startup boundary, not a passive init call.
  • logOut() and reset() are not interchangeable.
  • Restore, sync, and queue-drain paths have different support and recovery roles.
  • Remote Config, Experiments, Attribution, and Apple Search Ads are separate SDK surfaces.