Merge flow-builder: iOS v4 attribution/setIntegrationIdentifier breaking change + CocoaPods removal

Author: eandreeva-twr

src/assets/shared/img/flow-test-on-device-qr.webp

@@ -25,7 +25,7 @@ If you have the customer user ID at app launch, pass it into `activate()` direct
 | 1    | Initialize your MMP or analytics SDK (AppsFlyer, Adjust, PostHog, Branch)                                     | App launch, first                                                                      | Wait for the MMP's UID callback, for example `getAppsFlyerUID`.                                |
 | 2a   | `Adapty.activate(with: config)` with `customerUserId` set on the config                                       | App launch, after step 1, if you have the customer user ID                             | Recommended. No anonymous profile is ever created.                                             |
 | 2b   | `Adapty.activate(with: config)` without `customerUserId`                                                      | App launch, after step 1, if you don't have the customer user ID (or never collect one) | Adapty creates an anonymous profile.                                                           |
-| 3    | `Adapty.setIntegrationIdentifier(key:value:)` for each MMP                                                    | After step 2, before any user-action call                                              | Required so MMP IDs land on the correct profile.                                               |
+| 3    | `Adapty.setIntegrationIdentifier(...)` for each MMP                                                           | After step 2, before any user-action call                                              | Required so MMP IDs land on the correct profile.                                               |
 | 4    | `try await Adapty.identify("YOUR_USER_ID")`                                                                   | After step 3 (or step 2 if no MMP), before step 5 — only on path 2b with authentication | Always `await`. Concurrent calls during `identify` produce `#3006 profileWasChanged`.          |
 | 5    | `getPaywall`, `getPaywallProducts`, `restorePurchases`, `makePurchase`, `updateAttribution`, `updateProfile`  | After step 4 if you call `identify`; otherwise after step 3 (or step 2 if no MMP)      | These calls need a stable profile.                                                             |
 

src/assets/shared/img/flow-test-on-device.webp

@@ -20,6 +20,14 @@ Adapty iOS SDK 4.0 (beta) introduces flows and renames the paywall APIs accordin
 | `.paywall()` (SwiftUI modifier) | `.flow()` |
 | `AdaptyPaywallView` | `AdaptyFlowView` |
 | `didFailRenderingWith:` / `didFailRendering:` | `didReceiveError:` |
