iOS Tüketici SDK'sını edinme

Platform seçin: Android iOS JavaScript

iOS tüketici uygulamalarınızda talep üzerine gezileri takip etmek için Tüketici SDK'sını kullanın. Gezileri takip etme hakkında daha fazla bilgi ve giriş için iOS'te gezi 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. Tüketici SDK'sını edinme
3. Apple gizlilik manifesti dosyasını inceleyin.
4. Google Cloud Console projesi yapılandırın.
5. Kimlik doğrulama jetonları alma
6. Tüketici SDK'sını başlatın.

Minimum sistem gereksinimlerini kontrol etme

Kullandığınız Tüketici SDK'sı sürümüyle ilgili minimum şartlar için sürüm notlarını inceleyin. Sürüm notları'na bakın.

• Mobil cihazda iOS 16 veya sonraki bir sürüm yüklü olmalıdır.
• Apple Xcode sürüm 26 veya sonraki sürümler.

Tüketici SDK'sını edinme

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

Swift Package Manager

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.

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 File > Add Package Dependencies (Dosya > Paket Bağımlılıkları Ekle) bölümüne gidin.
2. URL olarak https://github.com/googlemaps/ios-consumer-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) tıklayın.
3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüme dayalı seçeneklerden birine ayarlayın. Yeni projeler için en yeni 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ünleri Seçin penceresinde, GoogleRidesharingConsumer ürününün belirlediğiniz main hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
5. Yüklemenizi doğrulamak için hedefinizin Genel bölmesine gidin. Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın (Proje Gezgini) "Package Dependencies" (Paket Bağımlılıkları) bölümünü de görüntüleyebilirsiniz.

Mevcut bir projenin package bilgisini güncellemek için aşağıdaki adımları uygulayın:

1. Xcode'da File (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.
2. Yüklemenizi doğrulamak için Project Navigator'ın Package Dependencies 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 "File > Packages > Reset Package Cache" (Dosya > Paketler > Paket Önbelleğini Sıfırla) seçeneğini belirleyin.

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

1. Xcode projenizin yapılandırma ayarlarından Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünü 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 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ılavuzunu inceleyin.

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ılıklarını tanımlar.

   2. Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. 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 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 bağımlılıkları yükler.

   pod install
   

4. Projenizi Xcode'da açın: Xcode'u kapatın ve ardından projenizin .xcworkspace dosyasını açarak (çift tıklayarak) Xcode'u başlatı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 komutunu düzenli olarak çalıştırın. Daha fazla bilgi için Tüketici SDK'sı sürüm notları'ndaki Tüketici SDK'sı sürümleri bölümüne bakın.

Manuel yükleme

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

Bu kılavuzu uygulamadan önce aşağıdakileri yapın:

• Tüketici SDK'sını yüklemek için kullandığınız ikili paket olan XCFramework'ü 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'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'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.

4. Proje grubunuzda Frameworks 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ı Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünün altındaki projenize 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. Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.

9. Build Phases (Derleme Aşamaları) sekmesini açın ve Link Binary with Libraries (İkili Dosyayı Kitaplıklara Bağla) bölümünde, 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 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ınlama 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 manifest 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 Uygulama Mağazası Gizlilik Ayrıntıları sayfasını ziyaret edin.

Apple gizlilik manifest dosyası, SDK'nın kaynak paketine dahildir. Gizlilik Manifest Dosyası'nın dahil edildiğini doğrulamak ve içeriğini incelemek için uygulamanızın bir arşivini oluşturun ve arşivden gizlilik raporu oluşturun.

Sırada ne var?

Google Cloud Console projesi yapılandırma