Merge pull request #199 from mindbox-cloud/feature/MOBILE-146-SPM

MOBILE-146: SPM support and Example update

Author: justSmK

.github/workflows/manual-prepare_release_branch.yml

@@ -158,6 +158,9 @@ jobs:
           sed -i "s/cloud.mindbox:mobile-sdk:.*/cloud.mindbox:mobile-sdk:$AND_VER'/" mindbox_android/android/build.gradle
           echo "  After:"  && grep "cloud.mindbox:mobile-sdk" mindbox_android/android/build.gradle || true
 
+          # Fail the release if a version substitution didn't land (stale pin).
+          assert_pin() { grep -qE "$2" "$1" || { echo "ERROR: pattern /$2/ not found in $1 — substitution failed"; exit 1; }; }
+
           echo "→ Bumping iOS native SDK in podspec"
           echo "  Before s.version:" && grep -E "s\.version" mindbox_ios/ios/mindbox_ios.podspec || true
           sed -i -E "s/(s\.version *= *')[^']+(')/\1$IO_VER\2/" mindbox_ios/ios/mindbox_ios.podspec
@@ -166,10 +169,18 @@ jobs:
           echo "  Before Mindbox dependency:" && grep "s.dependency 'Mindbox'," mindbox_ios/ios/mindbox_ios.podspec || true
           sed -i -E "s/(s\.dependency 'Mindbox', *')[^']+(')/\1$IO_VER\2/" mindbox_ios/ios/mindbox_ios.podspec
           echo "  After Mindbox dependency:" && grep "s.dependency 'Mindbox'," mindbox_ios/ios/mindbox_ios.podspec || true
+          assert_pin mindbox_ios/ios/mindbox_ios.podspec "s\.dependency 'Mindbox', *'$IO_VER'"
 
           echo "  Before Notifications dep:" && grep "MindboxNotifications" mindbox_ios/ios/mindbox_ios.podspec || true
           sed -i -E "s/(s\.dependency 'MindboxNotifications', *')[^']+(')/\1$IO_VER\2/" mindbox_ios/ios/mindbox_ios.podspec
           echo "  After Notifications dep:" && grep "MindboxNotifications" mindbox_ios/ios/mindbox_ios.podspec || true
+          assert_pin mindbox_ios/ios/mindbox_ios.podspec "s\.dependency 'MindboxNotifications', *'$IO_VER'"
+
+          echo "→ Bumping ios-sdk exact pin in SPM manifest"
+          echo "  Before:" && grep "mindbox-cloud/ios-sdk" mindbox_ios/ios/mindbox_ios/Package.swift || true
+          sed -i "/mindbox-cloud\/ios-sdk/ s/exact: \"[^\"]*\"/exact: \"$IO_VER\"/" mindbox_ios/ios/mindbox_ios/Package.swift
+          echo "  After:"  && grep "mindbox-cloud/ios-sdk" mindbox_ios/ios/mindbox_ios/Package.swift || true
+          assert_pin mindbox_ios/ios/mindbox_ios/Package.swift "exact: *\"$IO_VER\""
 
           echo "→ Now inspect pubspec.yaml versions:"
           echo "  mindbox/pubspec.yaml:" && grep "^version\|mindbox_" mindbox/pubspec.yaml || true
@@ -207,7 +218,8 @@ jobs:
                   mindbox_ios/pubspec.yaml \
                   mindbox_platform_interface/pubspec.yaml \
                   mindbox_android/android/build.gradle \
-                  mindbox_ios/ios/mindbox_ios.podspec
+                  mindbox_ios/ios/mindbox_ios.podspec \
+                  mindbox_ios/ios/mindbox_ios/Package.swift
 
           git commit -m "Bump SDK versions: Flutter=$VERSION, Android=$AND_VER, iOS=$IO_VER"
           echo "release_branch=$REL" >> $GITHUB_OUTPUT

README.md

@@ -42,6 +42,13 @@ flow don't need any code changes.
 
 [flutter-uiscene]: https://docs.flutter.dev/release/breaking-changes/uiscenedelegate
 
