دليل نقل بيانات Android Driver SDK 4.0

يتطلّب إصدار Driver SDK لنظام التشغيل Android 4.0 تعديل الرمز البرمجي لإجراء عمليات معيّنة. يوضّح هذا الدليل التغييرات والإجراءات التي عليك اتّخاذها لنقل الرمز.

تغيير اسم الحزمة

تم تغيير اسم الحزمة من com.google.android.libraries.ridesharing.driver إلى com.google.android.libraries.mapsplatform.transportation.driver. يُرجى تعديل المراجع في الرمز.

بدء حزمة تطوير البرامج (SDK)

في الإصدارات السابقة، كان عليك إعداد Navigation SDK ثم الحصول على مرجع إلى الفئة FleetEngine. في الإصدار 4 من Driver SDK، يمكنك إعداد حزمة SDK على النحو التالي:

1. احصل على عنصر Navigator من 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. أنشئ عنصر DriverContext، واملأ الحقول المطلوبة.

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

3. استخدِم العنصر DriverContext لتهيئة *DriverApi.

4. احصل على NavigationVehicleReporter من عنصر واجهة برمجة التطبيقات. *VehicleReporter يمتد إلى NavigationVehicleReporter.

تفعيل ميزة تعديل الموقع الجغرافي وإيقافها

في الإصدارات السابقة، كان عليك تفعيل تعديلات الموقع الجغرافي بعد الحصول على مرجع FleetEngine. في الإصدار 4 من Driver SDK، فعِّل إشعارات التحديث بشأن الموقع الجغرافي باتّباع الخطوات التالية:

عند انتهاء وردية السائق، أوقِف تعديل الموقع الجغرافي وصنِّف المركبة على أنّها غير متصلة بالإنترنت من خلال الاتصال بـ NavigationVehicleReporter.disableLocationTracking().

الإبلاغ عن الأخطاء باستخدام StatusListener

تمت إزالة ErrorListener ودمجها مع StatusListener، التي يمكن تعريفها على النحو التالي:

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