[DELIVERY-125863] Migrate Flutter plugin to AppsFlyer SDK 7 RPC architecture.

.claude/skills/alice-pm/SKILL.md

@@ -322,7 +322,7 @@ Automated via GitHub Actions: `.github/workflows/rc-release.yml`, `rc-smoke.yml`
 
 ## Domain-Specific Notes
 
-- Cross-platform parity: any new public Dart API must map to matching method names/behavior in both `AppsflyerSdkPlugin.java` (Android) and `AppsflyerSdkPlugin.m` (iOS) — flag any PRD that only specifies one platform.
+- Cross-platform parity: any new public Dart API must map to matching method names/behavior in both `AppsflyerSdkPlugin.kt` (Android) and `AppsflyerSdkPlugin.swift` (iOS) — flag any PRD that only specifies one platform.
 - This is a published pub.dev package (`appsflyer_sdk`) consumed by third-party apps — breaking changes to the public Dart API require a major version bump and migration notes in `CHANGELOG.md`.
 - Purchase Connector is optional/self-contained (`lib/src/purchase_connector/`, `ios/PurchaseConnector/`, Android Kotlin) — changes there should not affect core SDK consumers who don't opt in.
 - Release goes through the RC pipeline (see Release Process above) — any feature landing near a release cut should account for RC-SMOKE validation.

.claude/skills/dave-flutter-engineer/SKILL.md

@@ -7,7 +7,7 @@ description: Use when working on AppsFlyer Flutter Plugin code — writing, revi
 
 ## Persona
 
-Senior engineer with deep knowledge of AppsFlyer Flutter Plugin. Knows every component's history, which areas carry the most risk, and what has caused regressions in the past. Tech stack: Dart/Flutter plugin (SDK >=2.17.0 <4.0.0, Flutter >=1.10.0) bridging native AppsFlyer SDKs via MethodChannel/EventChannel — Objective-C on iOS (`ios/Classes/`), Java/Kotlin on Android (`android/src/main/java` + `android/src/main/kotlin` for the Purchase Connector). JSON models via `json_annotation`/`json_serializable` + `build_runner`. Testing via `mockito` + `flutter_lints`..
+Senior engineer with deep knowledge of AppsFlyer Flutter Plugin. Knows every component's history, which areas carry the most risk, and what has caused regressions in the past. Tech stack: Dart/Flutter plugin (SDK >=2.17.0 <4.0.0, Flutter >=1.10.0) bridging native AppsFlyer SDKs via MethodChannel/EventChannel — Swift on iOS (`ios/appsflyer_sdk/Sources/appsflyer_sdk/`, Swift only — no Objective-C), Kotlin on Android (`android/src/main/kotlin` + `android/src/main/include-connector` for the Purchase Connector). JSON models via `json_annotation`/`json_serializable` + `build_runner`. Testing via `mockito` + `flutter_lints`..
 
 ## PRD Gate — BLOCKING REQUIREMENT
 
@@ -165,7 +165,7 @@ BLOCKING REQUIREMENT: Include a `Skill('dave-flutter-engineer')` tool call in th
 ## Domain-Specific Notes
 
 - Keep `AppsflyerSdk` as a singleton — do not change the instantiation pattern.
-- New SDK method: add Dart method in `lib/src/appsflyer_sdk.dart` (invoke via `_channel.invokeMethod`), implement in `AppsflyerSdkPlugin.java` (Android) and `AppsflyerSdkPlugin.m` (iOS). Keep the method name string identical across all three files.
+- New SDK method: add Dart method in `lib/src/appsflyer_sdk.dart` (invoke via `_channel.invokeMethod`), implement in `AppsflyerSdkPlugin.kt` (Android) and `AppsflyerSdkPlugin.swift` (iOS). Keep the method name string identical across all three files.
 - Callbacks from native → Dart flow through EventChannels defined in `lib/src/callbacks.dart`.
 - Deep linking (UDL) logic is isolated in `lib/src/udl/` — do not mix with core SDK channel calls.
 - Purchase Connector is self-contained in `lib/src/purchase_connector/` (Dart models) and `ios/PurchaseConnector/` / `android/.../kotlin/` (native) — keep it that way.

.claude/skills/erin-flutter-analyst/SKILL.md

@@ -95,5 +95,5 @@ After Erin presents any analysis findings, `alice-pm` is invoked automatically.
 
 - Field maps live at the MethodChannel/EventChannel boundary — arguments passed as `Map<String, dynamic>` between Dart and native.
 - JSON-serializable Dart models: `lib/src/purchase_connector/` (in-app purchase validation payloads) — regenerate `.g.dart` via `build_runner` after any field change.
