Sürücü SDK'sını edinin

Bu bölümde, sisteminizin minimum koşulları karşılayıp karşılamadığını nasıl doğrulayacağınız, Workspace grubunuzu nasıl oluşturacağınız ve Sürücü SDK'sını nasıl edineceğiniz açıklanmaktadır.

Başlamadan önce

iOS için Sürücü SDK'sı, uygulamanızın aşağıdaki ölçütleri karşılamasını gerektirir:

• Navigasyon SDK'sına sahip olun.
• Google Cloud Console'da iOS için Haritalar SDK'sını etkinleştirin ve bir API anahtarı alın.

Minimum sistem gereksinimlerini kontrol edin

Kullandığınız sürücü SDK'sının minimum gereksinimleri için sürüm notlarını kontrol edin. Sürüm notlarına bakın.

• Mobil cihazda iOS 14 veya sonraki bir sürüm yüklü olmalıdır.
• Apple Xcode 15 veya daha yeni bir sürüm.

Google Workspace'inize erişme

Google Workspace müşterisiyseniz aşağıdaki adımları uygulayın:

1. Workspace grubu oluşturun. Daha fazla bilgi için Workspace grubu başlıklı makaleyi inceleyin.

   Örneğin, en iyi uygulama olarak oryantasyon sırasında grubunuzu adlandırı[e-mail].

2. Workspace grubunuzu doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklemek için adı Google'a sağlayın.

3. Erişime ihtiyaç duyan kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listeye dahil edildiğinden emin olun.

Kuruluşunuzda Workspace grubu oluşturulamıyorsa Google'a bu yapıların erişimine ihtiyaç duyan kullanıcı ve hizmet hesabı e-postalarının listesini gönderin.

Not: Workspace grupları, @googlegroups.com ile biten Google Gruplar ile aynı değildir. Yalnızca Workspace grupları desteklenir.

Cloud SDK ile oturum açma

Yerel geliştirme için Cloud SDK ile oturum açın. Ayrıntılar için gcloud CLI'yi yükleme başlıklı makaleyi inceleyin.

Aşağıdaki örneklerde, Cloud SDK'sı ile nasıl oturum açılacağı gösterilmektedir.

gcloud

gcloud auth login

Workspace grubunun üyesi olan bir e-posta adresi kullanmanız gerekir.

Otomasyon barındırıcılarınızı ayarlama

Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi, Google API'leri ve hizmetlerinde kimlik doğrulama yapmak için hizmet hesabı kullanmaya yönelik yöntemler listesine göre ayarlayın. Ayrıntılar için Google'daki kimlik doğrulama yöntemleri sayfasındaki hizmet hesabı bölümüne bakın.

• İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılama özelliğini kullanın. Daha fazla bilgi için otomatik kimlik bilgisi algılama başlıklı makaleyi inceleyin.

• Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sisteminde güvenli bir konumda saklayın ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde ayarlayın. Daha fazla bilgi için GOOGLE_APPLICATION_CREDENTIALS başlıklı makaleyi inceleyin.

Kimlik bilgileriyle ilişkili hizmet hesabı e-postası, Workspace grubunun üyesi olmalıdır.

Sürücü SDK'sını edinme

Sürücü SDK'sını yükleyin ve yapılandırın.

CocoaPods

1. CocoaPods aracını yükleyin: Bir terminal penceresi açıp aşağıdaki komutu çalıştırın.

   sudo gem install cocoapods
   

   Daha fazla bilgi için CocoaPods'u kullanmaya başlama kılavuzuna bakın.

2. Sürücü SDK'sı için bir Pod dosyası oluşturun: API'yi ve bağımlılıkları yüklemek için Pod dosyasını kullanırsınız.

   1. Proje dizininizde Podfile adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılarını tanımlar.

   2. Podfile dosyasını düzenleyip bağımlılıkları ekleyin. Bağımlılıkları içeren bir örnek aşağıda verilmiştir:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Aşağıda, sürücü SDK'sı için Alpha ve Beta kapsüllerini bağımlılık olarak içeren bir örnek verilmiştir:

      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
      

   3. Podfile'i kaydetme: Terminali açıp Podfile'in bulunduğu klasöre gidin:

      cd <path-to-project>
      

