Skip to content

feat(mparticle-android-sdk): add Kochava Android SDK 7 kit (kochava-7) - #1014

Open
thomson-t wants to merge 1 commit into
mainfrom
feat/add-kochava-android-sdk-7-kit-kochava-7
Open

thomson-t wants to merge 1 commit into
mainfrom
feat/add-kochava-android-sdk-7-kit-kochava-7

Conversation

@thomson-t

Copy link
Copy Markdown
Contributor

Why

The Kochava kit builds only against Kochava Android SDK 5, two major versions behind 7.x. Kochava 7 renames com.kochava.tracker.Tracker to com.kochava.measurement.base.Measurement, removes the synchronous installAttribution getter, makes eventAutoSend a required argument of processDeeplink, moves install referrer, App Set ID and advertising ID collection into separate google and googletracking modules, and requires API 21, so kochava-5 can't move to it in place.

Programme

Kochava Android kit support for Kochava SDK 7.

What changes

  • Adds kits/kochava/kochava-7 and its Kotlin example app, copied from kochava-5, which is unchanged.
  • Replaces the five Kochava Tracker 5 dependencies with com.kochava.measurement:base, google and googletracking 7.0.0 from Maven Central, keeping version 5's install referrer and advertising ID collection.
  • Moves KochavaKit from Tracker to Measurement, always calls retrieveInstallAttribution, and passes eventAutoSend = true and kitManager.launchUri?.toString() to processDeeplink.
  • Raises minSdk from 16 to 21 in the kit and its example app.
  • Adds -keep class com.kochava.** { *; } to the kit's consumer ProGuard rules.
  • Updates the README for Install Referrer 2.2 and App Set ID, and adds migration notes for the deeplink event and attribution callback.
  • Registers the kit in kits/matrix.json, settings-kits.gradle and settings-kit-examples.gradle.

Linked work

  • Pairs with the mParticle/mparticle-apple-sdk Kochava 11 kits proposal.

Rollout

Ships in the next Android SDK release after merge to main as com.mparticle:kochava-7. Apps opt in by switching artifacts; kochava-5 users are unaffected. Revert the pull request to roll back.

Risks

  • Install Referrer 1.x is no longer supported -> Kochava 7 calls ReferrerDetails methods added in 2.0; the README requires 2.2.
  • Install attribution is reported on every kit start rather than only before the first fetch -> matches the Apple kit; the README migration notes say the attribution callback now fires on every app start.
  • Kochava now sends _Deeplink itself -> apps that also send it manually should drop theirs.
  • Change class: X2 (additive opt-in kit; existing kit untouched).

Who

Prepared by an automated coding agent and reviewed by the SDK team before merge.

Size

635 lines added and 0 removed across 21 files, mostly a verbatim copy of kochava-5, including 53 lines in one unit test file.

@thomson-t
thomson-t requested a review from a team as a code owner November 13, 2026 21:54
@thomson-t thomson-t added the promoted Opened from Rokt's internal review process label Nov 13, 2026 — with Rokt Releases
@github-actions

Copy link
Copy Markdown

Kotlin migration progress

No change to the Java left to convert.

Module Kotlin LOC Java LOC Java staying (facade) Java left to convert Kotlin share
android-core 9,661 16,341 9,716 6,625 37.2%
android-kit-base 601 5,405 1,651 3,754 10.0%
Total 10,262 21,746 11,367 10,379 32.1%

Conversion progress: 37.3% (10,379 of 16,550 baseline Java LOC left to convert). 93 Java files and 75 Kotlin files in scope.

@github-actions

Copy link
Copy Markdown

Binary compatibility

  • ✅ android-core is compatible with 6.1.10 (112 classes compared, 0 with additions only).
  • ✅ android-kit-base is compatible with 6.1.10 (37 classes compared, 0 with additions only).

Compares this branch with the last version published to Maven Central, both built without R8, over the public classes and members that release keeps under their own names. It also checks that this branch's release AAR still keeps them (see the script docstring). Full japicmp HTML/XML reports are attached as the api-compat-reports workflow artifact. This check is not in the required-check set yet, so a red result here does not block merging.

@github-actions

Copy link
Copy Markdown

📦 SDK Size Impact Report

What the SDK adds to a minified release APK.

mParticle Core SDK

Measured against an empty baseline app. Unlike the Rokt kit, android-core ships no Compose and no resources, so there is nothing here that a host app would already provide.

Metric Target branch This PR Change
APK size 121.84 KB 121.84 KB -3 bytes
Download size 119.66 KB 119.65 KB -3 bytes
Dex bytes 219.52 KB 219.52 KB 0 bytes

mParticle Core + Rokt kit

Measured against a Compose + Material3 reference app, so these are the costs on top of an app that already ships Compose. The reference app's dependencies are a documented convention, not a measured average: see size-report-rokt/README.md.

Metric Target branch This PR Change
APK size 1.26 MB 1.26 MB 0 bytes
Download size 1.25 MB 1.25 MB -1 bytes
Dex bytes 2.24 MB 2.24 MB 0 bytes

Rokt SDK+ umbrella (adds the payment extension)

Metric Target branch This PR Change On top of mParticle Core + Rokt kit
APK size 6.55 MB 6.55 MB 0 bytes +5.29 MB
Download size 6.43 MB 6.43 MB -5 bytes +5.19 MB
Dex bytes 7.13 MB 7.13 MB 0 bytes +4.89 MB

➡️ SDK size impact change is minimal.

Raw measurements

core, Target branch:

{"baseline_dex_bytes": 0, "baseline_download_bytes": 2508, "baseline_install_bytes": 7522, "core_dex_bytes": 224792, "core_download_bytes": 125035, "core_install_bytes": 132286}

core, This PR:

{"baseline_dex_bytes": 0, "baseline_download_bytes": 2512, "baseline_install_bytes": 7528, "core_dex_bytes": 224792, "core_download_bytes": 125036, "core_install_bytes": 132289}

rokt, Target branch:

{"baseline_dex_bytes": 1829108, "baseline_download_bytes": 1240062, "baseline_install_bytes": 1300934, "kit_dex_bytes": 4174368, "kit_download_bytes": 2549751, "kit_install_bytes": 2623275, "sdkplus_dex_bytes": 9300244, "sdkplus_download_bytes": 7987160, "sdkplus_install_bytes": 8165359}

rokt, This PR:

{"baseline_dex_bytes": 1829108, "baseline_download_bytes": 1240062, "baseline_install_bytes": 1300934, "kit_dex_bytes": 4174368, "kit_download_bytes": 2549750, "kit_install_bytes": 2623275, "sdkplus_dex_bytes": 9300244, "sdkplus_download_bytes": 7987155, "sdkplus_install_bytes": 8165359}

Measured 7ed5bd3 merged into 98d588f

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

promoted Opened from Rokt's internal review process

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant