Bu bölümde, sisteminizin minimum gereksinimleri karşıladığını nasıl doğrulayacağınız, Workspace grubunuzu nasıl oluşturacağınız ve Sürücü SDK'sını nasıl edineceğiniz açıklanmaktadır.
Başlamadan önce
iOS için Sürücü SDK'sı, uygulamanızın aşağıdaki ölçütleri karşılamasını gerektirir:
- Navigation SDK'ya 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 etme
Kullandığınız Driver SDK sürümüyle ilgili minimum gereksinimler 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.
Google Workspace'inize erişme
Google Workspace müşterisiyseniz aşağıdaki adımları uygulayın:
Workspace grubu oluşturun. Daha fazla bilgi için Workspace Grubu başlıklı makaleyi inceleyin.
Örneğin, en iyi uygulama olarak, oryantasyon sırasında grubunuza
google-maps-platform-sdk-users@workspacedomain.comadını verin.Workspace grubunuzu doğru CocoaPods depolarına erişim izni veren bir izin verilenler listesine eklemek için adı Google'a gönderin.
Erişmesi gereken kullanıcı e-postalarının ve hizmet hesabı e-postalarının bu listeye dahil edildiğini onaylayın.
Kuruluşunuz Workspace grupları oluşturamıyorsa bu yapıtlara erişmesi gereken kullanıcı ve hizmet hesabı e-postalarının listesini Google'a gönderin.
Cloud SDK ile oturum açma
Yerel geliştirme için Cloud SDK ile oturum açın. Ayrıntılar için gcloud CLI'yi 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 ana makinelerinizi ayarlama
Derleme sistemleri veya sürekli entegrasyon için otomasyon ana makinelerinizi, Google API'leri ve hizmetlerinde kimlik doğrulaması yapmak üzere hizmet hesabı kullanmayla ilgili 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.
İş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 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 bilgileriyle ilişkili hizmet hesabı e-posta adresi, Workspace grubunun üyesi olmalıdır.
Sürücü SDK'sını edinme
Driver SDK'yı yükleyip yapılandırın.
CocoaPods
CocoaPods aracını yükleyin: Bir terminal penceresi açıp aşağıdaki komutu çalıştırın.
sudo gem install cocoapodsDaha fazla bilgi için CocoaPods Başlangıç kılavuzuna bakın.
Sürücü SDK'sı için Podfile oluşturun: API'yi ve bağımlılıklarını yüklemek için Podfile'ı kullanırsınız.
Proje dizininizde
Podfileadlı bir dosya oluşturun. Bu dosya, projenizin bağımlılıklarını tanımlar.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 'GoogleRidesharingDriver' endAşağıda, Driver SDK için alfa 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' endPodfile'ı kaydedin: Bir terminal açın ve Podfile'ın bulunduğu klasöre gidin:
cd <path-to-project>
pod install komutunu çalıştırın: Bu komut, Podfile'da belirtilen API'leri ve sahip olabilecekleri bağımlılıkları yükler.
pod installProjenizi 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.
Swift Package Manager
Driver SDK, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut Sürücü 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
projectveyaworkspacedosyanızı açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin. - URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) tıklayın.
-
Belirli bir
versionyü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. -
Paket Ürünleri Seçin penceresinde,
GoogleRidesharingDriverürününün belirlediğinizmainhedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın. - Yüklemenizi doğrulamak için hedefinizin General (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:
- Xcode'da File (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.
- 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.
Manuel olarak yüklenen mevcut Driver SDK'yı kaldırmak için aşağıdaki adımları uygulayın:
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:GoogleRidesharingDriver.xcframework
Xcode projenizin üst düzey dizininden
GoogleRidesharingDriverpaketini kaldırın.
Manuel yükleme
Bu kılavuzda, Sürücü 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.
Bu kılavuzdaki adımları uygulamadan önce şunları yapın:
Driver SDK'yı 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.
Sürücü SDK'sını manuel olarak yüklemek için aşağıdaki adımları uygulayın:
SDK ikili programını ve kaynaklarını indirme:
XCFramework'e ve kaynaklara erişmek için sıkıştırılmış dosyaları açın.
Xcode'u başlatın ve mevcut bir projeyi açın veya yeni bir proje oluşturun. iOS'te yeniyseniz yeni bir proje oluşturun ve iOS Uygulaması şablonunu seçin.
Proje grubunuzda Frameworks grubu yoksa oluşturun.
Sürücü SDK'sını yüklemek için
GoogleRidesharingDriver.xcframeworkdosyası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.İndirilen
GoogleRidesharingDriver.bundledosyasını Xcode projenizin en üst düzey dizinine sürükleyin. İstenirse Öğeleri kopyala'yı seçin.Proje Gezgini'nden projenizi ve uygulamanızın hedefini seçin.
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.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
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
-ObjCekleyin.Bu ayarlar görünmüyorsa Derleme Ayarları çubuğundaki filtreyi Temel'den Tümü'ne değiştirin.
Apple Gizlilik Manifest 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 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