+| `Adapty.updateAttribution(_:source:)` (`source: String`) | `Adapty.updateAttribution(_:source:)` (`source: AdaptyAttributionSource`) |
+| `Adapty.setIntegrationIdentifier(key:value:)` | `Adapty.setIntegrationIdentifier(_:)` (`AdaptyIntegrationIdentifier`) |
+
+## Installation: CocoaPods no longer supported
+
+Adapty iOS SDK 4.0 drops CocoaPods support. Install the SDK with [Swift Package Manager](sdk-installation-ios#install-adapty-sdk).
+
+If your project still uses CocoaPods, remove the `Adapty` and `AdaptyUI` pods from your `Podfile`, run `pod install` to clean them up, then add the package in Xcode via **File → Add Package Dependency** using `https://github.com/adaptyteam/AdaptySDK-iOS.git`.
 
 ## Removed APIs
 
@@ -221,3 +229,55 @@ Two changes affect every existing call site:
 + case remote(url: URL, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
 + case player(item: AVPlayerItem, player: AVPlayer, preview: AdaptyUICustomImageAsset?, resolution: CGSize?)
 ```
+
+## Attribution and integration identifiers
+
+### updateAttribution(_:source:)
+
+The `source` parameter changes from `String` to the new `AdaptyAttributionSource` type, and the previously nested `AdaptyProfile.AttributionSource` is renamed to the top-level `AdaptyAttributionSource`. Use one of the predefined sources, or pass a string literal for any other source — `AdaptyAttributionSource` conforms to `ExpressibleByStringLiteral`, so existing string-literal calls keep compiling.
+
+```diff showLineNumbers
+- try await Adapty.updateAttribution(attribution, source: "adjust")
++ try await Adapty.updateAttribution(attribution, source: .adjust)
+```
+
+Predefined sources: `.appleAds`, `.adjust`, `.appsflyer`, `.branch`, `.tenjin`. If you keep the source in a `String` variable, wrap it: `AdaptyAttributionSource(rawValue: yourSource)`.
+
+### setIntegrationIdentifier(_:)
+
+`setIntegrationIdentifier(key:value:)` is replaced by a variadic method that takes one or more `AdaptyIntegrationIdentifier` values. Use the predefined factory methods instead of raw string keys:
+
+```diff showLineNumbers
+- try await Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
++ try await Adapty.setIntegrationIdentifier(.appsflyerId(uid))
+```
+
+You can set several identifiers in a single call:
+
+```swift showLineNumbers
+try await Adapty.setIntegrationIdentifier(
+    .appsflyerId(uid),
+    .adjustDeviceId(adid)
+)
+```
+
+Replace each old key string with its factory method:
+
+| v3 key | v4 factory |
+|---|---|
+| `"adjust_device_id"` | `.adjustDeviceId(_:)` |
+| `"airbridge_device_id"` | `.airbridgeDeviceId(_:)` |
+| `"amplitude_user_id"` | `.amplitudeUserId(_:)` |
+| `"amplitude_device_id"` | `.amplitudeDeviceId(_:)` |
+| `"appmetrica_device_id"` | `.appmetricaDeviceId(_:)` |
+| `"appmetrica_profile_id"` | `.appmetricaProfileId(_:)` |
+| `"appsflyer_id"` | `.appsflyerId(_:)` |
+| `"branch_id"` | `.branchId(_:)` |
+| `"facebook_anonymous_id"` | `.facebookAnonymousId(_:)` |
+| `"firebase_app_instance_id"` | `.firebaseAppInstanceId(_:)` |
+| `"mixpanel_user_id"` | `.mixpanelUserId(_:)` |
+| `"one_signal_subscription_id"` | `.oneSignalSubscriptionId(_:)` |
+| `"one_signal_player_id"` | `.oneSignalPlayerId(_:)` |
+| `"posthog_distinct_user_id"` | `.posthogDistinctUserId(_:)` |
+| `"pushwoosh_hwid"` | `.pushwooshHWID(_:)` |
+| `"tenjin_analytics_installation_id"` | `.tenjinAnalyticsInstallationId(_:)` |

src/content/docs/ios/ios-sdk-call-order.mdx

@@ -141,20 +141,24 @@ For Adjust version 5.0 or later, use the following example:
 
 ```swift showLineNumbers
 class AdjustModuleImplementation {
-
-func updateAdjustAdid() {
-    Adjust.adid { adid in
-        guard let adid else { return }
-        Adapty.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
+    func updateAdjustAdid() {
+        Adjust.adid { adid in
+            guard let adid else { return }
+            // Adapty SDK 4.x
+            Adapty.setIntegrationIdentifier(.adjustDeviceId(adid))
+            // Adapty SDK 3.x
+            Adapty.setIntegrationIdentifier(key: "adjust_device_id", value: adid)
+        }
     }
-}
-func updateAdjustAttribution() {
-    Adjust.attribution { attribution in
-        guard let attribution = attribution?.dictionary() else { 
-            return
+
+    func updateAdjustAttribution() {
+        Adjust.attribution { attribution in
+            guard let attribution = attribution?.dictionary() else { return }
+            // Adapty SDK 4.x
+            Adapty.updateAttribution(attribution, source: .adjust)
+            // Adapty SDK 3.x
+            Adapty.updateAttribution(attribution, source: "adjust")
         }
-        
-        Adapty.updateAttribution(attribution, source: "adjust")
     }
 }
 ```

src/content/docs/ios/migration-to-ios-sdk-v4.mdx

@@ -181,6 +181,10 @@ class YourAppsFlyerLibDelegateImplementation {
     // and update onConversionDataSuccess method:
     func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
         let uid = AppsFlyerLib.shared().getAppsFlyerUID()
+        // Adapty SDK 4.x
+        Adapty.setIntegrationIdentifier(.appsflyerId(uid))
+        Adapty.updateAttribution(conversionInfo, source: .appsflyer)
+        // Adapty SDK 3.x
         Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
         Adapty.updateAttribution(conversionInfo, source: "appsflyer")
     }

src/content/docs/version-3.0/adjust.mdx

@@ -94,6 +94,9 @@ Adapty will send subscription events to Branch using a server-to-server integrat
 
   ```swift showLineNumbers
   do {
+      // Adapty SDK 4.x
+      try await Adapty.setIntegrationIdentifier(.branchId(<BRANCH_IDENTITY_ID>))
+      // Adapty SDK 3.x
       try await Adapty.setIntegrationIdentifier(
           key: "branch_id", 
           value: <BRANCH_IDENTITY_ID>
@@ -156,12 +159,14 @@ Adapty will send subscription events to Branch using a server-to-server integrat
           // Pass the attribution you receive from the initializing method of Branch iOS SDK to Adapty.
           Branch.getInstance().initSession(launchOptions: launchOptions) { (data, error) in
               if let data {
+                  // Adapty SDK 4.x
                   Adapty.updateAttribution(data, source: .branch)
+                  // Adapty SDK 3.x
+                  Adapty.updateAttribution(data, source: "branch")
               }
           }
       }
   }
-
   ```
   </TabItem>
   <TabItem value="kotlin" label="Android (Kotlin)" default>

src/content/docs/version-3.0/appsflyer.mdx

@@ -147,6 +147,9 @@ Make sure to send `playerId` (for OneSignal SDK pre-v5) or `subscriptionId` (for
 // SubscriptionID
 OneSignal.Notifications.requestPermission({ accepted in
     Task {
+        // Adapty SDK 4.x
+        try await Adapty.setIntegrationIdentifier(.oneSignalSubscriptionId(OneSignal.User.pushSubscription.id))
+        // Adapty SDK 3.x
         try await Adapty.setIntegrationIdentifier(
             key: "one_signal_subscription_id", 
             value: OneSignal.User.pushSubscription.id
@@ -255,6 +258,9 @@ OneSignal.User.pushSubscription.addEventListener('change', (subscription) => {
 func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
     if let playerId = stateChanges.to.userId {
         Task {
+            // Adapty SDK 4.x
+            try await Adapty.setIntegrationIdentifier(.oneSignalPlayerId(playerId))
+            // Adapty SDK 3.x
             try await Adapty.setIntegrationIdentifier(
                 key: "one_signal_player_id", 
                 value: playerId

src/content/docs/version-3.0/branch.mdx

@@ -5,6 +5,30 @@ metadataTitle: "Previewing Flow Device Compatibility | Adapty Docs"
 keywords: ['ipad', 'ipad view', 'preview']
 ---
 
+You have two ways to preview your flow on different screen types:
+- **Preview on devices**: Check how your flow looks on real devices at any stage of development.
+- **Preview in the Adapty dashboard**: Preview your flow while designing it.
+
+## Preview on devices
+
+To preview your flow on a real device:
+
+1. [Download the Adapty app from the App Store](https://apps.apple.com/us/app/adapty/id6739359219).
+2. In the flow builder, click **Test on device**.
+
+<ZoomImage id="flow-test-on-device.webp" width="700px" alt="Test on device button in the flow builder" />
+
+3. Select the flow locale.
+4. Scan the QR code with the device camera or open the link. This opens your flow in the Adapty mobile app.
+
+:::note
+In the test mode, Adapty can't access your products in stores, so the prices displayed in the flow are not real.
+:::
+
+<ZoomImage id="flow-test-on-device-qr.webp" width="400px" alt="Locale selector and QR code in the Test on device dialog" />
+
+## Preview in the Adapty dashboard
+
 You can preview your flow on different screen types using the preview area in the flow builder. This helps ensure your flow looks great across various devices and screen sizes.
 
 Using the preview controls below the preview, you can:

src/content/docs/version-3.0/onesignal.mdx

@@ -56,9 +56,7 @@ Adapty SDK 3.15.7+ is required when building with Xcode 26.4 or later.
 
 [![Release](https://img.shields.io/github/v/release/adaptyteam/AdaptySDK-iOS.svg?style=flat&logo=apple)](https://github.com/adaptyteam/AdaptySDK-iOS/releases)
 
-<Tabs>
-<TabItem value="spm" label="Swift Package Manager (recommended)" default>
-In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps to add package dependencies may vary between Xcode versions, so refer to Xcode documentation if needed.
+Adapty SDK is installed via Swift Package Manager. In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps to add package dependencies may vary between Xcode versions, so refer to Xcode documentation if needed.
 
 1. Enter the repository URL:
    ```
@@ -76,36 +74,10 @@ In Xcode, go to **File** -> **Add Package Dependency...**. Note that the steps t
 4. Click **Add Package** to complete the installation.
 5. **Verify installation:** In your project navigator, you should see "Adapty" (and "AdaptyUI" if selected) under **Package Dependencies**.
 
-</TabItem>
-
-<TabItem value="cocoapods" label="CocoaPods (legacy)" default>
-
-:::info
-
-CocoaPods is now in maintenance mode, with development officially stopped. We recommend switching to [Swift Package Manager](sdk-installation-ios#install-adapty-sdk).
-
+:::important
+Adapty iOS SDK 4.0 is a pre-release. Swift Package Manager does not resolve beta versions through the **Up to Next Major Version** (`from:`) rule, so you must pin the exact version. In Xcode, set the **Dependency Rule** to **Exact Version** and enter `4.0.0-beta.1`. In `Package.swift`, use `.exact("4.0.0-beta.1")`. See [Migrate Adapty iOS SDK to v4](migration-to-ios-sdk-v4).
 :::
 
-1. Add Adapty to your `Podfile`. Choose the modules you need:
-
-    1. **Adapty** is the mandatory module.
-    2. **AdaptyUI** is an optional module you need if you plan to use the [Adapty Paywall Builder](adapty-paywall-builder).
-
-   ```shell showLineNumbers title="Podfile"
-   pod 'Adapty'
-   pod 'AdaptyUI'  # optional module needed only for Paywall Builder
-   ```
-
-2. Run:
-
-   ```sh showLineNumbers title="Shell"
-   pod install
-   ```
-
-This will create a `.xcworkspace` file for your app. Use this file for all future development.
-</TabItem>
-</Tabs>
-
 ## Activate Adapty module of Adapty SDK
 
 Activate the Adapty SDK in your app code.
@@ -401,38 +373,3 @@ targetSettings: [
   "AdaptyUIBuilder": .init().swiftVersion("6"),
 ]
 ```
-
-#### Swift 6 build errors caused by Podfile SWIFT_VERSION override
-
-When building for iOS with [CocoaPods](sdk-installation-ios#install-adapty-sdk), you may see Swift 6 compilation errors on Adapty pod targets. Typical symptoms include `@Sendable` mismatches in `AdaptyUIBuilderLogic`, missing `Sendable` conformance on Adapty types, or actor isolation errors.
-
-The Adapty pods declare `s.swift_version = '6.0'` and require Swift 6 to build. Your own app code can stay on Swift 5 — only the Adapty pod targets (`Adapty`, `AdaptyUI`, `AdaptyUIBuilder`, `AdaptyLogger`) need to build with Swift 6.
-
-The most common cause is a `post_install` hook in your `Podfile` that rewrites `SWIFT_VERSION` for every pod target:
-
-```ruby showLineNumbers title="Podfile"
-post_install do |installer|
-  installer.pods_project.targets.each do |target|
-    target.build_configurations.each do |config|
-      config.build_settings['SWIFT_VERSION'] = '5.9'
-    end
-  end
-end
-```
-
-**Fix**: Exclude the Adapty pod targets from the override:
-
-```ruby showLineNumbers title="Podfile"
-post_install do |installer|
-  installer.pods_project.targets.each do |target|
-    next if %w[Adapty AdaptyUI AdaptyUIBuilder AdaptyLogger].include?(target.name)
-    target.build_configurations.each do |config|
-      config.build_settings['SWIFT_VERSION'] = '5.9'
-    end
-  end
-end
-```
-
-Then run `pod install` and rebuild.
-
-To verify, open `Pods.xcodeproj`, select the `Adapty` pod target → **Build Settings** → **Swift Language Version**. It should be **Swift 6**.