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 zu com.google.android.libraries.mapsplatform.transportation.driver geändert. 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. In Driver SDK v4 initialisieren Sie das SDK so:

  1. Rufen Sie ein Navigator-Objekt von 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 Pflichtfelder 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 die *DriverApi zu initialisieren.

  4. Rufen Sie das NavigationVehicleReporter-Objekt vom API-Objekt ab. *VehicleReporter erweitert NavigationVehicleReporter.

Standortaktualisierungen aktivieren und deaktivieren

In früheren Versionen haben Sie Standortaktualisierungen aktiviert, nachdem Sie einen FleetEngine-Verweis abgerufen haben. In Driver SDK v4 aktivieren Sie Standortaktualisierungen so:

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

Error Reporting 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.
  }
}