Eliminates boilerplate code for sending analytics to multiple destinations using generated events from interface methods. Supports adapter skipping, parameter converters, and multimodule projects.
Trckr is Kotlin Symbol Processor to help you send analytics to multiple destinations (called adapters).
In a large project you can have multiple analytics targets that should receive events from your app. That creates a lot of boilerplate code to implement tracker that uses all analytics targets.
Trckr created to eliminate this problem. You need to create target adapters just once, and trckr generate events from interface methods for you.
To declare tracker you define interface, annotated with @Tracker annotation and event methods with @Event annotation:
@Tracker
interface ExampleTracker {
@Event(name = "Event name")
fun event(
@Param(name = "Parameter name") data: Int,
)
}
And create instance of tracker using generated method:
val tracker = createExampleTracker {
addAdapter(FirebaseAdapter())
addAdapter(AmplitudeAdapter())
addAdapter(AdjustAdapter())
}
tracker.event(data = 42)
After calling event method trckr sends it to all registered adapters.
flowchart TD;
E[ExampleTracker] --event--> A;
A[Trckr] --event--> B[Firebase] & C[Amplitude] & D[Adjust];
More you can find at advanced features page.
build.gradle.kts:plugins {
id("com.google.devtools.ksp") version "2.3.7"
}
Maven Central to the repositories blocks in your project's build.gradle.kts:repositories {
mavenCentral()
}
trckr dependencies:dependencies {
implementation("ru.cookedapp.trckr:trckr-core:${latestVersion}")
ksp("ru.cookedapp.trckr:trckr-processor:${latestVersion}")
}
To access generated code from KSP, you need to set up the source path into your module's build.gradle.kts file:
kotlin {
// ...
sourceSets.configureEach {
kotlin.srcDir(layout.buildDirectory.dir("/generated/ksp/$name/kotlin/"))
}
}
Copyright 2022 Dzmitry Pryskoka
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Surfaced from shared tags and platforms — no rankings paid for.