Add Swift Package Manager (SPM) support for Flutter-SDK

.gitignore

@@ -10,3 +10,9 @@ example/pubspec.lock
 pubspec.lock
 example/android/app/property*
 
+# Local Claude Code settings
+.claude/settings.local.json
+
+# Generated SDK review reports
+sdk-review-*.html
+

doc/Integrate-iOS-SPM.md

@@ -0,0 +1,124 @@
+## 📦 iOS Integration via Swift Package Manager (SPM)
+
+Flutter introduced Swift Package Manager support as an **opt-in** feature in Flutter 3.24, and it became the **default** package manager in Flutter 3.44. The CleverTap Flutter plugin ships a `Package.swift` alongside its podspec, so both package managers resolve the same native SDK version (`CleverTap-iOS-SDK 7.7.1`).
+
+> **Minimum requirements for SPM integration**
+> - Flutter 3.24+ (opt-in) - enabled by default from Flutter 3.44
+> - Xcode 15+ (required for `swift-tools-version: 5.9`)
+> - iOS deployment target: 13.0+
+>
+> If you are on Flutter < 3.24, the plugin continues to work via CocoaPods - no action required.
+
+---
+
+### How it works
+
+The plugin ships a Swift package that pins `CleverTap-iOS-SDK 7.7.1`. When your app is built with SPM enabled, Flutter resolves it automatically - you don't add anything to your app's own `Package.swift` or edit any plugin files.
+
+---
+
+### Enabling SPM in your Flutter app
+
+SPM is opt-in on Flutter 3.24–3.43 (and on by default from 3.44). There is **no** `flutter run`/`flutter build` flag and **no** `Info.plist` key for this - you enable it through Flutter configuration.
+
+**Per project (recommended for testing)** - add to your app's `pubspec.yaml`:
+
+```yaml
+flutter:
+  config:
+    enable-swift-package-manager: true
+```
+
+**Globally for your machine:**
+
+```bash
+flutter config --enable-swift-package-manager
+```
+
+To turn it back off, use `enable-swift-package-manager: false` in `pubspec.yaml`, or `flutter config --no-enable-swift-package-manager` globally.
+
+---
+
+### Migrating an existing CocoaPods app to SPM
+
+Once SPM is enabled, Flutter migrates the Xcode project automatically the next time you build or run. To migrate cleanly on an app that already uses CocoaPods:
+
+**1. Enable SPM** (per-project block above, or global flag).
+
+**2. Clear the existing CocoaPods state** (run from your app root):
+
+```bash
+flutter clean
+cd ios
+rm -rf Pods Podfile.lock .symlinks build
+rm -rf ~/Library/Developer/Xcode/DerivedData/Runner-*
+cd ..
+```
+
+**3. Re-resolve and trigger the migration:**
+
+```bash
+flutter pub get
+flutter build ios --config-only   # or: flutter run
+```
+
+On this build Flutter adds a `FlutterGeneratedPluginSwiftPackage` to the Xcode project and resolves every plugin that ships a `Package.swift` (including `clevertap_plugin`) via SPM. Plugins that only ship a podspec stay on CocoaPods - a hybrid setup is expected.
+
+**4. Verify SPM took over.** Open `ios/Runner.xcworkspace` and confirm:
+- **Package Dependencies** lists `clevertap_plugin` and, transitively, `clevertap-ios-sdk` at `7.7.1`.
+- The regenerated `Podfile.lock` no longer contains a `clevertap_plugin` pod entry.
+
+**5. Build and run** on a simulator/device and smoke-test CleverTap initialization plus a `recordEvent` to confirm native symbols link.
+
+---
+
+### AppDelegate changes when using SPM
+
+When Flutter resolves the plugin via SPM, the module name changes. Use conditional imports in your `AppDelegate` to support both CocoaPods and SPM builds:
+
+**Objective-C**
+
+```objc
+#if __has_include(<CleverTapSDK/CleverTap.h>)
+#import <CleverTapSDK/CleverTap.h>
+#else
+#import "CleverTap.h"
+#endif
+
+#if __has_include(<clevertap_plugin/CleverTapPlugin.h>)
+#import <clevertap_plugin/CleverTapPlugin.h>
+#else
+#import "CleverTapPlugin.h"
+#endif
+```
+
+**Swift**
+
+```swift
+import CleverTapSDK
+import clevertap_plugin
+```
+
+These guards ensure your app compiles correctly regardless of which package manager resolved the dependency.
+
+---
+
+### CocoaPods vs SPM
+
+| | CocoaPods | SPM |
+|---|---|---|
+| SDK version pinned | `7.7.1` | `7.7.1` |
+| Deployment target | `13.0` | `13.0` |
+| Opt-in required | No | Yes on Flutter 3.24–3.43; default from 3.44 |
+
+Both package managers resolve the same CleverTap iOS SDK version to ensure no drift between the two integration paths.
+
+---
+
+### Troubleshooting
+
+- **Xcode doesn't resolve the package**: Run `flutter pub get`, then in Xcode go to **File → Packages → Resolve Package Versions**.
+- **Automatic migration didn't add the package**: In Xcode, add it manually - **Package Dependencies → Add Local…** → select `ios/Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage` and add it to the `Runner` target. Then under **Product → Scheme → Edit Scheme → Build → Pre-actions**, add a Run Script (with build settings from `Runner`): `"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" prepare`.
+- **Duplicate symbol errors**: Don't use both CocoaPods and SPM for the same plugin at once. If a `Podfile` exists and SPM is enabled, Flutter prefers SPM for plugins that support it.
+- **Build fails with missing headers**: Verify your deployment target is `13.0` or higher in both your Xcode project and `Podfile`/`Package.swift`.
+- **Stale CocoaPods references after migrating**: If the build still runs `[CP]` Pods build phases (or duplicate-embeds a framework) for a plugin that has moved to SPM, run `pod deintegrate` in your app's `ios/` directory, then `flutter clean && flutter build ios` so Flutter re-integrates cleanly. Use this only as a recovery step - it is not part of the normal migration flow. Flutter regenerates the CocoaPods integration on every build, so a manual `pod deintegrate` is otherwise undone on the next build.

