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ını kullanın. Gezileri takip etme hakkında daha fazla bilgi edinmek ve bu özelliğin tanıtımını görmek için iOS'te gezileri takip etme başlıklı makaleyi inceleyin.

Örnekler için iOS örnek uygulamalarına veya birleştirilmiş örneklere bakı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. Google Cloud Console projesi yapılandırın.
5. Kimlik doğrulama jetonları alın.
6. Consumer SDK'sını başlatın.

Minimum sistem gereksinimlerini kontrol edin

Kullandığınız Tüketici SDK'sının sürümü için minimum gereksinimlere ilişkin yayın notlarını kontrol edin. Sürüm notlarına bakın.

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

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ı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Tüketici SDK'sı bağımlılıklarını kaldırdığınızdan emin olun.

Önemli: Bu talimatlar Xcode 15 veya sonraki sürümlerin kullanıldığını varsayar, 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-consumer-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üm tabanlı 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üklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

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

Manuel olarak yüklenen mevcut Tüketici 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ştirilmiş İçerikler'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

   • GoogleRidesharingConsumer.xcframework

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

CocoaPods'u kullanma

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 Başlangıç kılavuzuna bakın.

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

   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. Bağımlılıkları içeren bir örneği inceleyelim:

      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 Podfile'ı içeren klasöre gidin:

      cd <path-to-project>
      

3. pod install komutunu çalıştırma: Bu komut, Podfile'da 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 Tüketici SDK'sı Sürümleri başlıklı Tüketici SDK'sı Sürüm Notları'na bakın.

Manuel yükleme

Bu kılavuzda, Tüketici 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 Tüketici SDK'sını yüklemek için Cocoapods'u kullanın.

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

• Tüketici SDK'sını yüklemek için kullandığınız ikili XCFramework paketini indirin. Bu paketi, M1 yonga setini kullanan makineler de dahil olmak üzere birden fazla platformda kullanabilirsiniz.

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

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 bir proje oluşturun ve iOS uygulaması şablonunu seçin.

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

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

6. Tüketici SDK'sını yüklemek için GoogleRidesharingConsumer.xcframework dosyasını projenizde Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümüne sürükleyin. İstenirse Öğeleri kopyala'yı seçin.

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

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

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

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

Apple Gizlilik Manifesti dosyasını inceleme

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