Bu bölümde, sisteminizin minimum gereksinimleri karşıladığını nasıl doğrulayacağınız, Workspace Grubunuzu nasıl ayarlayacağınız ve Driver SDK'sını nasıl edineceğiniz açıklanmaktadır.
Başlamadan önce
iOS için Driver SDK'sı, uygulamanızın aşağıdaki ölçütleri karşılamasını gerektirir:
- Navigation SDK'ya sahip olun.
- 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 sürücü SDK'sının minimum gereksinimleri için sürüm notlarını kontrol edin. Sürüm notları başlıklı makaleyi inceleyin.
- Mobil cihazda iOS 14 veya daha yeni bir sürüm yüklü olmalıdır.
- Apple Xcode 15 sürümü veya sonraki sürümler.
Google Workspace'inize erişin
Google Workspace müşterisiyseniz aşağıdaki adımları uygulayın:
Workspace grubu oluşturun. Daha fazla bilgi için Çalışma Alanı Grubu başlıklı makaleyi inceleyin.
Örneğin, en iyi uygulama olarak ilk katılım sırasında grubunuza
google-maps-platform-sdk-users@workspacedomain.com
adını verin.Workspace Grubunuzu, doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklemek için Google'a ad verin.
Erişime ihtiyaç duyan kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listeye dahil edildiğinden emin olun.
Kuruluşunuz Workspace Grupları oluşturamıyorsa Google'a bu yapılara erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının bir listesini gönderin.
Cloud SDK ile oturum açma
Yerel geliştirme için Google Cloud SDK ile oturum açın. Ayrıntılı bilgi için gcloud KSA'yı yükleme başlıklı makaleyi inceleyin.
Aşağıdaki örneklerde Google Cloud SDK ile oturum açma gösterilmektedir.
gcloud
gcloud auth login
Workspace grubunun üyesi olan bir e-posta adresi kullanmanız gerekir.
Otomasyon ana makinelerinizi ayarlama
Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi, Google API'leri ve hizmetlerinde kimlik doğrulama amacıyla hizmet hesabı kullanmayla ilgili sağlanan yöntemler listesine göre kurun. Ayrıntılar için Google'daki Kimlik doğrulama yöntemleri sayfasındaki hizmet hesabı bölümüne bakın.
İşleminiz bir Google Cloud ortamında çalışıyorsa otomatik kimlik bilgisi algılama özelliğini kullanın. Daha fazla bilgi için otomatik kimlik bilgisi algılama bölümüne bakın.
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 ayrıntı için bkz. GOOGLE_APPLICATION_CREDENTIALS.
Kimlik bilgileriyle ilişkili hizmet hesabı e-postası, Workspace grubunun üyesi olmalıdır.
Sürücü SDK'sını edinin
Sürücü SDK'sını yükleyin ve yapılandırın.
CocoaPods
CocoaPods aracını yükleme: 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.
Sürücü SDK'sı için Podfile oluşturma: API'yi ve bağımlılıklarını yüklemek için Podfile'ı kullanırsınız.
Proje dizininizde
Podfile
adlı bir dosya oluşturun. Bu dosya, projenizin bağımlılarını tanımlar.Podfile'ı düzenleyin ve bağımlılıklarınızı ekleyin. Bağımlılıkları içeren bir örneği inceleyelim:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Aşağıda, sürücü SDK'sı için Alpha ve Beta kapsüllerini bağımlılık olarak 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
Podfile'ı kaydedin: Bir terminal açın ve Podfile'ı içeren klasöre gidin:
cd <path-to-project>
Kapsül yükleme komutunu çalıştırma: Bu komut, Pod dosyasında belirtilen API'leri ve sahip olabilecekleri tüm bağımlılıkları yükler.
pod install
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.
Swift Paket Yöneticisi
Sürücü SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Driver 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:
-
Xcode'unuzu
project
veyaworkspace
açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin. - URL olarak https://github.com/googlemaps/ios-driver-sdk 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 sürücü 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:GoogleRidesharingDriver.xcframework
Xcode projenizin üst düzey dizininden
GoogleRidesharingDriver
paketini kaldırın.
Manuel yükleme
Bu kılavuzda, sürücü 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:
Driver SDK'sını yüklemek için kullandığınız ikili program paketi XCFramework'ü indirin. Bu paketi Apple Silicon kullanan makineler dahil birden fazla platformda kullanabilirsiniz.
Navigasyon SDK'sını yükleyin.
Sürücü SDK'sını manuel olarak yüklemek için aşağıdaki adımları uygulayın:
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 mevcut bir dosyayı açın veya proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS App şablonunu seçin.
Proje grubunuzda bir Çerçeveler grubu yoksa oluşturun.
Sürücü SDK'sını yüklemek için
GoogleRidesharingDriver.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
GoogleRidesharingDriver.bundle
dosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstenirse Öğeleri kopyala'yı seçin.Project Navigator'dan 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
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
Belirli bir hedef yerine projenizi seçin ve Derleme Ayarları sekmesini açın. Diğer Bağlayıcı İşaretleri bölümünde hata ayıklama ve 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ı İnceleme
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 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.