iOS tüketici uygulamalarınızda isteğe bağlı seyahatleri 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.
iOS tüketici uygulamanız için Tüketici SDK'sını ayarlamak üzere aşağıdaki adımları uygulayın:
- Minimum sistem gereksinimlerini kontrol edin.
- Tüketici SDK'sını edinin.
- Apple Gizlilik Manifesti dosyasını inceleyin.
- Google Cloud Console projesi yapılandırın.
- Kimlik doğrulama jetonları alın.
- 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 sonraki 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
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:
-
Xcode'unuzu
project
veyaworkspace
açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin. - 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.
-
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 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:
- Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayın.
Manuel olarak yüklenen mevcut Tüketici SDK'sını kaldırmak için aşağıdaki adımları uygulayın:
Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini
(-)
kullanın:GoogleRidesharingConsumer.xcframework
Xcode projenizin üst düzey dizininden
GoogleRidesharingConsumer
paketini kaldırın.
CocoaPods'u kullanma
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'u kullanmaya başlama kılavuzuna bakın.
Tüketici SDK'sı için Pod dosyası oluşturma: API'yi ve bağımlılıkları yüklemek için Pod dosyasını kullanırsınız.
Proje dizininizde
Podfile
adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılarını tanımlar.Podfile dosyasını düzenleyip bağımlılıkları ekleyin. Bağımlılıkları içeren bir örnek aşağıda verilmiştir:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
Podfile'i kaydetme: Terminali açıp Podfile'in bulunduğu klasöre gidin:
cd <path-to-project>
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
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.
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.
Bu kılavuzu uygulamadan önce şunları yapın:
Tüketici SDK'sını yüklemek için kullandığınız ikili paket olan XCFramework'u indirin. Bu paketi, M1 yonga setini kullanan makineler de dahil olmak üzere birden fazla platformda kullanabilirsiniz.
Haritalar SDK'sını yükleyin.
SDK ikilisini ve kaynaklarını indirin:
XCFramework'a ve kaynaklara erişmek için sıkıştırılmış dosyaların sıkıştırmasını açın.
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.
Proje grubunuzda bir Çerçeveler grubu yoksa oluşturun.
İndirilen
gRPCCertificates.bundle
dosyasını Xcode projenizin üst düzey dizinine sürükleyin. İstenirse Öğeleri kopyala'yı seçin.Tüketici SDK'sını yüklemek için
GoogleRidesharingConsumer.xcframework
dosyasını Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümündeki projenize sürükleyin. İstenirse Öğeleri kopyala'yı seçin.İndirilen
GoogleRidesharingConsumer.bundle
dosyasını Xcode projenizin üst düzey dizinine sürükleyin. İstenirse Öğeleri kopyala'yı seçin.Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
Derleme Aşamaları sekmesini açın ve İkili Dosyayı Kitaplıklarla Bağla'ya, 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
Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlantı Oluşturucu İş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 gizliliği 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.