# DriveKit 3.0 migration guide ## What's changed in v3.0? ### Introduction Version 3.0 of the DriveKit SDK contains breaking changes: all methods that were marked as deprecated during the past year have been permanently removed. This guide lists every removed element alongside its recommended replacement, organized by module. Following these steps will keep your integration stable and future-proof. {% hint style="info" %} This version also features a newly available callback to retrieve the beacon detected and confirmed during trip recording which will not be presented in this migration guide. {% endhint %} ### How to use this guide Each section maps to an SDK module. For every removed element, you'll find: * The exact method, class, or property that was removed * The recommended drop-in replacement to use instead ## Module-level reset() Methods The reset() method has been removed from every individual module. Use DriveKit.reset() as your single reset point across all modules. | Removed in v3.0 | What to do instead | | --------------------------------- | --------------------- | | DriveKitDriverData.reset() | Call DriveKit.reset() | | DriveKitChallenge.reset() | Call DriveKit.reset() | | DriveKitCoaching.reset() | Call DriveKit.reset() | | DriveKitDriverAchievement.reset() | Call DriveKit.reset() | | DriveKitGroup.reset() | Call DriveKit.reset() | | DriveKitTripAnalysis.reset() | Call DriveKit.reset() | | DriveKitVehicle.reset() | Call DriveKit.reset() | ## DriveKitTripAnalysis Several one-off methods have been merged into a single, structured call: `getCurrentTripInfo()`. This reduces the number of calls you need to make and gives you all the context about the current trip in one place. | Removed in v3.0 | What to do instead | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | | getCurrentStartMode(): StartMode? | getCurrentTripInfo() → access `startMode` | | getCurrentTripStartDate(): Date? | getCurrentTripInfo() → access `startDate` | | getLastTripPoint(): TripPoint? | getLastTripPointOfCurrentTrip() | | getTripResponseStatus(tripResponse:) | tripFinished(result: TripResult) - see [TripResult](https://docs.drivequant.com/trip-analysis/android/references#tripresult) | | isConfigured() | isInitialized property - direct boolean access | ### TripListener interface — Updated Methods & Types The TripListener interface has been redesigned for clarity. The new methods provide richer state objects, so you get more context with less code. #### Method Replacements | Removed in v3.0 | What to do instead | | -------------------------------------------------------------- | -------------------------------------------------------------- | | tripStarted(startMode: StartMode) | tripRecordingConfirmed(state: DKTripRecordingConfirmedState) | | tripCancelled(cancelTrip: CancelTrip) | tripRecordingCanceled(state: DKTripRecordingCanceledState) | | tripFinished(post: PostGeneric, response: PostGenericResponse) | tripFinished(responseStatus: TripResponseStatus) | | onDeviceConfigEvent(deviceConfigEvent: DeviceConfigEvent) | DKDeviceConfigurationListener - a dedicated listener interface | #### Removed Classes & Enums These types were part of the legacy event model and are no longer needed.
Removed typeWhat to do instead
DeviceConfigEvent (class)Handled by the new DKDeviceConfigurationListener
CancelTrip (enum)State now lives in DKTripRecordingCanceledState
PostGeneric (class)No longer needed internally
PostGenericResponse (class)Replaced by TripResult
RecorderState (class)Referenced CancelTrip - both are now gone
TripResponseStatus (class)Replaced by the cleaner TripResult
TripAnalysedReceiver (class)Use tripFinished() and tripRecordingCanceled() in TripListener instead
### TripNotification The following TripNotification parameters are no longer used by the SDK. Simply remove them from your notification configuration — no replacement needed. | Removed parameter | Action | | ---------------------------- | -------------------- | | gpsAccuracyContent | Remove the parameter | | gpsAccuracyButtonContent | Remove the parameter | | highSpeedTripDetectedContent | Remove the parameter | | noGpsIconId | Remove the parameter | ## DriveKitVehicle These method wrappers have been removed in favor of idiomatic Kotlin property and function access. | Removed in v3.0 | What to do instead | | ---------------------------------- | ------------------------------------------------------------ | | VehicleEngineIndex.getValue() | Use .value directly - e.g. VehicleEngineIndex.GASOLINE.value | | VehicleEngineIndex.getEnumByName() | Use VehicleEngineIndex.valueOf(name) | ## DriveKitDriverAchievement | Removed in v3.0 | What to do instead | | -------------------- | ------------------------------------------- | | RankingPeriod.LEGACY | No longer used - remove any reference to it |