-- Attribution/conversion data payloads flow through `lib/src/callbacks.dart` — check both the Dart model and the native (Java/ObjC) side that populates the EventChannel data.
+- Attribution/conversion data payloads flow through `lib/src/callbacks.dart` — check both the Dart model and the native (Kotlin/Swift) side that populates the EventChannel data.
 - When mapping fields, verify parity between what Android and iOS native code send — historically a source of drift.

.github/workflows/ios-e2e.yml

@@ -120,6 +120,10 @@ jobs:
         working-directory: example
         run: flutter pub get
 
+      - name: Regenerate iOS project configuration
+        working-directory: example
+        run: flutter build ios --config-only
+
       - name: Install CocoaPods
         working-directory: example/ios
         run: pod install

.github/workflows/lint-test-build.yml

@@ -9,10 +9,16 @@
 #
 # What it does:
 # 1. Lints + format-checks + runs Dart/Flutter unit tests with coverage.
-# 2. Builds Android example app (release App Bundle).
-# 3. Builds iOS example app (no-codesign release IPA).
+# 2. Runs the Android native (JVM) unit tests, then builds the Android example
+#    app (release App Bundle).
+# 3. Builds the iOS example app (no-codesign release IPA).
 # 4. Caches dependencies for faster subsequent runs.
 #
+# Note on native tests: the Android JVM tests live in the Android job rather
+# than the Dart `test` job because they need that job's toolchain (Android SDK
+# plus JDK for Gradle), so running them there reuses a setup the job already
+# pays for. The iOS XCTest suite is not run in CI — see the Job 3 header.
+#
 # Note on debug builds: debug-mode Android APK and iOS simulator builds used
 # to live here, but they duplicate exactly what ios-e2e.yml / android-e2e.yml
 # do before running scenarios. Release-mode builds remain here because E2E
@@ -166,9 +172,10 @@ jobs:
           fail_ci_if_error: false  # Don't fail CI if coverage upload fails
 
   # ===========================================================================
-  # Job 2: Build Android Example App
+  # Job 2: Android Native Tests + Build Example App
   # ===========================================================================
-  # Builds the example app for Android to ensure plugin integration works
+  # Runs the plugin's Android JVM unit tests, then builds the example app to
+  # ensure plugin integration works
   # Uses: Ubuntu runner with Java 17
   # ===========================================================================
 
@@ -226,7 +233,39 @@ jobs:
           echo "DEV_KEY=dummy_dev_key" > .env
           echo "APP_ID=dummy_app_id" >> .env
 
-      # Step 8: Build Android App Bundle (release mode, no signing)
+      # Step 8: Materialize the Gradle wrapper
+      # `example/android/gradlew` and `gradle-wrapper.jar` are gitignored (the
+      # standard `flutter create` .gitignore), so a fresh checkout has neither
+      # and `flutter pub get` does not create them — it only writes
+      # local.properties. The wrapper is injected by the Flutter tool the first
+      # time it needs to invoke Gradle, and `--config-only` stops right after
+      # that injection, so this costs a couple of seconds instead of a build.
+      - name: Prepare Gradle wrapper
+        working-directory: example
+        run: flutter build apk --config-only
+
+      # Step 9: Run the plugin's Android JVM unit tests
+      # The plugin is included in the example's Gradle build as `:appsflyer_sdk`
+      # by the Flutter plugin loader, so this runs from example/android. Placed
+      # ahead of the release build: it is the faster of the two and covers the
+      # engine-lifecycle logic (AppsFlyerEventBus, AppsFlyerRpcBridge) that an
+      # appbundle build cannot exercise.
+      - name: Run Android native unit tests
+        working-directory: example/android
+        run: ./gradlew :appsflyer_sdk:testDebugUnitTest --console=plain
+
+      # Step 10: Publish the Gradle test report when the tests fail
+      - name: Upload Android test report
+        if: failure()
+        uses: actions/upload-artifact@v5
+        with:
+          name: android-native-test-report
+          path: |
+            example/build/appsflyer_sdk/reports/tests/testDebugUnitTest
+            example/build/appsflyer_sdk/test-results/testDebugUnitTest
+          retention-days: 7
+
+      # Step 11: Build Android App Bundle (release mode, no signing)
       # App Bundle is the preferred format for Play Store. Catches R8/proguard
       # regressions a debug APK won't. Debug APK builds were removed because
       # android-e2e.yml already builds and runs `flutter build apk --debug`
@@ -235,7 +274,7 @@ jobs:
         working-directory: example
         run: flutter build appbundle --release
 
-      # Step 9: Upload App Bundle artifact (optional)
+      # Step 12: Upload App Bundle artifact (optional)
       # Useful for manual install testing and archiving release-mode output.
       - name: Upload App Bundle artifact
         if: success()
