Guida alla migrazione dell'SDK Android Driver 4.0

La release Driver SDK for Android 4.0 richiede l'aggiornamento del codice per alcune operazioni. Questa guida illustra le modifiche e cosa devi fare per eseguire la migrazione del codice.

Per il modello di conducente untrusted, i client di consegna devono eseguire l'autenticazione solo per il tipo di servizio VEHICLE, che consente la segnalazione della posizione. I client con un modello di conducente attendibile devono fornire l'autenticazione per il tipo di servizio TASK per abilitare i metodi di segnalazione dei veicoli per l'arresto del veicolo in DeliveryVehicleReporter.

Modifica del nome del pacchetto

Il nome del pacchetto è cambiato da com.google.android.libraries.ridesharing.driver a com.google.android.libraries.mapsplatform.transportation.driver. Aggiorna i riferimenti nel codice.

Inizializzazione dell'SDK

Nelle versioni precedenti, dovevi inizializzare l'SDK di navigazione e quindi ottenere un riferimento alla classe FleetEngine. In Driver SDK v4, inizializza l'SDK come segue:

1. Ottieni un oggetto Navigator da NavigationApi.

   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. Crea un oggetto DriverContext, compilando i campi obbligatori.

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

3. Usa l'oggetto DriverContext per inizializzare *DriverApi.

   DeliveryDriverApi deliveryDriverApi = DeliveryDriverApi.createInstance(driverContext);
   

4. Ottieni NavigationVehicleReporter dall'oggetto API. *VehicleReporter estende NavigationVehicleReporter.

   DeliveryVehicleReporter vehicleReporter = deliveryDriverApi.getDeliveryVehicleReporter();
   

Attivazione e disattivazione degli aggiornamenti della posizione

Nelle versioni precedenti, dovevi abilitare gli aggiornamenti della località dopo aver ottenuto un riferimento FleetEngine. In Driver SDK v4, attiva gli aggiornamenti delle posizioni come segue:

DeliveryVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Per aggiornare l'intervallo di report, utilizza DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit).

Quando il turno del conducente è terminato, disattiva gli aggiornamenti di posizione e contrassegna il veicolo come offline chiamando il numero NavigationVehicleReporter.disableLocationTracking().

Error Reporting con StatusListener

ErrorListener è stato rimosso e combinato con StatusListener, che potrebbe essere definito come segue:

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

Autenticazione con AuthTokenFactory

AuthTokenFactory ora ha un solo metodo, getToken(), che utilizza AuthTokenContext come parametro.

class JsonAuthTokenFactory implements AuthTokenFactory {
  // Initially null.
  private String vehicleServiceToken;
  // Initially null. Only used in the trusted driver model to authenticate
  // vehicle-stop reporting.
  private String taskServiceToken;
  private long expiryTimeMs = 0;

  // This method is called on a thread that only sends location updates (and
  // vehicle stop updates if you choose to report them). Blocking is OK, but just
  // know that no updates can occur until this method returns.
  @Override
  public String getToken(AuthTokenContext authTokenContext) {
    if (System.currentTimeMillis() > expiryTimeMs) {
      // The token has expired, go get a new one.
      fetchNewToken(vehicleId);
    }
    if (ServiceType.VEHICLE.equals(authTokenContext.getServiceType())) {
      return vehicleServiceToken;
    } else if (ServiceType.TASK.equals(authTokenContext.getServiceType())) {
      // Only used for the trusted driver model to access vehicle-stop reporting
      // methods in DeliveryVehicleReporter.
      return taskServiceToken;
    } else {
      throw new RuntimeException("Unsupported ServiceType: " + authTokenContext.getServiceType());
    }
  }

  private void fetchNewToken(String vehicleId) {
    String url = "https://yourauthserver.example/token/" + vehicleId;

    try (Reader r = new InputStreamReader(new URL(url).openStream())) {
      com.google.gson.JsonObject obj
          = com.google.gson.JsonParser.parseReader(r).getAsJsonObject();
      vehicleServiceToken = obj.get("VehicleServiceToken").getAsString();
      taskServiceToken = obj.get("TaskServiceToken").getAsString();
      expiryTimeMs = obj.get("TokenExpiryMs").getAsLong();

      // The expiry time could be an hour from now, but just to try and avoid
      // passing expired tokens, we subtract 10 minutes from that time.
      expiryTimeMs -= 10 * 60 * 1000;
    } catch (IOException e) {
      // It's OK to throw exceptions here. The StatusListener you passed to
      // create the DriverContext class will be notified and passed along the failed
      // update warning.
      throw new RuntimeException("Could not get auth token", e);
    }
  }
}

L'elenco Task diventa elenco TaskInfo

L'elenco Task è stato sostituito con TaskInfo in VehicleStop. Il seguente esempio di codice mostra come creare un oggetto VehicleStop.

VehicleStop vehicleStop = VehicleStop.builder()
    .setTaskInfoList(taskInfoList)
    .setWaypoint(waypoint)
    .setVehicleStopState(vehicleStopState)
    .build();