Migrationsanleitung für Android Driver SDK 4.0

Für die Veröffentlichung des Driver SDK for Android 4.0 müssen Sie Ihren Code für bestimmte Vorgänge aktualisieren. In diesem Leitfaden werden die Änderungen beschrieben und es wird erläutert, was Sie tun müssen, um Ihren Code zu migrieren.

Ä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 eine Referenz auf die Klasse FleetEngine abgerufen. In Driver SDK v4 initialisieren Sie das SDK so:

  1. Rufen Sie ein Navigator-Objekt aus dem 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 DriverContext-Objekt, um *DriverApi zu initialisieren.

  4. Rufen Sie NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter verlängert NavigationVehicleReporter.

Standortaktualisierungen aktivieren und deaktivieren

In früheren Versionen haben Sie Standortaktualisierungen aktiviert, nachdem Sie eine FleetEngine-Referenz erhalten haben. Aktivieren Sie in Driver SDK v4 Standortaktualisierungen so:

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

Fehlerberichte mit StatusListener

ErrorListener wurde entfernt und mit StatusListener kombiniert, das 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.
  }
}