Skip to main content

​
Install SDK

Qonversion supports Swift Package Manager (recommended) and CocoaPods to package your dependencies as a framework. The Swift package supports watchOS 6.2+ and visionOS 1.0+.

​
Install via Swift Package Manager

Open Xcode (15 or newer), go to File → Add Package Dependencies…, enter the package URL https://github.com/qonversion/qonversion-ios-sdk in the search bar and add the Qonversion library to your app target. With Swift Package Manager the Swift-only API lives in its own module (import QonversionSwift) — see the iOS installation page for the module table. No-Codes is available on iOS only.

​
Install via CocoaPods

CocoaPods trunk becomes read-only on December 2, 2026. From that date new Qonversion releases will no longer be published to CocoaPods trunk — Swift Package Manager is the supported way to receive them; existing CocoaPods builds keep working. See the CocoaPods → Swift Package Manager migration guide.
Add dependency to Podfile.
Run pod install in the project directory to download the dependency.

​
Data sharing between iOS and watchOS

Please note that for our SDK to work correctly in the watchOS application (as well as when working with iOS Extensions), it is necessary to set up data sharing between iOS and watchOS applications so that we can identify the same user across both applications. First, you need to enable data sharing between your app and shared extensions.
  1. Enable app groups for the containing app and extension via Xcode or the Developer portal. Choose your App target in Xcode. Select Signing & Capabilities, click + Capability and select App Groups.
  2. Register the app group in the portal. In Xcode, add the new App Group ID.
  3. Choose that App Group ID for the extension and containing app.
  4. Pass user defaults instance created with a suite name to Qonversion via Qonversion.Configuration setCustomUserDefaults() function.
After those steps, all content stored in the user defaults will be shared between the watchOS App and containing App.
Kids Mode Analytics Mode