Skip to main content
GitHub release

​
Installation

To use Qonversion in your Flutter app, add qonversion as a dependency in your pubspec.yaml file:
Then install dependency

​
iOS and macOS native dependencies

Flutter wires up the native part of the plugin (QonversionSandwich and the Qonversion iOS SDK) itself on flutter run / flutter build. Starting from qonversion_flutter 11.11.0 this works with both package managers Flutter supports:
  • Swift Package Manager — opt-in since Flutter 3.24 (flutter config --enable-swift-package-manager), on by default since Flutter 3.44. The plugin ships Package.swift manifests for iOS and macOS, so no Podfile and no CocoaPods installation are needed for Qonversion.
  • CocoaPods — Flutter older than 3.24, Swift Package Manager disabled, or add-to-app modules integrated through CocoaPods. The plugin keeps resolving through its podspec, unchanged.
CocoaPods trunk becomes read-only on December 2, 2026: new versions of the native Qonversion SDK will no longer be published to CocoaPods trunk — the Swift Package Manager path is the supported way to receive them; existing CocoaPods builds keep working. Enable Swift Package Manager in Flutter before then — see the migration guide.
Requirements and notes for the Swift Package Manager path:
  • Minimum OS versions are iOS 13.0 and macOS 10.15 with both package managers.
  • On Flutter 3.24–3.34, build with flutter run / flutter build, or run flutter build ios --config-only (flutter build macos --config-only) before building from Xcode, so that Flutter raises the generated plugin package to your deployment target. Otherwise Xcode reports The package product 'qonversion-flutter' requires minimum platform version 13.0. Flutter 3.35+ needs nothing extra.
  • If your Podfile also declares pod 'Qonversion' directly, remove it — with Swift Package Manager the native SDK arrives through the Swift package.
  • Hand-written native code that imported the old Objective-C shim must switch to @import qonversion_flutter; and the QonversionPlugin class (11.11.0 removed the shim; generated registrants are unaffected).

​
Kids Mode for Qonversion Flutter SDK

In case you are building an App for Kids, follow this guide to learn about Kids Mode for Qonversion SDKs.

​
Next steps

The SDK is installed. Choose the mode to implement — this determines how much code you write next.

Analytics Mode

Get best-in-class subscription analytics without changing your purchase flow — the fastest way to start.

Subscription Management Mode

Let Qonversion fetch products, make purchases, and manage cross-platform access.