iOS
Platform guide for the Miniwall iOS SDK, covering requirements, StoreKit 2, SwiftUI, UIKit and the privacy manifest.
The iOS SDK is the Swift package MiniwallSDK. It draws screens with SwiftUI and has no third-party dependencies. It needs iOS 16 or later and Swift 5.9. Installation shows how to add it and call configure.
Everything in the other Mobile SDK pages applies. This page collects what is specific to iOS.
Calls at a glance
| What | Call |
|---|---|
| Set up | Miniwall.configure(apiKey:options:) |
| Show a screen | try await Miniwall.present(placement:options:), Miniwall.present(_:options:from:) |
| Embed a screen | MiniwallView(source, options:onFinish:) |
| Load ahead | await Miniwall.preload(placements:) |
| Auto placements | Miniwall.startAutoPlacements(options:onResult:), Miniwall.track(_:) |
| Attributes | Miniwall.setAttributes(_:) |
| After an outside purchase | Miniwall.reportPurchase(packageId:paywallId:) |
| Forget the user | Miniwall.reset(placements:) |
| Package IDs of a screen | Miniwall.packageIds(in:) |
present and the auto placements calls run on the main actor.
StoreKit 2
Miniwall.products(from:), Miniwall.storeKitPurchase(_:) and Miniwall.storeKitRestore() connect StoreKit 2 to a screen. See Purchases and prices. Using them is optional.
UIKit
present finds the top view controller and presents the screen over it. Pass from: to choose the presenter:
let result = try await Miniwall.present(.placement("upgrade_button"), options: options, from: self)To embed in UIKit, host MiniwallView in a UIHostingController.
Display
A full-screen cover, a page sheet (a form sheet on iPad), a sheet as tall as the content, a banner or a toast, depending on the placement. See Display modes.
Privacy manifest
The package includes PrivacyInfo.xcprivacy. See Events and privacy.