iOS Tüketici SDK'sını edinme

Platform seçin: Android iOS JavaScript

iOS tüketici uygulamalarınızda isteğe bağlı gezileri takip etmek için tüketici SDK'sı. Daha fazla bilgi almak ve yolculuk paylaşımını kullanarak daha fazla iOS'te bir geziyi takip etme.

Örnekler için iOS örnek uygulamalarına göz atın veya birleşik örneklere göz atın.

iOS tüketici uygulamanız için Tüketici SDK'sını ayarlamak üzere aşağıdaki adımları uygulayın:

1. Minimum sistem gereksinimlerini kontrol edin.
2. Tüketici SDK'sını edinin.
3. Apple Gizlilik Manifest dosyasını inceleyin.
4. Bir Google Cloud Console projesi yapılandırın.
5. Kimlik doğrulama jetonları alın.
6. Tüketici SDK'sını başlatı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 tüketici 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.

Tüketici SDK'sını edinme

CocoaPods ile Tüketici SDK'sını yükleyip yapılandırırsınız.

Swift Paket Yöneticisi

Tüketici SDK'sı aracılığıyla yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için mevcut Tüketici SDK'sı 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-consumer-sdk adresini girip 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, GoogleRidesharingConsumer öğ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ü olan tüketici 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:

   • GoogleRidesharingConsumer.xcframework

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

CocoaPods'u kullanma

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

   sudo gem install cocoapods
   

   Daha ayrıntılı bilgi için CocoaPods Başlangıç kılavuzu.

2. Tüketici SDK'sı için Podfile oluşturma: API'yi ve bağımlılıklarını yüklemek için Podfile'ı kullanın.

   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. İşte bağımlılıkları içeren bir örnek:

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

   3. Podfile'ı kaydedin: Bir terminal açın ve şu klasöre gidin: yükleyin:

      cd <path-to-project>
      

3. Kapsül yükleme komutunu çalıştırma: 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ın ve ardından açın (çift tıklayın) Xcode'u başlatmak için projenizin .xcworkspace dosyasını yükleyin. Projeyi açmak için .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. Tüketici SDK'sı Sürüm notlarındaki Tüketici SDK'sı Sürümleri.

Manuel yükleme

Bu kılavuzda, Projenize tüketici SDK'sı ekleyin ve Xcode'da derleme ayarlarınızı yapılandırın.

Dikkat: En iyi uygulama olarak Cocoapod'ların her zaman Tüketici SDK'sını yüklemesine olanak tanır.

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

• "XCFramework" ikili programını indirin. Tüketici SDK'sı. Bu paketi, şunlar dahil birden fazla platformda kullanabilirsiniz: daha iyi performans gösterir.

• Şunu yükleyin: Haritalar SDK'sı.

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

5. İndirilen gRPCCertificates.bundle dosyasını üst düzeye sürükleyin Xcode projenizin dizinini oluşturur. İstenirse Öğeleri kopyala'yı seçin.

6. Tüketici SDK'sını yüklemek için GoogleRidesharingConsumer.xcframework dosyasını Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler. İstenirse, Öğeleri kopyalama.

7. İndirilen GoogleRidesharingConsumer.bundle dosyasını şuraya sürükleyin: üst düzey dizinini oluşturun. İstenirse, Öğeleri kopyalama.

8. Project Navigator'dan projenizi seçin ve hedefi belirleyebilirsiniz.

9. Derleme Aşamaları sekmesini açın ve İkili Program ile Kitaplıkları Bağla'da daha önce eklenmemişse aşağıdaki çerçeveleri ve kitaplıkları ekleyin şu anki:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesi. Diğer Bağlayıcı İşaretleri bölümünde Hata ayıklama ve sürüm için -ObjC ekleyin.

    Bu ayarlar görünmüyorsa filtreyi Derleme Ayarları çubuğunu Temel yerine Tümü olarak ayarlayın.

Apple Gizlilik Manifest dosyasını inceleyin

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