@@ -248,7 +287,14 @@ jobs:
   # ===========================================================================
   # Job 3: Build iOS Example App
   # ===========================================================================
-  # Builds the example app for iOS to ensure plugin integration works
+  # Builds the example app to ensure plugin integration works
+  #
+  # The plugin's XCTest suite is deliberately not run here. It covers Foundation
+  # behavior rather than plugin code (`RunnerTests` re-implements the function
+  # under test instead of importing it), so a simulator boot and a second, debug
+  # build of the app would buy no coverage on a runner that bills at 10x. Wire
+  # it in once there are XCTests that exercise `AppsflyerSdkPlugin` /
+  # `AFRPCBridge` directly.
   # Uses: macOS runner (required for Xcode and iOS builds)
   # Note: macOS runners consume 10x minutes on private repos
   # ===========================================================================
@@ -291,26 +337,31 @@ jobs:
         working-directory: example
         run: flutter pub get
 
-      # Step 6: Update CocoaPods repo (ensures latest pod specs)
+      # Step 6: Regenerate iOS build settings (Flutter.podspec deployment target, etc.)
+      - name: Regenerate iOS project configuration
+        working-directory: example
+        run: flutter build ios --config-only
+
+      # Step 7: Update CocoaPods repo (ensures latest pod specs)
       # This can be slow, so we only update if needed
       - name: Update CocoaPods repo
         working-directory: example/ios
         run: pod repo update
 
-      # Step 7: Install CocoaPods dependencies
+      # Step 8: Install CocoaPods dependencies
       # This installs native iOS dependencies including AppsFlyer SDK
       - name: Install CocoaPods dependencies
         working-directory: example/ios
         run: pod install
 
-      # Step 8: Create dummy .env file for CI (not committed to repo)
+      # Step 9: Create dummy .env file for CI (not committed to repo)
       - name: Create dummy .env for CI build
         working-directory: example
         run: |
           echo "DEV_KEY=dummy_dev_key" > .env
           echo "APP_ID=dummy_app_id" >> .env
 
-      # Step 9: Build iOS IPA without code signing (release mode)
+      # Step 10: Build iOS IPA without code signing (release mode)
       # Validates a full release build without requiring certificates. Catches
       # archive bundling and signing-config issues a simulator-debug build
       # won't. The simulator-debug build that used to live here was dropped
@@ -320,7 +371,7 @@ jobs:
         working-directory: example
         run: flutter build ipa --release --no-codesign
 
-      # Step 10: Upload build artifacts (optional)
+      # Step 11: Upload build artifacts (optional)
       - name: Upload iOS build artifact
         if: success()
         uses: actions/upload-artifact@v5
@@ -347,9 +398,9 @@ jobs:
           echo "==================================="
           echo "Lint, Test & Build summary"
           echo "==================================="
-          echo "Test Job:      ${{ needs.test.result }}"
-          echo "Android Build: ${{ needs.build-android.result }}"
-          echo "iOS Build:     ${{ needs.build-ios.result }}"
+          echo "Dart unit/lint:              ${{ needs.test.result }}"
+          echo "Android native tests + build: ${{ needs.build-android.result }}"
+          echo "iOS build:                    ${{ needs.build-ios.result }}"
           echo "==================================="
 
           # 'skipped' is acceptable for any of the three jobs (skip_unit=true
@@ -365,7 +416,7 @@ jobs:
             exit 1
           fi
           if [[ "$android_result" != "success" && "$android_result" != "skipped" ]]; then
-            echo "❌ Android release build failed"
+            echo "❌ Android native tests or release build failed"
             exit 1
           fi
           if [[ "$ios_result" != "success" && "$ios_result" != "skipped" ]]; then

.github/workflows/production-release.yml

@@ -405,9 +405,11 @@ jobs:
 
           ## 📚 Documentation
 
