• Added setImeiData, setOaidData, and setAndroidIdData (Android only)

Migration to AppsFlyer SDK 7. This is a major release with intentional breaking changes. See doc/migration-guide.md for removed APIs, renames, lifecycle changes, and upgrade instructions.

• Flutter plugin version 7.0.2
• Minimum Flutter version 3.35.0
• Minimum Dart version 3.9.0 (and earlier than Dart 4.0.0)
• Android build toolchain, aligned with the AppsFlyer Android SDK: Kotlin Gradle Plugin 2.0.21, Android Gradle Plugin 8.9.1, Gradle 8.11.1, JDK 17
• Android AppsFlyer SDK 7.0.1
• iOS AppsFlyer SDK 7.0.2
• Android Purchase Connector 2.2.0
• iOS Purchase Connector 7.0.2
• iOS minimum deployment target 13.0
• Android minimum API level 21
• Documentation remains organized under doc/, with the complete upgrade catalog in doc/migration-guide.md.

BREAKING

• Raised the minimum Flutter version to 3.35.0 (Dart 3.9.0) and aligned the Android build toolchain with the AppsFlyer Android SDK: Kotlin Gradle Plugin 2.0.21, Android Gradle Plugin 8.9.1, Gradle 8.11.1, JDK 17. The Android dependencies are compiled with Kotlin 2.0, so an older Kotlin Gradle Plugin cannot read their metadata; the previously advertised floor of Flutter 3.24 templates Kotlin 1.7.10 and could not build the plugin at all. The build now fails at configuration time with a message naming the version found and the file to change, because the Kotlin Gradle Plugin version is declared by the app and does not change when Flutter is upgraded.
• Replaced AppsflyerSdk(options) and AppsFlyerOptions with the shared AppsFlyerSdk.instance singleton and explicit configuration methods.
• Replaced initSdk(...) with init(devKey:, appId:). appId is required on iOS, optional on Android, and is not sent to the Android SDK.
• Replaced startSDK(...) with await start(). Initialization no longer sends a session. Call registerSessionReadyListener(onReady) and call start() once for each readiness event.
• Replaced callback registration flags with explicit listener registration that takes the callback as an argument: registerConversionListener( onConversionDataSuccess:, onConversionDataFail:), registerDeepLinkListener(onDeepLinking:), and registerSessionReadyListener(onReady). Each callback is named after the event it handles, so the same handler names apply across the AppsFlyer plugins. Every callback except onReady is optional — pass only the ones you need. The plugin holds one callback per event and replaces it on re-registration, matching the native SDKs; no event stream is exposed, so a single native event cannot fan out to several handlers in the app. Registering and unregistering are all-or-nothing: when the native call fails, the Dart callbacks are left exactly as they were.
• registerDeepLinkListener(onDeepLinking:) must be called before init(). Android decides once per install, while init() processes the launch intent, whether to send the deferred deep-link resolution request, and skips it when no listener is registered yet. The other listeners are still registered after init().
• Native and plugin failures from operations that await a result are surfaced as AppsFlyerException (int? code, String message). Non-numeric platform codes leave code as null. MissingPluginException is not converted. Failures from fire-and-forget calls are not reported.
• start, logEvent, and generateInviteLink expose awaitResponse where the native SDK supports waiting for a completion callback. It defaults to false for start and logEvent, and to true for invite-link generation. validateAndLogInAppPurchase has no such flag: both platforms always wait for the validation result.
• Removed OAOA callbacks and registration. Use Unified Deep Linking.
• Replaced performOnDeepLinking() with performDeepLinking(url, {shouldTriggerSession}).
• Replaced legacy V1 Android/iOS purchase validation and validateAndLogInAppPurchaseV2(...) with validateAndLogInAppPurchase(AFPurchaseDetails, ...). Use AFAndroidPurchaseDetails with a Play purchase token or AFIOSPurchaseDetails with an App Store transaction ID.
• Replaced the cross-platform sendPushNotificationData(Map) shape with platform-specific Android sendPushNotificationData(...) and iOS handlePushNotification(pushPayload) APIs.
• Replaced setConsentDataV2(...) and the AppsFlyerConsent wrapper with the flat setConsentData(...) API and its four SDK 7 consent fields.
• Renamed platform APIs to match the final SDK 7 surface, including enableDebug, setDisableSKAdNetwork, setDisableAppleAdsAttribution, setDisableIDFVCollection, setUseReceiptValidationSandbox, and setUseUninstallSandbox.
• setUserFbLoginId now accepts an int; mediation values use AFMediationNetwork; invite-link fields use referrerCustomerId and userParams.
• Removed SDK 6 APIs that no longer exist in SDK 7 or are not exposed by the plugin, including onAppOpenAttribution, setUserEmails, EmailCryptType, raw IMEI and Android ID setters, V1 purchase validation, setPushNotification, enableUninstallTracking, waitForCustomerUserId, and setCustomerIdAndLogSession.
• Runtime configuration setters must be re-applied on every cold start before start().
• Every platform-only method now throws AppsFlyerException when called outside its supported platform, instead of some logging a warning and returning a safe default while others threw. The plugin no longer keeps its own table of which platform implements what — calls are forwarded and the native layer answers, so the surface stays correct as the native SDKs change. Code that relied on an off-platform call being a silent no-op must guard it with Platform.isAndroid / Platform.isIOS or catch the exception. The exception code comes from the native layer, which reports 404 for an unimplemented method on both platforms.
• getHostName() and getHostPrefix() now return non-nullable Future<String> instead of Future<String?>; unexpected native null replies throw AppsFlyerException instead of surfacing as null. Both are available on Android and iOS — see Added below.
• Bool getters such as isSessionReady, isStopped, and isPreInstalledApp no longer coerce an unexpected native null to false; they throw AppsFlyerException instead.
• setSharingFilterForPartners(null) and setSharingFilterForPartners([]) are forwarded to the native layer instead of being ignored in Dart, and clear the filter on Android and iOS alike.
• setConsentData accepts nullable consent fields: only isUserSubjectToGDPR is required; the three consent booleans are optional and may be omitted or null for non-GDPR users, matching native AppsFlyerConsent.
• Added Android-only collectDataFromLauncherActivity(), which collects the open/web referrer from the launcher activity's intent. Call it before start(). It requires an attached activity and otherwise fails with AppsFlyerException (code 422).
• setInstallId() requires AppsFlyerAllowCustomInstallId=YES in iOS Info.plist and must be called before init() on iOS. Android requires APPSFLYER_ALLOW_CUSTOM_INSTALL_ID=true in AndroidManifest.xml and the call must follow init().
• Android Purchase Connector 2.2.0 requires Google Play Billing Library 8.x. The Flutter plugin does not add Billing Library; the app or its IAP plugin must provide it. iOS Purchase Connector requires CocoaPods, while Core-only apps can use Swift Package Manager.
• Remove legacy SingleInstallBroadcastReceiver and MultipleInstallBroadcastReceiver manifest entries. The plugin already includes Google Play Install Referrer 2.2.
• Removed the Core CocoaPods Objective-C public headers (AppsflyerSdkPlugin.h, AppsFlyerAttribution.h, AppsFlyerStreamHandler.h, FlutterAppDelegate+AppsFlyerStreamHandler.h). The iOS bridge is Swift-only; host apps that imported those headers must rely on automatic plugin registration or import <appsflyer_sdk/appsflyer_sdk-Swift.h> instead. See migration guide — iOS: Objective-C public headers removed.

