KarPropertyManager

Access data on android cars using modern Kotlin API.

Why KarPropertyManager?

This library is a Kotlin wrapper over default Java CarPropertyManager API.

CarPropertyManager is the official Google API to access car data via Vehicle Properties on any variant of Android Automotive OS (AAOS).

Why KarPropertyManager?

• Modern Kotlin API
• No need to manually manage Car object lifecycle
• Supports all Android versions starting from API level 30

Usage Example

val kpm = KarPropertyManager(context, scope)
kpm.startObservingCar()
val speedFlow = kpm.flowOfProperty<Float>(VehiclePropertyIds.PERF_VEHICLE_SPEED, 0, 0.5F)

Declare dependencies

Add to libs.versions.toml file:

[versions]
karPropertyManagerVersion = "0.2.0"

[libraries]
karpropertymanager = { group = "com.paradoxcat", name = "karpropertymanager", version.ref = "karPropertyManagerVersion" }

Add to build.gradle.kts:

implementation(libs.karpropertymanager)

Versioning

We use Semantic Versioning.

Permissions

Depending on the properties, different permissions may need to be obtained.

For standard Google Vehicle Properties, use documentation provided by google.

For VENDOR properties defined by OEMs, refer to their respective documentation.

License

See LICENSE file.

Where to get help

Please take a look at sample application to see a full working example.

For documentation, please refer to comment blocks in the methods you are using, we do not provide generated documentation.

If you are still facing issues, feel free to create an issue and label it appropriately.

Feedback

Got feedback? Let us discuss! Feel free to create a new discussion.

Contribution

Contributions are welcome, simply create a pull request.

Maintainers

Paradox Cat GmbH - https://paradoxcat.com