+### iOS Swift Package Manager
+
+The plugin supports Swift Package Manager alongside CocoaPods. In SPM mode the
+main app gets Mindbox automatically; notification extensions need a one-time
+Xcode wiring step. See [SPM_MIGRATION.md](SPM_MIGRATION.md). CocoaPods users
+need no changes.
+
 ## Troubleshooting
 
 Refer to the [Example of integration(IOS)](https://github.com/mindbox-cloud/flutter-sdk/tree/develop/mindbox_ios/example) or [Example of integration(Android)](https://github.com/mindbox-cloud/flutter-sdk/tree/develop/mindbox_android/example) in case of any issues.

SPM_MIGRATION.md

@@ -0,0 +1,44 @@
+# Mindbox Flutter SDK with Swift Package Manager
+
+The plugin ships SPM alongside CocoaPods. **Flutter 3.44+ enables SPM by
+default** ([flutter#184495][spm-pr]); older releases need
+`flutter config --enable-swift-package-manager` (SPM needs Flutter ≥ 3.29; the
+per-project `config:` block in `pubspec.yaml` needs ≥ 3.35). The `Runner` gets
+`Mindbox` automatically through the plugin — only two Mindbox-specific steps are
+manual.
+
+> ⚠️ **Don't load Mindbox through both managers.** On 3.44+ SPM is on by default,
+> so leaving `pod 'Mindbox'` in your `Podfile` links Mindbox twice → launch
+> crash `Fatal error: ... Expected CDEvent but found CDEvent`. To stay on
+> CocoaPods, opt out: `enable-swift-package-manager: false` (pubspec) or
+> `flutter config --no-enable-swift-package-manager`.
+
+## 1. Notification extensions
+
+`Runner` project → **Package Dependencies** → **+** →
+`https://github.com/mindbox-cloud/ios-sdk`, rule **Up to Next Major** from your
+SDK version (e.g. `2.15.1` — a range, not "Exact"). Add the products:
+
+| Product | Add to target |
+|---|---|
+| `MindboxNotificationsService` | Notification **Service** Extension |
+| `MindboxNotificationsContent` | Notification **Content** Extension |
+| `Mindbox` | **None** — `Runner` already gets it via the plugin |
+
+## 2. Remove the Mindbox pods
+
+Delete `pod 'Mindbox'` (`Runner`) and `pod 'MindboxNotifications'` (each
+extension) from the `Podfile`, then `flutter run`. If every plugin you use
+supports SPM, drop CocoaPods entirely — delete the `Podfile` and
+`pod deintegrate` (see [`example/flutter_example`][example]).
+
+## Notes
+
+- ObjC `MindboxFlutterAppDelegateObjc` is CocoaPods-only and deprecated; SPM
+  apps use the Swift `MindboxFlutterAppDelegate`.
+- Project-level `ios-sdk` and the plugin's copy are the same package (same URL)
+  → one resolved version. Keep your range inclusive of the plugin's pin; don't
+  pin a different "Exact".
+
+[spm-pr]: https://github.com/flutter/flutter/pull/184495
+[example]: https://github.com/mindbox-cloud/flutter-sdk/tree/develop/example/flutter_example

example/flutter_example/.gitignore

@@ -33,6 +33,15 @@ migrate_working_dir/
 .pub/
 /build/
 
+# Local pub overrides (dev-only, wires example to local packages)
+pubspec_overrides.yaml
+
+# Xcode/Flutter SwiftPM workspace dir. Ignore the per-machine scratch
+# (configuration/) but COMMIT Package.resolved — this is an app, so its SPM
+# lockfile is checked in for reproducible native-SDK resolution.
+**/xcshareddata/swiftpm/*
+!**/xcshareddata/swiftpm/Package.resolved
+
 # Symbolication related
 app.*.symbols
 
@@ -47,9 +56,5 @@ app.*.map.json
 /android/app/google-services.json
 /android/app/agconnect-services.json
 
-# iOS
-/ios/Pods/
-/ios/Podfile.lock
-
 # FVM Version Cache
 .fvm/

example/flutter_example/ios/Flutter/Debug.xcconfig

@@ -1,2 +1 @@
-#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"
 #include "Generated.xcconfig"

example/flutter_example/ios/Flutter/Release.xcconfig

@@ -1,2 +1 @@
-#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig"
 #include "Generated.xcconfig"