example/ios/.gitignore

@@ -22,6 +22,7 @@ Flutter/app.flx
 Flutter/app.zip
 Flutter/flutter_assets/
 Flutter/flutter_export_environment.sh
+Flutter/ephemeral/
 ServiceDefinitions.json
 Runner/GeneratedPluginRegistrant.*
 

example/ios/Runner/AppDelegate.m

@@ -2,9 +2,18 @@
 #import "GeneratedPluginRegistrant.h"
 #import <UserNotifications/UserNotifications.h>
 
+#if __has_include(<CleverTapSDK/CleverTap.h>)
+#import <CleverTapSDK/CleverTap.h>
+#else
 #import "CleverTap.h"
+#endif
+#if __has_include(<clevertap_plugin/CleverTapPlugin.h>)
+#import <clevertap_plugin/CleverTapPlugin.h>
+#import <clevertap_plugin/CleverTapPluginCustomTemplates.h>
+#else
 #import "CleverTapPlugin.h"
 #import "CleverTapPluginCustomTemplates.h"
+#endif
 
 @implementation AppDelegate
 

ios/.gitignore

@@ -34,4 +34,6 @@ Icon?
 .tags*
 
 /Flutter/Generated.xcconfig
-/Flutter/flutter_export_environment.sh
+/Flutter/flutter_export_environment.sh
+
+.swiftpm/

ios/clevertap_plugin.podspec

@@ -10,10 +10,10 @@ Pod::Spec.new do |s|
   s.license                  = { :file => '../LICENSE' }
   s.author                   = { "CleverTap" => "http://www.clevertap.com" }
   s.source                   = { :path => '.' }
-  s.source_files             = 'Classes/**/*'
-  s.public_header_files      = 'Classes/**/*.h'
+  s.source_files             = 'clevertap_plugin/Sources/clevertap_plugin/**/*.{h,m}'
+  s.public_header_files      = 'clevertap_plugin/Sources/clevertap_plugin/include/clevertap_plugin/*.h'
   s.dependency               'Flutter'
   s.dependency               'CleverTap-iOS-SDK', '7.7.1'
-  s.ios.deployment_target    = '9.0'
+  s.ios.deployment_target    = '13.0'
 end
 

ios/clevertap_plugin/Package.swift

@@ -0,0 +1,30 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "clevertap_plugin",
+    platforms: [
+        .iOS("13.0")
+    ],
+    products: [
+        .library(name: "clevertap-plugin", targets: ["clevertap_plugin"])
+    ],
+    dependencies: [
+        .package(
+            url: "https://github.com/CleverTap/clevertap-ios-sdk",
+            exact: "7.7.1"
+        )
+    ],
+    targets: [
+        .target(
+            name: "clevertap_plugin",
+            dependencies: [
+                .product(name: "CleverTapSDK", package: "clevertap-ios-sdk")
+            ],
+            publicHeadersPath: "include/clevertap_plugin",
+            cSettings: [
+                .headerSearchPath("include/clevertap_plugin")
+            ]
+        )
+    ]
+)