3. Kapsül yükleme komutunu çalıştırma: Bu komut, Pod dosyasında belirtilen API'leri ve sahip olabilecekleri tüm bağımlılıkları yükler.

   pod install
   

4. Projenizi Xcode'da açma: Xcode'u kapatın ve ardından Xcode'u başlatmak için projenizin .xcworkspace dosyasını açın (çift tıklayın). Projeyi daha sonra açmak için .xcworkspace dosyasını kullanın.

   Not: SDK'nın daha yeni bir sürümü olup olmadığını tespit etmek için pod outdated'i düzenli olarak çalıştırın. Daha fazla bilgi için iOS sürümleri için sürücü SDK'sı başlıklı makaleyi inceleyin.

Swift Package Manager

Sürücü SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Driver SDK bağımlılıklarını kaldırdığınızdan emin olun.

Önemli: Bu talimatlarda Xcode 15 veya sonraki sürümlerin kullanıldığı varsayılmaktadır ancak Xcode'un önceki sürümleri için benzer olmalıdır.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

1. Xcode'unuzu project veya workspace açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin.
2. URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüme dayalı seçeneklerden birine ayarlayın. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayın.

Mevcut bir projenin package değerini güncellemek için aşağıdaki adımları uygulayın:

1. Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayın.

Önemli: Bazen yapı çözümlenemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı seçin.

Manuel olarak yüklenen mevcut sürücü SDK'sını kaldırmak için aşağıdaki adımları uygulayın:

1. Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

   • GoogleRidesharingDriver.xcframework

2. Xcode projenizin üst düzey dizininden GoogleRidesharingDriver paketini kaldırın.

Manuel yükleme

Bu kılavuzda, sürücü SDK'sını içeren XCFramework'i projenize manuel olarak nasıl ekleyeceğiniz ve Xcode'da derleme ayarlarınızı nasıl yapılandıracağınız gösterilmektedir.

Dikkat: En iyi uygulama olarak, mümkün olduğunda Sürücü SDK'sını yüklemek için Cocoapods'u kullanın.

Bu kılavuzu uygulamadan önce şunları yapın:

• Sürücü SDK'sını yüklemek için kullandığınız ikili paket olan XCFramework'u indirin. Bu paketi, Apple Silicon kullanan makineler dahil olmak üzere birden fazla platformda kullanabilirsiniz.

• Navigasyon SDK'sını yükleyin.

Sürücü SDK'sını manuel olarak yüklemek için aşağıdaki adımları uygulayın:

1. SDK ikilisini ve kaynaklarını indirin:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

4. Proje grubunuzda bir Çerçeveler grubu yoksa oluşturun.

5. Sürücü SDK'sını yüklemek için GoogleRidesharingDriver.xcframework dosyasını Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümündeki projenize sürükleyin. İstenirse Öğeleri kopyala'yı seçin.

6. İndirilen GoogleRidesharingDriver.bundle dosyasını Xcode projenizin üst düzey dizinine sürükleyin. İstenirse Öğeleri kopyala'yı seçin.

7. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.

8. Derleme Aşamaları sekmesini açın ve İkili Dosyayı Kitaplıklarla Bağla'ya, henüz 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ğlantı Oluşturucu İş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.

Apple Gizlilik Manifesti Dosyasını İnceleme

Apple, App Store'daki uygulamalar için uygulama gizliliği ayrıntılarını zorunlu kılar. Güncellemeler ve daha fazla bilgi için Apple App Store Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple Gizlilik Manifesti dosyası, SDK'nın kaynak paketine dahildir. Gizlilik manifesti dosyasının eklendiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden bir gizlilik raporu oluşturun.

Sırada ne var?

Google Cloud Console projesini yapılandırma