-          - [Installation Guide](https://github.com/${{ github.repository }}/blob/master/doc/Installation.md)
-          - [Basic Integration](https://github.com/${{ github.repository }}/blob/master/doc/BasicIntegration.md)
-          - [API Documentation](https://github.com/${{ github.repository }}/blob/master/doc/API.md)
+          - [Documentation index](https://github.com/${{ github.repository }}/blob/master/doc/README.md)
+          - [Installation](https://github.com/${{ github.repository }}/blob/master/doc/installation-guide.md)
+          - [Getting started](https://github.com/${{ github.repository }}/blob/master/doc/getting-started.md)
+          - [API reference](https://github.com/${{ github.repository }}/blob/master/doc/api-reference.md)
+          - [Migrating v6 → v7](https://github.com/${{ github.repository }}/blob/master/doc/migration-guide.md)
           - [Sample App](https://github.com/${{ github.repository }}/tree/master/example)
 
           ## 🔗 Links

.github/workflows/promote-release.yml

@@ -134,8 +134,8 @@ jobs:
           VERSION='${{ steps.compute-version.outputs.version }}'
           echo "Updating PLUGIN_VERSION constants to: $VERSION"
 
-          # Android - AppsFlyerConstants.java
-          ANDROID_FILE="android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java"
+          # Android - AppsFlyerConstants.kt
+          ANDROID_FILE="android/src/main/kotlin/com/appsflyer/appsflyersdk/AppsFlyerConstants.kt"
           if [ -f "$ANDROID_FILE" ]; then
             sed -i "s/PLUGIN_VERSION = \".*\"/PLUGIN_VERSION = \"$VERSION\"/" "$ANDROID_FILE"
             echo "✅ Android:" && grep "PLUGIN_VERSION" "$ANDROID_FILE"
@@ -148,11 +148,14 @@ jobs:
             echo "✅ Dart:" && grep "PLUGIN_VERSION" "$DART_FILE"
           fi
 
-          # iOS - AppsflyerSdkPlugin.h (#define)
-          IOS_FILE="ios/Classes/AppsflyerSdkPlugin.h"
+          # iOS - AppsflyerSdkPlugin.swift
+          IOS_FILE="ios/appsflyer_sdk/Sources/appsflyer_sdk/AppsflyerSdkPlugin.swift"
           if [ -f "$IOS_FILE" ]; then
-            sed -i 's/kAppsFlyerPluginVersion[[:space:]]*@"[^"]*"/kAppsFlyerPluginVersion             @"'"$VERSION"'"/' "$IOS_FILE"
+            sed -i "s/kAppsFlyerPluginVersion = \".*\"/kAppsFlyerPluginVersion = \"$VERSION\"/" "$IOS_FILE"
             echo "✅ iOS:" && grep "kAppsFlyerPluginVersion" "$IOS_FILE"
+          else
+            echo "::error::iOS plugin version file not found: $IOS_FILE" >&2
+            exit 1
           fi
 
       - name: Commit and push version changes

.github/workflows/rc-release.yml

@@ -318,8 +318,8 @@ jobs:
           VERSION='${{ needs.validate-release.outputs.version }}'
           echo "Updating PLUGIN_VERSION constants to: $VERSION"
 
-          # Android - AppsFlyerConstants.java
-          ANDROID_FILE="android/src/main/java/com/appsflyer/appsflyersdk/AppsFlyerConstants.java"
+          # Android - AppsFlyerConstants.kt
+          ANDROID_FILE="android/src/main/kotlin/com/appsflyer/appsflyersdk/AppsFlyerConstants.kt"
           if [ -f "$ANDROID_FILE" ]; then
             sed -i.bak "s/PLUGIN_VERSION = \".*\"/PLUGIN_VERSION = \"$VERSION\"/" "$ANDROID_FILE"
             rm "$ANDROID_FILE.bak"
@@ -334,12 +334,15 @@ jobs:
             echo "✅ Dart:" && grep "PLUGIN_VERSION" "$DART_FILE"
           fi
 
-          # iOS - AppsflyerSdkPlugin.h (#define)
-          IOS_FILE="ios/Classes/AppsflyerSdkPlugin.h"
+          # iOS - AppsflyerSdkPlugin.swift
+          IOS_FILE="ios/appsflyer_sdk/Sources/appsflyer_sdk/AppsflyerSdkPlugin.swift"
           if [ -f "$IOS_FILE" ]; then
-            sed -i.bak 's/kAppsFlyerPluginVersion[[:space:]]*@"[^"]*"/kAppsFlyerPluginVersion             @"'"$VERSION"'"/' "$IOS_FILE"
+            sed -i.bak "s/kAppsFlyerPluginVersion = \".*\"/kAppsFlyerPluginVersion = \"$VERSION\"/" "$IOS_FILE"
             rm "$IOS_FILE.bak"
             echo "✅ iOS:" && grep "kAppsFlyerPluginVersion" "$IOS_FILE"
+          else
+            echo "::error::iOS plugin version file not found: $IOS_FILE" >&2
+            exit 1
           fi
 
       - name: Update README SDK and Purchase Connector versions

.pubignore

@@ -7,7 +7,15 @@ package.json
 package-lock.json
 node_modules/
 local.properties
+build/
+coverage/
+.githooks/
 .cursor/
+.claude/
+CLAUDE.md
+ai-delivery-workflow-templat/
+internal-docs/
+output.af-quiz-me/
 
 # Example app files that shouldn't be in package
 example/.env
@@ -20,7 +28,6 @@ example/android/local.properties
 
 # CI/CD files
 .github/
-.travis.yml
 
 # RC pipeline scaffolding (never part of the pub.dev artifact)
 example_rc_smoke/