See the v6 → v7 migration guide for the complete replacement table.

Added

• Added AppsFlyerSdk.instance, init(...), registerSessionReadyListener(onReady), unregisterSessionReadyListener(), isSessionReady(), and start() for the SDK 7 lifecycle.
• Added the cross-platform enableDebug(bool) toggle and Android-only setLogLevel(AFLogLevel).
• Added typed event callbacks (OnConversionDataSuccess, OnConversionDataFailure, OnDeepLinkReceived, OnSessionReady) and AppsFlyerException.
• Added hashed-PII setters setUserEmail, setUserPhone, setUserFirstName, and setUserLastName, plus integer setUserFbLoginId and clearUserPii.
• Added performDeepLinking, setDeepLinkTimeout, appendParametersToDeepLinkingURL, and iOS-only setFacebookDeferredAppLink.
• Added the AFPurchaseDetails interface with dedicated AFAndroidPurchaseDetails and AFIOSPurchaseDetails implementations.
• Added Android-only logSession, setPreinstallAttribution, setAppId, isPreInstalledApp, getAttributionId, unregisterDeepLinkListener, and unregisterConversionListener APIs. On Android, unregisterDeepLinkListener does not reliably stop subsequent deep-link events; do not depend on it as an effective unsubscribe.
• Added isStopped, getHostName, and getHostPrefix on both platforms. On iOS, getHostName and getHostPrefix return an empty string until setHost is called.
• Added iOS-only setDisableAppleAdsAttribution, setDisableIDFVCollection, setShouldCollectDeviceName, and setUseUninstallSandbox APIs.
• Added logInvite, logLocation, setInstallId, and awaitable generateInviteLink support.