ios/Classes/CleverTapPlugin.m → ios/clevertap_plugin/Sources/clevertap_plugin/CleverTapPlugin.m

@@ -1,21 +1,101 @@
 
+#if __has_include(<CleverTapSDK/CleverTap.h>)
+#import <CleverTapSDK/CleverTap.h>
+#else
 #import "CleverTap.h"
+#endif
+
 #import "CleverTapPlugin.h"
+
+#if __has_include(<CleverTapSDK/CleverTap+Inbox.h>)
+#import <CleverTapSDK/CleverTap+Inbox.h>
+#else
 #import "CleverTap+Inbox.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTapUTMDetail.h>)
+#import <CleverTapSDK/CleverTapUTMDetail.h>
+#else
 #import "CleverTapUTMDetail.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTapEventDetail.h>)
+#import <CleverTapSDK/CleverTapEventDetail.h>
+#else
 #import "CleverTapEventDetail.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTapSyncDelegate.h>)
+#import <CleverTapSDK/CleverTapSyncDelegate.h>
+#else
 #import "CleverTapSyncDelegate.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+DisplayUnit.h>)
+#import <CleverTapSDK/CleverTap+DisplayUnit.h>
+#else
 #import "CleverTap+DisplayUnit.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+FeatureFlags.h>)
+#import <CleverTapSDK/CleverTap+FeatureFlags.h>
+#else
 #import "CleverTap+FeatureFlags.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+ProductConfig.h>)
+#import <CleverTapSDK/CleverTap+ProductConfig.h>
+#else
 #import "CleverTap+ProductConfig.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTapPushNotificationDelegate.h>)
+#import <CleverTapSDK/CleverTapPushNotificationDelegate.h>
+#else
 #import "CleverTapPushNotificationDelegate.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTapInAppNotificationDelegate.h>)
+#import <CleverTapSDK/CleverTapInAppNotificationDelegate.h>
+#else
 #import "CleverTapInAppNotificationDelegate.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+InAppNotifications.h>)
+#import <CleverTapSDK/CleverTap+InAppNotifications.h>
+#else
 #import "CleverTap+InAppNotifications.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+PushPermission.h>)
+#import <CleverTapSDK/CleverTap+PushPermission.h>
+#else
 #import "CleverTap+PushPermission.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CTLocalInApp.h>)
+#import <CleverTapSDK/CTLocalInApp.h>
+#else
 #import "CTLocalInApp.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CleverTap+CTVar.h>)
+#import <CleverTapSDK/CleverTap+CTVar.h>
+#else
 #import "CleverTap+CTVar.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CTVar.h>)
+#import <CleverTapSDK/CTVar.h>
+#else
 #import "CTVar.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CTTemplateContext.h>)
+#import <CleverTapSDK/CTTemplateContext.h>
+#else
 #import "CTTemplateContext.h"
+#endif
 
 @interface CleverTapPlugin () <CleverTapSyncDelegate, CleverTapInAppNotificationDelegate, CleverTapDisplayUnitDelegate, CleverTapInboxViewControllerDelegate, CleverTapProductConfigDelegate, CleverTapFeatureFlagsDelegate, CleverTapPushNotificationDelegate, CleverTapPushPermissionDelegate>
 

ios/Classes/CleverTapPluginCustomTemplates.m → ios/clevertap_plugin/Sources/clevertap_plugin/CleverTapPluginCustomTemplates.m

@@ -9,8 +9,18 @@
 #import "CleverTapPluginCustomTemplates.h"
 #import "CleverTapPluginTemplatePresenter.h"
 #import "CleverTapPluginAppFunctionPresenter.h"
+
+#if __has_include(<CleverTapSDK/CTJsonTemplateProducer.h>)
+#import <CleverTapSDK/CTJsonTemplateProducer.h>
+#else
 #import "CTJsonTemplateProducer.h"
+#endif
+
+#if __has_include(<CleverTapSDK/CTCustomTemplatesManager.h>)
+#import <CleverTapSDK/CTCustomTemplatesManager.h>
+#else
 #import "CTCustomTemplatesManager.h"
+#endif
 
 @implementation CleverTapPluginCustomTemplates
 

pubspec.yaml

@@ -28,6 +28,7 @@ flutter:
         pluginClass: CleverTapPlugin
       ios:
         pluginClass: CleverTapPlugin
+        swiftPackageName: clevertap_plugin
       web:
         pluginClass: CleverTapPluginWeb
         fileName: clevertap_plugin_web.dart