iOS için Drive SDK'sını kullanmaya başlama

Sürücü SDK'sı, sürücü uygulamanıza entegre ettiğiniz bir kitaplıktır. Fleet Engine'i aracın konumu, rotası, kalan mesafe ve TVS bilgisiyle güncellemekten sorumludur. Ayrıca, sürücü için adım adım navigasyon talimatları sağlayan Navigasyon SDK'sı ile de entegre olur.

Minimum sistem gereksinimleri

  • Mobil cihazın iOS 14 veya sonraki bir sürümünü çalıştırıyor olması gerekir.
  • Xcode 15. sürüm veya sonraki sürümler.
  • Ön koşullar

    Bu kılavuzda, uygulamanızın gezinme SDK'sını zaten uyguladığı ve Fleet Engine arka ucunun ayarlanıp kullanılabilir olduğu varsayılmıştır. Ancak bu örnek kod, Gezinme SDK'sının nasıl ayarlanacağına dair bir örnek sunar.

    Ayrıca Google Cloud projenizde iOS için Haritalar SDK'sını etkinleştirmeniz ve bir API anahtarı almanız gerekir.

    Erişim elde edin

    Google Workspace müşterisiyseniz ilk katılım sırasında google-maps-platform-sdk-users@workspacedomain.com gibi bir Workspace Grubu oluşturun ve adı Google'a verin. Bu, önerilen yaklaşımdır. Ardından Workspace Grubunuz, doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklenir. Erişim gerektiren kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listede bulunduğundan emin olun.

    Kuruluşunuz Workspace Grupları oluşturamıyorsa bu yapılara erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının listesini Google'a gönderin.

    Yerel gelişim

    Yerel geliştirme için Cloud SDK ile giriş yapmanız yeterlidir.

    gcloud

    gcloud auth login
    

    Oturum açmak için kullanılan e-posta adresi Workspace Grubu'nun bir üyesi olmalıdır.

    Otomasyon (sistem derleme veya sürekli entegrasyon)

    Otomasyon ana makinelerinizi en iyi uygulamalara göre ayarlayın:

    • İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılamayı kullanın.

    • Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sistemindeki güvenli bir konumda depolayın ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde ayarlayın.

    Kimlik bilgileriyle ilişkili hizmet hesabı e-posta adresi, Workspace Grubu'nun bir üyesi olmalıdır.

    Proje yapılandırması

    iOS için Driver SDK'sını Cocoapods kullanarak veya manuel olarak yapılandırabilirsiniz.

    Cocoapods kullanma

    iOS için Sürücü SDK'sını yapılandırmak üzere aşağıdaki öğelere ihtiyacınız vardır:

    • CocoaPods aracı: Bu aracı yüklemek için Terminal'i açıp aşağıdaki komutu çalıştırın. shell sudo gem install cocoapods Daha fazla bilgi için CocoaPods Başlangıç kılavuzuna bakın.
    1. iOS için Driver SDK'sı için bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için bu dosyayı kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örneği aşağıda bulabilirsiniz:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    2. Podfile'ı kaydedin. Bir terminal penceresi açıp Podfile dosyasını içeren dizine gidin:

      cd <path-to-project>
      
    3. Kapsül yükleme komutunu çalıştırın. Bu işlem, Podfile'da belirtilen API'leri ve bu API'lerin sahip olabileceği tüm bağımlılıkları yükler.

      pod install
      
    4. Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu noktadan itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

    XCFramework'ü yükleme

    SDK ikili programını ve kaynaklarını indirin:

    XCFramework, Driver SDK'sını yüklemek için kullandığınız bir ikili program paketidir. Bu paketi, M1 yonga setini kullanan makineler de dahil olmak üzere birden çok platformda kullanabilirsiniz. Bu kılavuzda, Sürücü SDK'sını içeren XCFramework'ü projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir.

    1. XCFramework ve kaynaklara erişmek için sıkıştırılmış dosyaları açın.

    2. Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.

    3. Zaten proje grubunuz yoksa bir Çerçeveler grubu oluşturun.

    4. İndirilen gRPCCertificates.bundle dosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde, gerekirse Öğeleri kopyala'yı seçin.

    5. Sürücü SDK'sını yüklemek için GoogleRidesharingDriver.xcframework dosyasını projenizde Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümüne sürükleyin. İstendiğinde, gerekirse Öğeleri kopyala'yı seçin.

    6. İndirilen GoogleRidesharingDriver.bundle dosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstendiğinde Copy items if needed cihazını seçin.

    7. Project Navigator'dan projenizi seçin ve uygulamanızın hedefini belirleyin.

    8. Derleme Aşamaları sekmesini açın ve Kitaplıklarla İkili Program'ı Bağla'da, halihazırda mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları ekleyin:

      • Accelerate.framework
      • AudioToolbox.framework
      • AVFoundation.framework
      • CoreData.framework
      • CoreGraphics.framework
      • CoreLocation.framework
      • CoreTelephony.framework
      • CoreText.framework
      • GLKit.framework
      • ImageIO.framework
      • libc++.tbd
      • libxml2.tbd
      • libz.tbd
      • LocalAuthentication.framework
      • OpenGLES.framework
      • QuartzCore.framework
      • SystemConfiguration.framework
      • UIKit.framework
      • WebKit.framework
    9. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümünde hem hata ayıklama hem de sürüm için ‑ObjC ekleyin. Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.

    Alfa/Beta SDK sürümleri

    iOS için Driver SDK'sının Alfa veya Beta sürümlerini yapılandırmak için aşağıdaki öğelere ihtiyacınız vardır:

    • CocoaPods aracı: Bu aracı yüklemek için Terminal'i açıp aşağıdaki komutu çalıştırın.

      sudo gem install cocoapods
      

      Daha fazla bilgi için CocoaPods Başlangıç kılavuzuna bakın.

    • Google erişim listesindeki geliştirme hesabınız. SDK'nın Alfa ve Beta sürümlerinin kapsül deposu herkese açık kaynak değildir. Bu sürümlere erişmek için bir Google Müşteri Mühendisi ile iletişime geçin. Mühendis, geliştirme hesabınızı erişim listesine ekler ve ardından kimlik doğrulama için bir çerez ayarlar.

    Projeniz erişim listesinde olduktan sonra kapsüle erişebilirsiniz.

    1. iOS için Driver SDK'sı için bir Podfile oluşturun ve API'yi ve bağımlılıklarını yüklemek için bu dosyayı kullanın: Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya projenizin bağımlılıklarını tanımlar. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örneği aşağıda bulabilirsiniz:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    2. Podfile'ı kaydedin. Bir terminal penceresi açıp Podfile dosyasını içeren dizine gidin:

      cd <path-to-project>
      
    3. Kapsül yükleme komutunu çalıştırın. Bu komut, Podfile'da belirtilen API'leri ve sahip olabileceği tüm bağımlılıkları yükler.

      pod install
      
    4. Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Bu noktadan itibaren projeyi açmak için .xcworkspace dosyasını kullanmanız gerekir.

    Yetkilendirme ve kimlik doğrulamayı uygulama

    Sürücü uygulamanız güncellemeleri oluşturup Fleet Engine arka ucuna gönderdiğinde isteklerin geçerli erişim jetonları içermesi gerekir. Sürücü SDK'sı, bu istekleri yetkilendirmek ve doğrulamak için nesnenizi GMTDAuthorization protokolüne uygun şekilde çağırır. Nesne, gerekli erişim jetonunu sağlamaktan sorumludur.

    Uygulama geliştirici olarak jetonların nasıl oluşturulacağını siz seçersiniz. Uygulamanız aşağıdakileri yapma imkanı sağlamalıdır:

    • Bir HTTPS sunucusundan JSON biçiminde erişim jetonu alın.
    • Jetonu ayrıştırıp önbelleğe alın.
    • Jetonu süresi dolduğunda yenileyin.

    Fleet Engine sunucusu tarafından beklenen jetonlarla ilgili ayrıntılar için Yetkilendirme için JSON Web Jetonu (JWT) oluşturma bölümüne bakın.

    Sağlayıcı kimliği, Google Cloud proje kimliği ile aynıdır. Daha fazla bilgi için Fleet Engine Deliveries API Kullanıcı Kılavuzu'na bakın.

    Aşağıdaki örnekte bir erişim jetonu sağlayıcı uygulanmaktadır:

    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    // SampleAccessTokenProvider.h
    @interface SampleAccessTokenProvider : NSObject<GMTDAuthorization>
    @end
    
    static NSString *const PROVIDER_URL = @"INSERT_YOUR_TOKEN_PROVIDER_URL";
    
    // SampleAccessTokenProvider.m
    @implementation SampleAccessTokenProvider{
      // The cached vehicle token.
      NSString *_cachedVehicleToken;
      // Keep track of the vehicle ID the cached token is for.
      NSString *_lastKnownVehicleID;
      // Keep track of when tokens expire for caching.
      NSTimeInterval _tokenExpiration;
    }
    
    - (void)fetchTokenWithContext:(nullable GMTDAuthorizationContext *)authorizationContext
                       completion:(nonnull GMTDAuthTokenFetchCompletionHandler)completion {
      if (!completion) {
        NSAssert(NO, @"%s encountered an unexpected nil completion.", __PRETTY_FUNCTION__);
        return;
      }
    
      // Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
      NSString *vehicleID = authorizationContext.vehicleID;
      if (!vehicleID) {
        NSAssert(NO, @"Vehicle ID is missing from authorizationContext.");
        return;
      }
    
    // Clear cached vehicle token if vehicle ID has changed.
      if (![_lastKnownVehicleID isEqual:vehicleID]) {
        _tokenExpiration = 0.0;
        _cachedVehicleToken = nil;
      }
      _lastKnownVehicleID = vehicleID;
    
      // Clear cached vehicle token if it has expired.
      if ([[NSDate date] timeIntervalSince1970] > _tokenExpiration) {
        _cachedVehicleToken = nil;
      }
    
      // If appropriate, use the cached token.
      if (_cachedVehicleToken) {
        completion(_cachedVehicleToken, nil);
        return;
      }
      // Otherwise, try to fetch a new token from your server.
      NSURL *requestURL = [NSURL URLWithString:PROVIDER_URL];
      NSMutableURLRequest *request = 
                              [[NSMutableURLRequest alloc] initWithURL:requestURL];
      request.HTTPMethod = @"GET";
      // Replace the following key values with the appropriate keys based on your
      // server's expected response.
      NSString *vehicleTokenKey = @"VEHICLE_TOKEN_KEY";
      NSString *tokenExpirationKey = @"TOKEN_EXPIRATION";
      __weak typeof(self) weakSelf = self;
      void (^handler)(NSData *_Nullable data, NSURLResponse *_Nullable response,
                      NSError *_Nullable error) =
          ^(NSData *_Nullable data, NSURLResponse *_Nullable response, NSError *_Nullable error) {
            typeof(self) strongSelf = weakSelf;
            if (error) {
              completion(nil, error);
              return;
            }
    
            NSError *JSONError;
            NSMutableDictionary *JSONResponse =
                [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:&JSONError];
    
            if (JSONError) {
              completion(nil, JSONError);
              return;
            } else {
              // Sample code only. No validation logic.
              id expirationData = JSONResponse[tokenExpirationKey];
              if ([expirationData isKindOfClass:[NSNumber class]]) {
                NSTimeInterval expirationTime = ((NSNumber *)expirationData).doubleValue;
                strongSelf->_tokenExpiration = [[NSDate date] timeIntervalSince1970] + expirationTime;
              }
              strongSelf->_cachedVehicleToken = JSONResponse[vehicleTokenKey];
              completion(JSONResponse[vehicleTokenKey], nil);
            }
        };
    NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
    NSURLSession *mainQueueURLSession =  
           [NSURLSession  sessionWithConfiguration:config delegate:nil
    delegateQueue:[NSOperationQueue mainQueue]];
    NSURLSessionDataTask *task = [mainQueueURLSession dataTaskWithRequest:request completionHandler:handler];
    [task resume];
    }
    
    @end
    

    DeliveryDriverAPI örneği oluşturma

    GMTDDeliveryVehicleReporter örneği almak için önce providerID, vehicleID, driverContext ve accessTokenProvider kullanarak bir GMTDDeliveryDriverAPI örneği oluşturmanız gerekir. providerID, Google Cloud proje kimliği ile aynıdır. Ayrıca GMTDDeliveryVehicleReporter örneğine doğrudan sürücü API'sinden erişebilirsiniz.

    Aşağıdaki örnek bir GMTDDeliveryDriverAPI örneği oluşturur:

    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
     GMSMapView *_mapView;
    }
    
    - (void)viewDidLoad {
      NSString *vehicleID = @"INSERT_CREATED_VEHICLE_ID";
      SampleAccessTokenProvider *accessTokenProvider = 
                                    [[SampleAccessTokenProvider alloc] init];
      GMTDDriverContext *driverContext = 
         [[GMTDDriverContext alloc] initWithAccessTokenProvider:accessTokenProvider
                                                     providerID:PROVIDER_ID 
                                                  vehicleID:vehicleID 
          navigator:_mapView.navigator];
    
      GMTDDeliveryDriverAPI *deliveryDriverAPI = [[GMTDDeliveryDriverAPI alloc] initWithDriverContext:driverContext];
    }
    

    İsteğe bağlı olarak Vehicle Reporter etkinliklerini dinleme

    locationTrackingEnabled, EVET ise GMTDDeliveryVehicleReporter, aracı düzenli aralıklarla günceller. Bu periyodik güncellemelere yanıt vermek için herhangi bir nesne, GMTDVehicleReporterListener protokolüne uygun olarak GMTDDeliveryVehicleReporter etkinliklerine abone olabilir.

    Aşağıdaki etkinlikleri yönetebilirsiniz:

    • vehicleReporter:didSucceedVehicleUpdate

      Driver uygulamasına, arka uç hizmetlerinin araç konumu ve durum güncellemesini başarıyla aldığını bildirir.

    • vehicleReporter:didFailVehicleUpdate:withError

      Dinleyiciyi bir araç güncellemesinin başarısız olduğu konusunda bilgilendirir. Konum izleme etkin olduğu sürece GMTDDeliveryVehicleReporter, Fleet Engine arka ucuna en yeni verileri göndermeye devam eder.

    Aşağıdaki örnekte bu etkinlikler ele alınmaktadır:

    SampleViewController.h
    @interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
    @end
    
    SampleViewController.m
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
     GMSMapView *_mapView;
    }
    
    - (void)viewDidLoad {
      // ASSUMES YOU IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
      [ridesharingDriverAPI.vehicleReporter addListener:self];
    }
    
    - (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
      // Handle update succeeded.
    }
    
    - (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
      // Handle update failed.
    }
    
    @end
    

    Konum izlemeyi etkinleştirin

    Konum izlemeyi etkinleştirmek için uygulamanız GMTDDeliveryVehicleReporter üzerinde locationTrackingEnabled ayarını YES olarak yapabilir. Ardından GMTDDeliveryVehicleReporter, konum güncellemelerini otomatik olarak gönderir. GMSNavigator navigasyon modundayken (setDestinations aracılığıyla hedef ayarlandığında) ve locationTrackingEnabled YES olarak ayarlandığında GMTDDeliveryVehicleReporter, rotayı ve TVS güncellemelerini de otomatik olarak gönderir.

    Bu güncellemeler sırasında ayarlanan rota, sürücünün navigasyon oturumu sırasında izlediği rotayla aynıdır. Bu nedenle, filo izlemenin düzgün çalışması için -setDestinations:callback: ile ayarlanan ara nokta, Fleet Engine arka ucunda ayarlanan hedefle eşleşmelidir.

    Aşağıdaki örnek konum izlemeyi etkinleştirir:

    SampleViewController.m
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
     GMSMapView *_mapView; 
    }
    
    - (void)viewDidLoad {
      // ASSUMES YOU IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
      deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
    }
    
    @end
    

    Varsayılan olarak raporlama aralığı 10 saniyedir ancak raporlama aralığı locationUpdateInterval ile değiştirilebilir. Desteklenen minimum güncelleme aralığı 5 saniyedir. Desteklenen maksimum güncelleme aralığı 60 saniyedir. Daha sık güncelleme yapılması daha yavaş isteklere ve hatalara neden olabilir.

    Konum güncellemelerini devre dışı bırakın ve aracı çevrimdışı yapın

    Uygulamanız bir aracın konum güncellemelerini devre dışı bırakabilir. Örneğin, sürücü vardiyası sona erdiğinde uygulamanız locationTrackingEnabled öğesini NO olarak ayarlayabilir.

      _vehicleReporter.locationTrackingEnabled = NO