iOS Tüketici SDK'sını edinme

Swift Package Manager

Consumer SDK, Swift Package Manager üzerinden yüklenebilir. SDK'yı eklemek için mevcut Consumer SDK 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'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. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
4. Paket Ürünleri Seçin penceresinde, GoogleRidesharingConsumer öğesinin belirlenen 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 "Proje Gezgini"nin "Paket Bağımlılıkları" bölümünü de inceleyebilirsiniz.

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

1. Xcode'da File > Packages > Update To Latest Package Versions (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine gidin.
2. Yüklemenizi doğrulamak için Proje Gezgini'nin Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

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çıp 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ılarını tanımlar.

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

   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.

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.

Bu kılavuzu uygulamadan önce aşağıdakileri 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'yı 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 zip'li 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 bir 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. 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 en ü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 (Kitaplıklarla İkili Bağlantı) bölümünde, henüz eklenmemişse 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ı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.