Get started

Prerequisite

Before starting DriveKit Trip Analysis UI integration, make sure that you have initialized TripAnalysis and CommonUI modules, especially if you have disabled the SDK auto-initialization.

Integration

The Trip Analysis UI module is available on Swift Package Manager and Cocoapods master repo.

On this Github repository, you also have a demo app and source code of Driver Data UI that you can use as an example.

Swift Package Manager

Via Xcode:

• In Xcode, add the DriveKitUI SDK by navigating to File > Add Package Dependencies...

• In the prompt that appears, enter the DriveKitUI repository: https://github.com/DriveQuantPublic/drivekit-ui-ios.git

• Include DriveKitTripAnalysisUI in your app.

Via Package.swift:

• To integrate DriveKitUI to a Swift package via a Package.swift file, you can add DriveKitUI to the dependencies array of your package. For more details, see the Swift Package Manager documentation.

dependencies: [
  .package(name: "DriveKitUI",
           url: "https://github.com/DriveQuantPublic/drivekit-ui-ios.git",
           from: "2.0.0"),
  // ...
],

• Then in your target, add DriveKitTripAnalysisUI to the dependencies array of that target:

.target(
  name: "MyTarget",
  dependencies: [
    .product(name: "DriveKitTripAnalysisUI", package: "DriveKitUI"),
    // ...
  ]
),

Cocoapods (deprecation scheduled for the end of 2025)

To add TripAnalysisUI module, add the following line to your Podfile:

Podfile

target 'my-target' do
  pod 'DriveKitTripAnalysisUI'
end

Then, run pod install.

Initialization

If you have disabled the SDK auto-initialization, the Trip Analysis UI module must also be manually initialized. In the application's AppDelegate file, import DriveKitTripAnalysisUI:

import DriveKitTripAnalysisUI

Then, to initialize Trip Analysis UI SDK in your app, you must call the initialization method in didFinishLaunchingWithOptions method of your AppDelegate:

AppDelegate.swift

import DriveKitCoreModule
import DriveKitCommonUI
import DriveKitTripAnalysisModule
import DriveKitTripAnalysisUI

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    DriveKit.shared.initialize()
    DriveKitTripAnalysis.shared.initialize(appLaunchOptions: launchOptions)
    DriveKitUI.shared.initialize()
    DriveKitTripAnalysisUI.shared.initialize()
    ...    
}