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

يتطلّب إصدار حزمة تطوير البرامج (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.
  }
}