iOS Tüketici SDK'sını edinme

Platform seçin: Android iOS JavaScript

iOS tüketici uygulamalarınızda isteğe bağlı yolculukları takip etmek için Tüketici SDK'sını kullanın. Seyahatleri takip etme hakkında daha fazla bilgi ve giriş için iOS'te bir seyahati 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 Consumer SDK'yı ayarlamak üzere aşağıdaki adımları uygulayın:

1. Minimum sistem gereksinimlerini kontrol edin.
2. Consumer SDK'yı edinme
3. Apple Gizlilik Manifesti dosyasını inceleyin.
4. Google Cloud Console projesi yapılandırın.
5. Kimlik doğrulama jetonları alma.
6. Consumer SDK'yı başlatın.

Minimum sistem gereksinimlerini kontrol edin

Kullandığınız Consumer SDK sürümü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. sürüm veya sonraki sürümler.

Tüketici SDK'sını edinme

Consumer SDK'yı CocoaPods ile yükleyip yapılandırmanız gerekir.

Swift Package Manager

Consumer SDK, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Consumer 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 önceki Xcode sürümlerinde de benzer şekilde uygulanabilir.

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 File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
2. URL olarak https://github.com/googlemaps/ios-consumer-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve "Add Package" (Paket Ekle) seçeneğini 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 bölümünü güncellemek için aşağıdaki adımları uygulayın:

1. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

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

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

1. Xcode proje yapılandırma ayarlarınızda Frameworks, Libraries, and Embedded Content'ı (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) 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çın ve aşağıdaki komutu çalıştırın:

   sudo gem install cocoapods
   

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

2. Consumer SDK için bir Podfile oluşturun: 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ılıklarını tanımlar.

   2. Podfile dosyasını düzenleyip bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örneği aşağıda görebilirsiniz:

      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'ın bulunduğu klasöre gidin:

      cd <path-to-project>
      

3. pod install komutunu çalıştırın: 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çın: 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ü olduğunda bunu tespit etmek için pod outdated komutunu düzenli olarak çalıştırın. Daha fazla bilgi için Consumer SDK sürüm notlarındaki Tüketici SDK Sürümleri bölümüne bakın.

Manuel yükleme

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

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

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

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

1. SDK ikilisini ve kaynaklarını indirin:

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

2. XCFramework'e 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'i yeni kullanmaya başladıysanız yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.

4. Proje grubunuzda Frameworks grubu yoksa bu grubu oluşturun.

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

6. Consumer SDK'yı yüklemek için GoogleRidesharingConsumer.xcframework dosyasını Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümündeki projenize sürükleyin. İstenirse Öğeleri kopyala'yı seçin.

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

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

9. Build Phases (Derleme Aşamaları) sekmesini açın ve Link Binary with Libraries (İkiliyi Kitaplıklarla Bağla) bölümünde aşağıdaki çerçeveleri ve kitaplıkları ekleyin (henüz eklenmemişse):

   • 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 Build Settings (Derleme Ayarları) sekmesini açın. Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümünde hem hata ayıklama hem de yayın için -ObjC ekleyin.

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

Apple Gizlilik Manifesti dosyasını inceleme

Apple, App Store'daki uygulamalar için uygulama gizliliği ayrıntıları ister. 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 dahil edilir. Gizlilik manifest dosyasının dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Sırada ne var?

Google Cloud Console projesi yapılandırma