Fixed

• iOS Purchase Connector: a validation payload the native SDK reports with a value JSON cannot represent no longer terminates the app. The serialization helper behind didReceivePurchaseRevenueValidationInfo called JSONSerialization.data(withJSONObject:) under try?, which does not catch the NSInvalidArgumentException that call raises, so an NSDate, an NSData or a non-String key in the delegate's untyped dictionary aborted the process. The helper now checks isValidJSONObject first and returns nil, which surfaces as a reported parse failure — the callback fires with no data and a log line — instead of a crash. Only affects apps that opted into the Purchase Connector.
• enableDebug now controls the plugin's own diagnostics as well as native SDK logging. The plugin printed through debugPrint, which Flutter does not compile out of release builds, so those lines reached production logs whatever the app had passed to enableDebug. Release builds are quiet by default and print again after enableDebug(true); debug builds always print.
• Calling the SDK from a background isolate — a push handler, a workmanager task, compute() — now throws a catchable AppsFlyerException naming the cause. Platform channels are bound to the main isolate, and the underlying StateError escaped through the event stream's subscribe callback rather than the returned Future, so no try/catch around the call could intercept it and the background isolate terminated mid-task. AppsFlyerSdk.instance is also a per-isolate singleton, so a background isolate never sees the instance you configured. See doc/getting-started.md.
• Native events that fail to parse are logged by error type only. The log line previously interpolated the error, and FormatException.toString() appends an excerpt of the string it could not parse, so a truncated or malformed event put raw attribution data — click and deep-link identifiers among it — into the host app's release log. Stream errors are logged the same way, naming the platform error code but not the message or details.
• Purchase Connector: a validation payload that omitted an optional field was silently dropped — the generated fromJson casts were non-nullable, and the resulting error was raised inside a platform-message handler, so neither onResponse nor onFailure fired and the app could not catch it. BREAKING: every field of ProductPurchase, SubscriptionPurchase and the types it nests, ValidationFailureData, JVMThrowable and IosError is now nullable, matching the Google Play Developer API, which documents purchaseToken, productId, quantity, purchaseType and the obfuscated identifiers as conditionally present and omits any field left at its default value. success and the result maps stay non-nullable. A payload that still cannot be parsed is reported through onFailure with a message naming the callback and the error type — never the payload, which carries purchase and account identifiers. See doc/migration-guide.md.
• Purchase Connector: removed stray [AppsFlyer_PC_Debug] print logging that shipped in release builds; the callback handler now accepts both JSON-string and already-decoded Map payloads and logs (instead of throwing) on an unrecognized callback name.
• Purchase Connector (Android): subscription and in-app validation-result listeners (setSubscriptionValidationResultListener / setInAppValidationResultListener) never fired — the Dart callback-name constants used a # separator while the native side invokes the channel with :, so the handler's switch never matched. Aligned the Dart constants to :, so these result listeners now deliver.
• Android: native events emitted while no Flutter engine was attached were lost. The native SDK keeps the listener registered by a detached engine (subscribeForDeepLink and registerConversionListener overwrite a single reference, and deep links have no unsubscribe API), so a deep link or conversion-data callback arriving after the Activity was destroyed — for example a link tapped after leaving the app with the back button — was written into the buffer of a plugin instance Dart could no longer reach. Buffering and replay moved to a process-scoped relay, so those events are delivered to the next subscriber in the order they were published.
• Optional Android Purchase Connector state is cleared when the Flutter engine detaches.
• Corrected iOS ad-mediation identifiers for custom and direct monetization.
• Updated documentation and examples for the final SDK 7 API.

