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:

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

Minimum sistem gereksinimlerini kontrol edin

Sürümüne ilişkin minimum gereksinimleri öğrenmek için sürüm notlarına bakın Kullandığınız sürücü SDK'sı. Sürüm notlarına bakın.

  • Mobil cihazda iOS 14 veya sonraki bir sürüm yüklü olmalıdır.
  • Apple Xcode sürüm 15 veya sonraki bir sürüme sahip olmanız gerekir.

Google Workspace'inize erişin

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

  1. Workspace grubu oluşturun. Daha fazla bilgi için Çalışma Alanı Grubu başlıklı makaleyi inceleyin.

    Örneğin, en iyi uygulama olarak grubunuza bir ad verin İlk katılım sırasında google-maps-platform-sdk-users@workspacedomain.com.

  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şim gerektiren kullanıcı e-postalarının ve hizmet hesabı e-postalarının, var.

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

Google Cloud SDK ile oturum açma

Yerel geliştirme için Google Cloud SDK ile oturum açın. Ayrıntılar için gcloud KSA'yı yükleme başlıklı makaleye göz atın.

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

gcloud

gcloud auth login

Workspace Grubu'nun üyesi olan bir e-posta adresi kullanmanız gerekir.

Otomasyon ana makinelerinizi ayarlayın

Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi kurun. Google API'leri ve hizmetleri Ayrıntılar için hizmet hesabı bölümüne göz atın. başlıklı makaleyi inceleyin.

  • İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılama. Daha fazla bilgi için otomatik kimlik bilgisi algılama başlıklı makaleye bakın.

  • Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sistemini açıp GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde kullanın. Daha fazla ayrıntı için bkz. GOOGLE_APPLICATION_CREDENTIALS.

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ükleme: Bir terminal penceresi açın ve aşağıdaki komutu çalıştırın komutuna ekleyin.

    sudo gem install cocoapods
    

    Daha ayrıntılı bilgi için CocoaPods Başlangıç kılavuzuna bakın.

  2. Sürücü SDK'sı için bir Podfile oluşturun: Yüklemek için Podfile ve bağımlılıklarını anlatacağım.

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

    2. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Burada, size ne kadar şu bağımlılıkları içerir:

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

      Bağımlılık olarak Driver SDK'sı:

      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ır: Bu komut, API'leri yükler ve bağımlılıkları ile birlikte Podfile dosyasında belirtilir.

    pod install
    
  4. Projenizi Xcode'da açma: Xcode'u kapatıp açın Xcode'u başlatmak için projenizin .xcworkspace dosyasını (çift tıklayın). Açmak için daha sonra .xcworkspace dosyasını kullanın.

Swift Paket Yöneticisi

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

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

  1. Xcode project veya workspace dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin.
  2. URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin ve Enter'a basın paketi çekin ve "Paket Ekle"yi tıklayın.
  3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  4. Paket Ürünlerini Seçin penceresinde, GoogleRidesharingDriver öğesinin şuraya ekleneceğini doğrulayın: belirlediğiniz main hedefidir. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Yüklenen paketleri Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünde görebilirsiniz. Paketi ve sürümünü doğrulamak için "Proje Gezgini"nin "Paket Bağımlılıkları" bölümünü de görüntüleyebilirsiniz.

Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

  1. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
  2. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .

Yüklü mevcut Driver SDK'sını kaldırmak için manuel olarak yüklemek istemiyorsanız aşağıdaki adımları uygulayın:

  1. Xcode proje yapılandırma ayarlarınızdan Frameworks, Kitaplıklar ve Yerleştirilmiş İçerikler. Kaldırmak için eksi işaretini(-) kullanın. şu çerçeveyi kullanabilirsiniz:

    • GoogleRidesharingDriver.xcframework
  2. Xcode projenizin üst düzey dizininden şunu kaldırın: GoogleRidesharingDriver paketi.

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.

Bu kılavuza başvurmadan önce aşağıdakileri yapın:

  • "XCFramework" ikili programını indirin. Sürücü SDK'sı. Bu paketi, şunlar dahil birden fazla platformda kullanabilirsiniz: Apple Silicon kullanan makineleri

  • 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 ikili programını ve kaynaklarını indirin:

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

  3. Xcode'u başlatın ve mevcut bir projeyi açın veya proje oluşturun. Eğer yenisini kullanıyorsanız yeni proje oluşturun ve iOS Uygulama şablonunu seçin.

  4. Proje grubunuzda Ç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ştirilmiş İçerikler. İstenirse, Öğeleri kopyalama.

  6. İndirilen GoogleRidesharingDriver.bundle öğesini üst düzeye sürükleyin Xcode projenizin dizinini oluşturur. İ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 Program ile Kitaplıkları Bağla bölümünde mevcut değilse aşağıdaki çerçeveleri ve kitaplıkları kullanın:

    • 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 Derlemeyi Ayarlar sekmesi. Diğer Bağlayıcı İşaretleri bölümünde şunun için -ObjC ekleyin: hata ayıklamak ve yayınlamaktır.

    Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel yerine Tümü olarak değiştirin.

Apple Gizlilik Manifest Dosyasını İnceleme

Apple, App Store'daki uygulamalar için uygulama gizlilik 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 Manifest dosyası, SDK'nın kaynak paketinde yer almaktadır. 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