Sürücü SDK'sını edinin

Bu bölümde, sisteminizin minimum koşulları karşıladığını nasıl doğrulayacağınız, Workspace grubunuzu nasıl oluşturacağınız ve Driver SDK'sını nasıl edineceğiniz açıklanmaktadır.

Başlamadan önce

iOS için Sürücü SDK'sının kullanılabilmesi için uygulamanızın aşağıdaki ölçütleri karşılaması gerekir:

• Navigation SDK'sına sahip olmanız gerekir.
• Google Cloud Console'da iOS için Haritalar SDK'sını etkinleştirin ve bir API anahtarı alın.

Minimum sistem gereksinimlerini kontrol edin

Kullandığınız Driver 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.

Google Workspace'inize erişme

Google Workspace müşterisiyseniz aşağıdaki adımları uygulayın:

1. Workspace grubu oluşturun. Daha fazla bilgi için Workspace grubu başlıklı makaleyi inceleyin.

   Örneğin, en iyi uygulama olarak ilk katılım sırasında grubunuza [e-mail] adını verin.

2. Google'a adı sağlayarak Workspace grubunuzu, doğru CocoaPods depolarına erişim veren bir izin verilenler listesine ekleyin.

3. Erişime ihtiyaç duyan kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listede yer aldığını onaylayın.

Kuruluşunuz Workspace grupları oluşturamıyorsa Google'a bu öğelere erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının listesini gönderin.

Not: Workspace Grupları, @googlegroups.com ile biten Google Grupları ile aynı değildir. Yalnızca Workspace Grupları desteklenir.

Cloud SDK ile oturum açma

Yerel geliştirme için Cloud SDK ile oturum açın. Ayrıntılar için gcloud CLI'yı yükleme başlıklı makaleyi inceleyin.

Aşağıdaki örneklerde, Cloud SDK ile nasıl oturum açılacağı gösterilmektedir.

gcloud

gcloud auth login

Workspace grubunun üyesi olan bir e-posta adresi kullanmanız gerekir.

Otomasyon barındırıcılarınızı ayarlama

Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi, Google API'leri ve hizmetlerinde kimlik doğrulaması yapmak üzere hizmet hesabı kullanmaya yönelik sağlanan yöntemler listesine göre ayarlayın. Ayrıntılar için Google'da kimlik doğrulama yöntemleri sayfasındaki hizmet hesabı bölümüne bakın.

• Süreciniz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılamayı kullanın. Daha fazla bilgi için Otomatik kimlik bilgisi algılama başlıklı makaleyi inceleyin.

• Aksi takdirde, hizmet hesabı anahtar dosyasını ana makinenin dosya sisteminde güvenli bir konumda saklayın ve GOOGLE_APPLICATION_CREDENTIALS ortam değişkenini uygun şekilde ayarlayın. Daha fazla bilgi için GOOGLE_APPLICATION_CREDENTIALS başlıklı makaleyi inceleyin.

Kimlik bilgilerine bağlı hizmet hesabı e-postası, Workspace grubunun üyesi olmalıdır.

Sürücü SDK'sını edinme

Sürücü SDK'sını yükleyip yapılandırın.

CocoaPods

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. Sürücü SDK'sı 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 bulabilirsiniz:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Aşağıda, bağımlılık olarak Driver SDK'nın alfa ve beta bölümlerini içeren bir örnek verilmiştir:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      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 iOS Sürümleri için Sürücü SDK'sı başlıklı makaleyi inceleyin.

Swift Package Manager

Sürücü SDK'sı, Swift Package Manager üzerinden yüklenebilir. SDK'yı eklemek için mevcut sürücü SDK'sı 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-driver-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 sürücü SDK'sını 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:

   • GoogleRidesharingDriver.xcframework

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

Manuel yükleme

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

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

• Sürücü SDK'sını yüklemek için kullandığınız ikili paket olan XCFramework'ü indirin. Bu paketi, Apple Silicon kullanan makineler de dahil olmak üzere birden fazla platformda kullanabilirsiniz.

• Navigation SDK'yı yükleyin.

Driver SDK'yı manuel olarak yüklemek için aşağıdaki adımları uygulayın:

1. SDK ikilisini ve kaynaklarını indirin:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.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 mevcut bir projeyi açın veya proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.

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

5. Sürücü SDK'sını yüklemek için GoogleRidesharingDriver.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.

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

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

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

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. 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 Manifest Dosyasını İnceleme

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