• Updated Android SDK from 6.17.6 to 6.18.0
• Updated iOS SDK from 6.17.9 to 6.18.0
• Updated iOS Purchase Connector from 6.17.9 to 6.18.0
• Fixed Android warm-app deep link consumption race so DeepLinkListener fires reliably when the app is resumed from a VIEW intent (forward new intents to AppsFlyerLib from the plugin's onNewIntentListener before the SDK's onResume auto-handler marks them af_consumed)
• Added Swift Package Manager (SPM) support for the Core iOS integration (ios/appsflyer_sdk/Package.swift), alongside continued full CocoaPods support — no behavior change for existing CocoaPods consumers. Purchase Connector remains CocoaPods-only for now, pending resolution of an upstream Flutter limitation (flutter/flutter#161182) that blocks conditionally-compiled plugin features under SPM.

• Added UIScene lifecycle support for iOS deep linking (Flutter 3.41+ compatibility)
  • Adopted FlutterSceneLifeCycleDelegate with compile-time guard for backward compatibility
  • Added scene:openURLContexts: for warm-start URI-scheme deep links
  • Added scene:willConnectToSession:options: for cold-start URI-scheme and Universal Links
  • Added scene:continueUserActivity: for Universal Links via UIScene
• Fixed getViewController to use UIWindowScene lookup on iOS 13+ (replaces deprecated UIApplication.delegate.window)
• Updated iOS SDK from 6.17.8 to 6.17.9
• Updated iOS Purchase Connector from 6.17.8 to 6.17.9

• Updated Android SDK from 6.17.4 to 6.17.5
• Updated iOS SDK from 6.17.7 to 6.17.8
• Updated iOS Purchase Connector from 6.17.7 to 6.17.8
• Deprecated validateAndLogInAppAndroidPurchase (V1) - use validateAndLogInAppPurchaseV2 instead
• Deprecated validateAndLogInAppIosPurchase (V1) - use validateAndLogInAppPurchaseV2 instead
• Enhanced iOS error handling for validateAndLogInAppPurchaseV2 with comprehensive NSError parsing (code, domain, userInfo)
• Documentation Updates:
  • Removed "Beta" label from validateAndLogInAppPurchaseV2 API
  • Marked V1 purchase validation APIs as Deprecated
  • Added comprehensive PlatformException error handling examples for V2 API
  • Added iOS token format explanation for uninstall measurement
  • Added cross-platform Firebase Messaging example for uninstall tokens

• Update Android SDK version to 6.17.4

• Updated to AppsFlyer SDK v6.17.7 for iOS and Flutter plugin version
• Android AppsFlyer SDK remains at v6.17.3
• iOS AppsFlyer SDK upgraded to v6.17.7
• Android Purchase Connector module updated (to support Google Billing Library 8)
• Code cleanups
• Documentation Updates:
  • Enhanced push notification measurement documentation with clear separation between traditional af object approach and OneLink URL approach
  • Added comprehensive iOS-specific requirements for OneLink push notification integration
  • Clarified the need to call sendPushNotificationData() on iOS when using addPushNotificationDeepLinkPath()
  • Added complete code examples for both push notification integration approaches with Firebase Cloud Messaging
  • Added Flutter 3.27+ breaking change documentation for deep linking (must disable Flutter's built-in deep linking to avoid conflicts with AppsFlyer)
  • Replaced effective_dart with flutter_lints in development dependencies

• Updated to AppsFlyer SDK v6.17.5 for iOS

• Updated to AppsFlyer SDK v6.17.3 for both Android and iOS
• Added validateAndLogInAppPurchaseV2 API (Beta) for improved cross-platform purchase validation
• Unified AFPurchaseDetails data structure for type-safe purchase validation
• Enhanced error handling and consistent API across Android and iOS
• Maintains backward compatibility with existing purchase validation methods

• Android: Bug fix for users who expirienced NullPointerExceptions.
• Android: added a new disableAppSetId() method for AppSet ID opting-out.
• iOS: Added support for Google Integrated Conversion (ICM) measurement.
• Documentation small fixes.
• Purchase Connector is rolled out to production (StoreKit2 support will be enrolled on next release).

• Bug fix for users who reported Locale issue on Android, fixed Locale issue by forcing toUpperCase(Locale.ENGLISH)
• Expanded the unit–tests

• setConsentData is now deprecated!
• setConsentDataV2 is the new and recommended way to set manual user consent.
• Added getVersionNumber, returns the plugin's version.
• Fixed typos within the code.
• Fixed and updated tests and their frameworks.
• Push notification measurment API's documentation has been updated.
• Closed a few potential memory leaks.
• Update iOS version to 6.16.2
• Update Android version to 6.16.2

• Fixed NullPointerException issue on Android that some clients had.
• Fixed Android MediationNetwork enum issue.
• Update iOS version to 6.15.3
• Update Android version to 6.15.2

• Implementation of the new logAdRevenue API for iOS and Android
• Documentation update for the new logAdRevenue API
• Update iOS version to 6.15.1
• Update Android version to 6.15.1

• Fixed mapOptions issue with manualStart
• Inherit Privacy Manifest from the native iOS SDK via Cocoapods
• Bump iOS version to 6.14.3

• Bump version to iOS v6.14.2 and Android v6.14.0
• Added Privacy Manifest to support Apple latest changes: https://developer.apple.com/documentation/bundleresources/privacy_manifest_files

• Hotfix for manualStart on iOS

• Added new APIs such as anonymizeUser , performOnDeepLinking
• Added to the startSDK API, onSuccess and onError callbacks
• Update to iOS SDK to v6.13.2

• Update to iOS SDK to v6.13.1

• Added enableTCFDataCollection , setConsentData with AppsFlyerConsent class
• Added new boolean option to AppsFlyerOption class , manualStart
• Added startSDK API
• Updated readme and elaborated on the new APIs

• Update to Android SDK to v6.12.2 & iOS SDK to v6.12.2
• Deprecated CreateOneLinkHttpTask updated to LinkGenerator
• Fixed Gradle 8.0 issue
• Documented API and removed unused imports

• null pointer exception fix for android, push notification bug fix & ios sdk 6.11.2

• update to Android SDK to v6.11.2

• update to Android SDK to v6.11.1

• update to Android SDK to v6.10.3 & iOS SDK to v6.10.1

• update to Android SDK to v6.9.3 & iOS SDK to v6.9.1
• Added addPushNotificationDeepLinkPath API
• Added setCustomerIdAndLogSession API for android

• update to android v6.8.2

• The API enableLocationCollection has been removed.
• The API setDisableNetworkData has been added.
• The AD_ID permission has been added to the plugin.
• Updated AppsFlyer Android SDK to v6.8.0
• Updated AppsFlyer iOS SDK to v6.8.0

• New APIs: getOutOfStore, setOutOfStore, setResolveDeepLinkURLs, setPartnerData

• Updated AppsFlyer Android SDK to v6.5.2
• Updated AppsFlyer iOS SDK to v6.5.2

• Added nullable in deeplink object
• Remove of local stream import

• Updated to 6.4.0 in iOS & Android SDK
• Dedicated class for UDL for handling deeplink
• New API setSharingFilterForPartners.setSharingFilter & setSharingFilterForAllPartners APIs were deprecated.
• setIntent is not required anymore in MainActivity (Android)
• application(_:open:sourceApplication:annotation:) is not required anymore in AppDelegate (iOS)
• application(_:open:options:) is not required anymore in AppDelegate (iOS)
• application(_:continue:restorationHandler:) is not required anymore in AppDelegate (iOS)

rollback to previous version

Removed streams from the plugin

Added setCurrentDeviceLanguage API

• Updated AppsFlyer iOS SDK to v6.3.5

• fix JNI issue

• change to local broadcast

• Update to SDK v6.3.2 and added support for disabling advertiser ID on Android

• Added effective dart package for linter rules

• Update iOS & Android to SDK v6.3.0

• Fix for deeplinking in iOS

• Update for iOS SDK V6.2.6
• Refactoring for SKAD network feature

• Added support for strict mode (kids app)
• Added support for wait for att status API

• Fix small bug with validateAndLogInAppIosPurchase API

• Small fix for enableFacebookDeferredApplinks, useReceiptValidationSandbox, disableSKAdNetwork, setPushNotification APIs in iOS

• Added disable SKAD API

• Fix for SKAD

• Update to iOS SDK v6.2.4

• Flutter 2.0 update including null safety support

• Flutter 2.0 update including null safety support

• Added enableFacebookDeferredApplinks API

• Update to iOS SDK V6.2.3

• Refactor for user invite feature

• Added callbacks support for purchase validation API

• Added support for useReceiptValidationSandbox API

• Seperated purchase validation API to iOS/Android

• Fixed Unified deeplink crush on first launch

• Hot Fix

• Added support for push notification API

• Update iOS to v6.2.1
• Added support for Unified Deeplink
• Fixed deeplinks issues both for Android & iOS

• Revert back to version 6.2.0

• Added Unified Deeplinking for Android

• Update both iOS & Android to v6.2.0

• Fixed FormatException caused by iOS side

• Switch to callbacks for onAppOpenAttribution and onConversionData

• Fixed updateServerUninstallToken on iOS

• Update SDK version to:
  • Android: 5.4.5
  • iOS: 6.0.5
• Update Google install referrer to 2.1
• Added support for: https://support.appsflyer.com/hc/en-us/articles/207032066#additional-apis-kids-apps
• Fixed typo in validateAndLogInAppPurchase

• Add null check for context in Android

• Fixed bug with sending arguments with methodChannel

• Added the functions: logCrossPromotionAndOpenStore logCrossPromotionImpression setAppInviteOneLinkID generateInviteLink

• Removed AppTrackingTransparency framework

• Updated AppsFlyer iOS SDK to v6.0.3

• Fixed the issue in the example app on Android platform
• Updated AppsFlyer SDK to v5.4.3

• iOS sdk version is now 6.0.2 and support AppTrackingTransparency framework
• Android sdk version is 5.4.1

• Added documentation
• Added secured links to README

• Updated AppsFlyer SDK to v5.4.1
• Added sharedFilter support

• Add support for opt-in/ opt-out scenarios
• Fix typo in constant AF_VALIDATE_PURCHASE

• added default values to initSdk params

• Removed the use of RxDart
• Checked that the streams are not closed before sending events

• AppsFlyer sdk version is updated to v5.2.0
• Switched StreamController to BehaviourSubject to fix bad state related to unclosed streams

• initSdk now uses Future.delayed
• Fixed iOS error in initSdk returned String instead of Map

• Updated the README
• initSdk function now uses named parameters

• Updated AppsFlyer SDK version:
  • Android: v5.1.1
  • iOS: v5.1.0
• Added getSdkVersion to the api
• Changed initSdk to return a dynamic map

• Added getAppsFlyerUID function to get a device unique user id

• Updated appsflyer framework to 4.9.0

• Added the following functions:

  • Stream validateAndTrackInAppPurchase( String publicKey, String signature, String purchaseData, String price, String currency, Map<String, String> additionalParameters)
  • void updateServerUninstallToken(String token)
  • Future<String> getHostPrefix()
  • Future<String> getHostName()
  • void setHost(String hostPrefix, String hostName)
  • void setCollectIMEI(bool isCollect)
  • void setCollectAndroidId(bool isCollect)
  • void setAdditionalData(Map addionalData)
  • void waitForCustomerUserId(bool wait)
  • void setCustomerUserId(String userId)
  • void enableLocationCollection(bool flag)
  • void setAndroidIdData(String androidIdData)
  • void setImeiData(String imei)
  • void enableUninstallTracking(String senderId)
  • void setIsUpdate(bool isUpdate)
  • void setCurrencyCode(String currencyCode)
  • void stopTracking(bool isTrackingStopped)
  • void setMinTimeBetweenSessions(int seconds)
  • void setUserEmails(List<String> emails, [EmailCryptType cryptType]

• Fixed onAppOpenAttribution not being called bug

• Added AppsFlyerOptions to support easier options setup
• Changed plugin lib structure

• Fixed iOS app id crash

• Added dartdoc documentation.
• Changed static methods to class instance methods.

First stable version

• Changed access modifiers from public to private to class variables

Supported sdk functions:

• initSdk
• trackEvent
• registerConversionDataCallback
• registerOnAppOpenAttributionCallback

Initial release.