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

Bu bölümde, sisteminizin minimum gereksinimleri karşıladığını nasıl doğrulayacağınız açıklanmaktadır. Workspace Grubunuzu oluşturun ve Driver SDK'sını edinin.

Başlamadan önce

iOS için Driver 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ı başlıklı makaleyi inceleyin.

• Mobil cihazda iOS 14 veya daha yeni 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 [e-mail].

2. Workspace Grubunuzu aşağıdaki özelliklere sahip bir izin verilenler listesine eklemek için Google'a ad verin: doğru CocoaPods depolarına erişim izni verir.

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

Not: Workspace Grupları, @googlegroups.com. Yalnızca Workspace Grupları desteklenir.

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 Google Cloud SDK ile oturum açma 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-posta adresi, şu hizmetin üyesi olmalıdır: Workspace Grubu.

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 komutunu kullanın.

   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ılıkları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'ı kaydedin: Bir terminal penceresi açın ve Podfile:

      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.

   Not: Ne zaman yapıldığını algılamak için pod outdated uygulamasını düzenli olarak çalıştırın. SDK'nın daha yeni bir sürümü yüklü. Daha fazla bilgi için bkz. iOS Sürümleri için Sürücü SDK'sı.

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.

Önemli: Bu talimatlar Xcode 15 veya sonraki sürümlerin kullanıldığını varsayar ancak benzer olmalıdır. kullanı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ü ve "Tam Sürüm"ü kullanarak seçeneğini belirleyin. İş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. Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. "Paket Bağımlılıkları"nı da görüntüleyebilirsiniz “Project Navigator”ın bölümü .

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

1. 9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar: GoogleMapsBase, GoogleMapsCore ve Yükseltme işleminden sonra GoogleMapsM4B. Bağımlılığı kaldırmayın: GoogleMaps Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.

   Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

   • GoogleMapsBase (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
   • GoogleMapsCore (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
   • GoogleMapsM4B (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
2. Xcode'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
3. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .

Önemli: Bazen yapılar çözümlenemez veya hatalar oluşabilir. Bu örnekte, "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı tıklayın.

CocoaPods, aşağıdaki adımları uygulayın:

1. Xcode çalışma alanınızı kapatın. Terminali açın ve aşağıdaki komutu yürütün:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Podfile, Podfile.resolved ve CocoaPods dışında bir şey için kullanmıyorsanız Xcode workspace.

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, projenize sürücü SDK'sı ekleyin ve Xcode'da derleme ayarlarınızı yapılandırın.

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

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:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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 dosyayı 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. Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.

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 Derleme 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ğunda filtre değerini 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 Manifest Dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturup arşivden bir gizlilik raporu oluşturun.

Sırada ne var?

Google Cloud Console projesi yapılandırma