Migrationsanleitung für Android Driver SDK 4.0

Für die Version 4.0 des Driver SDK for Android müssen Sie Ihren Code für bestimmte Vorgänge aktualisieren. In diesem Leitfaden werden die Änderungen und die erforderlichen Schritte zur Migration Ihres Codes beschrieben.

Änderung des Paketnamens

Der Paketname wurde von com.google.android.libraries.ridesharing.driver in com.google.android.libraries.mapsplatform.transportation.driver geändert. Bitte aktualisieren Sie die Verweise in Ihrem Code.

SDK initialisieren

In früheren Versionen haben Sie das Navigation SDK initialisiert und dann einen Verweis auf die Klasse FleetEngine abgerufen. Initialisieren Sie das SDK in Driver SDK v4 so:

  1. Rufen Sie ein Navigator-Objekt aus der NavigationApi ab.

    NavigationApi.getNavigator(
    this, // Activity
    new NavigationApi.NavigatorListener() {
      @Override
      public void onNavigatorReady(Navigator navigator) {
        // Keep a reference to the Navigator (used to configure and start nav)
        this.navigator = navigator;
      }
    }
);

  2. Erstellen Sie ein DriverContext-Objekt und füllen Sie die erforderlichen Felder aus.

    DriverContext driverContext = DriverContext.builder(application)
    .setProviderId(providerId)
    .setVehicleId(vehicleId)
    .setAuthTokenFactory(authTokenFactory)
    .setNavigator(navigator)
    .setRoadSnappedLocationProvider(
        NavigationApi.getRoadSnappedLocationProvider(application))
    .build();

  3. Verwenden Sie das Objekt DriverContext, um die *DriverApi zu initialisieren.

  4. Rufen Sie die NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter erweitert NavigationVehicleReporter.

Standort-Updates aktivieren und deaktivieren

In früheren Versionen haben Sie Standortupdates aktiviert, nachdem Sie eine FleetEngine-Referenz erhalten haben. In Version 4 des Driver SDK aktivieren Sie Standortaktualisierungen so:

Wenn die Schicht des Fahrers beendet ist, deaktivieren Sie die Standortaktualisierungen und markieren Sie das Fahrzeug als offline, indem Sie NavigationVehicleReporter.disableLocationTracking() aufrufen.

Error Reporting mit StatusListener

ErrorListener wurde entfernt und mit StatusListener kombiniert, was so definiert werden kann:

class MyStatusListener implements StatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
      StatusLevel statusLevel, StatusCode statusCode, String statusMsg) {
    // Status handling stuff goes here.
    // StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
    // StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND,
    // BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
  }
}